Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

PATCH/v1/auth/keys/{key_id}

Rename API Key

Change an API key's label. Label is the only mutable field.

Updates the label of an API key. The key hash, prefix, and scope are immutable — labels are purely human-readable and safe to change at any time.

Only operates on keys owned by the authenticated user. Returns 404 on any other key_id.

Request

bash

curl -X PATCH https://api.cueapi.ai/v1/auth/keys/6e8fc3a0-7a12-4f8a-b8b6-9c5e1d2a3b4c \
  -H "Authorization: Bearer cue_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "claude-desktop-work-laptop"}'

Response

json

{
  "id": "6e8fc3a0-7a12-4f8a-b8b6-9c5e1d2a3b4c",
  "label": "claude-desktop-work-laptop"
}

Request body

Field	Type	Required	Notes
`label`	string (1-100 chars)	yes	New human-readable name

Errors

Status	Code	Cause
404	`not_found`	`key_id` doesn't exist or doesn't belong to the authenticated user
422	`validation_error`	Empty or over-long `label`

Label changes are audit-logged — see the full history in api_key_audit_log with event_type="renamed".

PATCH/v1/auth/keys/{key_id}

Try it

Replace path parameters (e.g. {cue_id}) in the URL before sending.

Request Body

Enter your API key above to send requests

Previous← Create API Key NextRevoke API Key →