Skip to main content
PATCH
Update Mode

Update Mode

Updates an existing mode. Only provided fields will be updated.
Write access policy - This endpoint requires the write:tokens scope.
  • TEAM-owned workspace: owner, admin, editor can write; viewer is blocked (403).
  • Non-TEAM workspace: only the workspace owner can write.
  • If the workspace owner plan has no API write access (for example FREE), write is blocked.

Endpoint

Request

Path Parameters

Body Parameters

All body parameters are optional. Only provided fields will be updated.

Response

Status: 200 OK

Examples

Error Responses

400 Bad Request

404 Not Found

Default Mode Behavior

When setting is_default: true:
  • All other modes in this tokenset are set to is_default: false
  • Only one mode can be default per tokenset

Next Steps

Delete Mode

Permanently delete a mode

List Tokens

View mode tokens