Account

Change an API key's name, scope or sites

Changes only the fields you send. The secret can't be changed, and the change applies to the key's next request.

patch/api/v1/account/keys/{id}

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/account/keys/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The key's id, from listApiKeys or createApiKey.

Headers

X-Dotsy-Workspacestring

Org id or slug to act as for this request (session/MCP user actors only — ignored for pga_ keys). Validated against the caller's own memberships (id match first, then slug); 403 if not a member. Takes precedence over session.activeOrganizationId and the auto-provisioned home-workspace fallback.

Request body

labelstring nullable

A new name. Send null or an empty string to clear it.

scope'read' | 'write' | 'admin'

read can only GET. write can also change sites. admin can also manage API keys.

siteSlugsstring[]

Replace the site list. [] makes the key work on all sites. Each slug must be a site in this workspace.

Response

The key was updated.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.