Update API Key - Openinary Docs

Self-hosted only. Cloud keys are managed in the dashboard, not through the API. Patch a key by its ID to rename it, or to disable it without deleting it. Send only the fields you want to change.

curl -X PATCH http://localhost:3000/api-keys/key_abc123 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-v2"}'

PATCH /api-keys/{keyId}

Auth: API Key or Session · Content-Type: application/json Get keyId from List API Keys.

Parameters

Field	In	Type	Notes
`keyId`	path	string	Required. ID of the key to update
`name`	body	string	New display name
`enabled`	body	boolean	`false` disables the key, `true` re-enables it

Disable a key

curl -X PATCH http://localhost:3000/api-keys/key_abc123 \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Response

{
  "success": true,
  "key": {
    "id": "key_abc123",
    "name": "production-v2",
    "enabled": true
  },
  "message": "API key updated successfully"
}

Status codes: 200 success · 401 unauthorized · 403 forbidden · 404 not found · 500 error

List API Keys

Find the key ID.

Delete API Key

Permanently revoke a key.