v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

API Tokens

Enable or disable an API token

Enables or disables an API token. Requires organization admin permissions.

put/api/v1/api-keys/{id}

Path parameters

idstring uuid required

Token UUID

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Token UUID

Request body

enabledboolean required

Set to false to disable the token, true to re-enable it.

Response

The updated API token

createdAtstring date-time required

ISO 8601 timestamp of when the token was created

enabledboolean required

Whether the token can currently authenticate. A disabled token cannot authenticate but remains visible until deleted.

idstring uuid required

Unique identifier for the token

membershipIdstring uuid nullable required

Membership ID of the user the token is scoped to. Null for organization-level tokens.

namestring required

Human-readable name for the token

type'organization' | 'personal' | 'mcp' required

Token type: organization (org-level), personal (user-created personal access token), or mcp (MCP OAuth grant).

Example response

{
  "createdAt": "2026-01-15T10:00:00.000Z",
  "enabled": true,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "membershipId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "name": "CI deployment key",
  "type": "organization"
}