Update an API key

Edits the name or role. The key stays the same.

PATCH/v1/workspaces/{workspaceId}/api-keys/{keyId}

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

curl --request PATCH \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspq7ws2np5l8z4/api-keys/keyE5f6G7h8I9" \
  --header "Authorization: Bearer $GRAPHON_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"name":"Local CLI","role":"editor"}'

Request

Loading your session…

Response

JSON

{
  "id": "apkE5f6G7h8I9",
  "workspaceId": "wspq7ws2np5l8z4",
  "name": "Local CLI",
  "maskedKey": "gak_GAK1a8Xk2mQ9pL0vT4cZ.••••",
  "ownerKind": "user",
  "ownerUserId": "usrB2c3D4e5F6",
  "createdByUserId": "usrB2c3D4e5F6",
  "role": "viewer",
  "createdAt": "2026-09-14T18:00:00.000Z",
  "lastUsedAt": null,
  "expiresAt": null,
  "revokedAt": null,
  "revision": 1
}

Path parameters

workspaceIdstring

The workspace id.

keyIdstring

The API key id.

Request body

namestring (optional)

Display name.

rolestring (optional)

New role. It cannot exceed the key owner's role or your role. One of: viewer, editor, admin.

Was this page helpful?

View as Markdown