Skip to main content
PATCH
Replace personal scopes/grants or update key metadata
The signed-in owner must supply expected_grant_version. Widening scopes/projects, rebinding changed memberships, or extending expiration requires current-password confirmation. Narrowing access does not. A concurrent edit requires refreshing and reviewing the saved record; expired or revoked keys cannot be reactivated.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Body

application/json
expected_grant_version
integer
required

Optimistic concurrency token from the latest management record. Re-read after 409.

Required range: x >= 0
name
string
Required string length: 1 - 120
current_password
string

Required when widening grants/scopes, rebinding memberships or extending expiry. Never logged.

scopes
enum<string>[]

Explicit current MCP operation. All scopes is this saved list; future operations require an owner edit.

Available options:
resources.read,
diagnostics.read,
audiences.write,
topics.write,
campaigns.draft.write,
automations.draft.write,
automation_tests.write,
automation_runs.manage,
push_apps.write,
push.test.send,
events.ingest,
automations.trigger
grants
object[]
select_all_current_teams
boolean

Resolve the owner's current eligible projects at submission and save their IDs; future access is excluded.

expires_at
string<date-time> | null

Response

Successful response

data
object
required
status
integer
metadata
object
{key}