Authentication for the REST roles Service

Each call to the REST roles service must include an NLAuth authorization header. This header must identify a user and the user’s password. Additionally, if you need to retrieve data about Customer Center roles, the account ID must be included in the header. Otherwise, the account ID is optional.

Note the following:

• If your request includes a NetSuite account ID, the information returned is specific to that account. All roles are returned for the user, including the Customer Center roles, and any roles created based on the Customer Center role.

• If your request omits a NetSuite account ID, the system returns details for every NetSuite account to which the user identified in the header has access. All roles except Customer Center roles are included.

Note:

As of 2020.1, when you call the REST roles service on an account-specific domain, only the account specific information is returned. All roles are returned for the user, including the Customer Center roles, and any roles created based on the Customer Center role.

For examples, see Sample Responses from the roles Service.

For details on domain data returned by the roles service, see Domain Data Returned by the roles Service.

For information about constructing an NLAuth authorization header, see Using User Credentials for RESTlet Authentication.

Related Topics

• The REST Roles Service
• URLs for Accessing the REST roles Service
• Domain Data Returned by the roles Service
• Sample Responses from the roles Service
• Dynamic Discovery of URLs

General Notices