This API enables users to update API Client Credentials associated with a specific Tenant or Environment.
Notice
Accessing the Policy Management APIs is through a dedicated domain/URL according to your PlainID Tenant Location:`https://api.{REGION}.plainid.io`
United States (US) -
https://api.us1.plainid.io
Canada (US) -
https://api.ca1.plainid.io
Europe (US) -
https://api.eu1.plainid.io
Replace{REGION}
with your PlainID Tenant region (e.g. us1, eu1, ca1, etc.).
cURL Sample Guidelines
In order for the relevant parameters to appear in the cURL sample, you can input the values in the interactive API console on the right. They will then appear in the cURL sample on the bottom of the page in the correct format.
For more details about Administration API Authentication, check out the Authentication APIs documentation. Provide your bearer token in the Authorization header when making requests to protected resources. Example: Authorization: Bearer 123
Client ID to update.
{
"ownerId": "b0e1f961-2061-4f83-8392-b5aa19fed0c1",
"ownerType": "ENVIRONMENT",
"name": "Name7",
"description": "Name7 Description",
"tokenDuration": "PT1440M",
"permission": "ADMIN"
}
{
"ownerId": "b0e1f961-2061-4f83-8392-b5aa19fed0c1",
"ownerType": "ENVIRONMENT",
"name": "Name8",
"description": "Name8 Description",
"tokenDuration": "PT1440M",
"permission": "VIEWER"
}
{
"ownerId": null,
"ownerType": "TENANT",
"name": "Name9",
"description": "Name9 Description",
"tokenDuration": "PT1440M",
"permission": "ADMIN"
}
Client Name
Client Description
Client Token Duration
Client updated
Null value. Secret not included in the response for security reasons.
Client already exists
{
"id": "EW59XA",
"status": 400,
"name": "clientAlreadyExists",
"message": "client {name} already exists"
}
Forbidden
{
"id": "EW56XA",
"status": 403,
"name": "forbiddenEnvironment",
"message": "operation get for resource Environment {ownerId} is not allowed because the current user does not have the appropriate permissions"
}
{
"id": "EW57XA",
"status": 403,
"name": "forbiddenTenant",
"message": "operation get for resource Environment {ownerId} is not allowed because the current user does not have the appropriate permissions"
}
Client not found
{
"id": "EW58XA",
"status": 404,
"name": "clientNotFoundError",
"message": "Client {name} not found"
}