LoginGet Started
Docs & GuidesAPI Reference
Docs & GuidesAPI Reference
  • Authentication
    • API Authentication
  • API Reference
LogoLogo
LoginGet Started
API ReferenceSystem Credentials

PUT
https://api.coactive.ai/api/v1/auth-management/clients/:client_id
PUT
/api/v1/auth-management/clients/:client_id
1curl -X PUT https://api.coactive.ai/api/v1/auth-management/clients/client_id \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "My OAuth Client",
6 "roles": [
7 {
8 "role_id": "admin"
9 }
10 ]
11}'
Try it
1{
2 "client_id": "client_123",
3 "client_secret": "secret_123",
4 "name": "My OAuth Client",
5 "roles": [
6 {
7 "role_id": "admin",
8 "resource": "resource",
9 "resource_instance": "resource_instance"
10 },
11 {
12 "role_id": "editor",
13 "resource": "dataset",
14 "resource_instance": "c1a7cb60-1731-4c0f-b966-165263c30896"
15 }
16 ]
17}
Was this page helpful?
Previous

Delete Credentials

Next
Built with
Update system-level credentials. This endpoint allows updating the name and roles of existing system-level credentials. The access of the system-level credentials is scoped to its roles. **If no roles are provided, the system-level credentials will have full access to all resources**. If the credentials was previously assigned roles and no roles are provided in the update request, the credentials will gain full access to all resources.
Update Credentials

Update system-level credentials.

This endpoint allows updating the name and roles of existing system-level credentials.

The access of the system-level credentials is scoped to its roles. If no roles are provided, the system-level credentials will have full access to all resources. If the credentials was previously assigned roles and no roles are provided in the update request, the credentials will gain full access to all resources.

Path parameters

client_idstringRequired

The client ID of the system-level credentials

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringOptional
Display name for the system-level credentials
roleslist of objectsOptional
List of roles to assign to the system-level credentials. This is only available to organizations that are RBAC-enabled. Please contact support if you would like to enable RBAC for your organization.
roles_contextstringOptional
Context for the roles to update. This can either be 'system' for system-level roles or 'dataset:{dataset_id}' for dataset-level roles.

Response

The updated system-level credentials details
client_idstring
OAuth client ID
client_secretstring

OAuth client secret (only returned on creation)

namestring
Display name for the OAuth client
roleslist of objects
List of roles assigned to the client

Errors

Context for the roles to update. This can either be ‘system’ for system-level roles or ‘dataset:{dataset_id}’ for dataset-level roles.

The updated system-level credentials details

Display name for the system-level credentials

List of roles to assign to the system-level credentials. This is only available to organizations that are RBAC-enabled. Please contact support if you would like to enable RBAC for your organization.