v51

latestOpenAPI 3.0.0GPL-3.0raw.githubusercontent.com2026-08-01199241439.9 KB

api-keys

Update API key

Updates API key info. Requires admin role.

patch/api-keys/{keyId}

Path parameters

keyIdstring required

unique identifier of the API key

Request body

namestring

New name

descriptionstring

New description

role'admin' | 'manager' | 'developer' | 'operator' | 'viewer'

User role determining access permissions. admin: full access including user management, manager: DAG CRUD and execution with audit log access, developer: DAG CRUD and execution, operator: DAG execution only, viewer: read-only

allowedSurfacesstring[]

Interfaces where this API key may be accepted

attributionClass'user_owned' | 'service_account'

Whether this key is owned by a user or represents a service account

ownerUserIdstring

Owner user ID when attributionClass is user_owned

serviceAccountNamestring

Service-account display name when attributionClass is service_account

Response

Updated API key