v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB

API Keys

Update API Key Scopes

Update scopes for an API key. Only org admins can update key scopes.

patch/api_keys/{api_key_id}

api_key_idstring required

Successful Response

created_atstring date-time nullable

When the key was created.

created_bystring required

member_id of the creator.

descriptionstring nullable

Optional description.

idstring required

The unique identifier of the API key.

key_prefixstring required

Display prefix (e.g., 'sk_tu_abc...').

last_used_atstring date-time nullable

When the key was last used.

namestring required

Human-readable name for the API key.

org_idstring required

WorkOS organization ID.

revoked_atstring date-time nullable

When the key was revoked (soft delete).

sharing_group_idsstring[]

Groups that receive default admin grants on resources created by this key.