---
title: "Update Credentials"
method: PUT
path: "/api/v1/auth-management/clients/{client_id}"
tags: ["systemCredentials"]
---

# Update Credentials

`PUT /api/v1/auth-management/clients/{client_id}`

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_id` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateClientRequest — Update system-level credentials request model
  - `name` string, nullable — Display name for the system-level credentials
  - `roles` Role[], nullable — 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.
    - `role_id` string, required — Name of the role (e.g., 'admin', 'editor', 'viewer')
    - `resource` string, nullable — Optional resource type the role applies to (e.g., 'dataset')
    - `resource_instance` string, nullable — Optional resource instance ID the role applies to
  - `roles_context` string, nullable — Context for the roles to update. This can either be 'system' for system-level roles or 'dataset:{dataset_id}' for dataset-level roles.

## Response `200`

The updated system-level credentials details

- ClientResponse — System-level credentials
  - `client_id` string, required — OAuth client ID
  - `client_secret` string, required — OAuth client secret (only returned on creation)
  - `name` string, required — Display name for the OAuth client
  - `roles` Role[], required — List of roles assigned to the client
    - `role_id` string, required — Name of the role (e.g., 'admin', 'editor', 'viewer')
    - `resource` string, nullable — Optional resource type the role applies to (e.g., 'dataset')
    - `resource_instance` string, nullable — Optional resource instance ID the role applies to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)