POST /config/access/authorized_services/{id}

Updates an authorized service. Only the label, tenant_id, security_profile_id, user_role_id, and expiration_date fields can be updated.

To view any authorized service, the caller must have the Administrator Manager permission. Callers without the Administrator Manager permission can only see the authorized services that they've created. An authorized service can see itself and other authorized services it created, but the Administrator Manager permission is needed to see the complete list of authorized services.

Only the label, tenant_id, security_profile_id, user_role_id, and expiration_date fields can be set when creating an authorized service. All other fields are ignored.

Table 1. POST /config/access/authorized_services/{id} resource details
MIME Type

application/json

Table 2. POST /config/access/authorized_services/{id} request parameter details
Parameter Type Optionality Data Type MIME Type Description

id

path

Required

Number (Integer)

text/plain

null

fields

header

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. POST /config/access/authorized_services/{id} request body details
Parameter Data Type MIME Type Description Sample

authorized_service

Object

application/json

Only the label, tenant_id, security_profile_id, user_role_id, and expiration_date fields can be set when updating an authorized service. All other fields are ignored.

{ "created_by": "String", "creation_date": 42, "expiration_date": 42, "id": 42, "label": "String", "last_used_date": 42, "security_profile_id": 42, "tenant_id": 42, "token": "String", "user_role_id": 42 }

Table 4. POST /config/access/authorized_services/{id} response codes
HTTP Response Code Unique Code Description

201

Authorized Service updated.

403

95104011

Authorized services cannot update themselves.

404

95104001

The authorized service ID does not exist.

422

95104002

The authorized service security_profile_id provided must exist.

422

95104003

The authorized service user_role_id provided must exist.

422

95104004

The authorized service tenant_id provided must exist.

422

95104005

The tenant_id was provided, but the security_profile_id does not limit access to data in that tenant.

422

95104006

The authorized service label must be unique for all authorized services and users usernames.

422

95104007

If the authorized service is assigned the System Administrator or Security Administrator permission, it must also be assigned the Admin security profile.

422

95104008

The authorized service can't be assigned the System Administrator or Security Administrator permission, as well as a tenant.

422

95104009

The length of the label field cannot exceed 255 characters.

422

95104010

The expiration date must be between the creation date of the authorized service and the max expiration date from when the service was created.

422

95104013

Manage Local Only Authentication Setting permission required to perform action.

500

95104012

If there is an unexpected error that occurs.

Response Description

The updated authorized service structure.
  • label - String - The label of the authorized service. Authorized service labels and usernames must be unique between them.
  • tenant_id - Long - (Optional) the tenant ID of the authorized service. Access a list of tenants using /api/config/access/tenant_management/tenants. When set, this field will restrict the security_profile_id field to ones that are completely contained within the specified tenant.
  • security_profile_id - Long - The security profile ID of the authorized service. Access deployed security profiles using /api/config/security_profiles API.
  • user_role_id - Long - The user_role_id of the user. Access deployed user roles using /api/config/user_roles API.
  • expiration_date - Long - The time in milliseconds since epoch that this authorized service will expire. If this field is null, this authorized service does not expire. This field can be set to a time in the past, which will disable the authorized service.

Response Sample


{
    "created_by": "String",
    "creation_date": 42,
    "expiration_date": 42,
    "id": 42,
    "label": "String",
    "last_used_date": 42,
    "security_profile_id": 42,
    "tenant_id": 42,
    "token": "String",
    "user_role_id": 42
}