PATCH
/
api
/
v1
/
tokens
/
{id}
{
  "id": "<string>",
  "name": "<string>",
  "permissions": [
    {}
  ],
  "updated_at": "<string>"
}
Updates an existing token’s properties such as name or permissions. A user can only update tokens with permissions they themselves possess.
Requires User token authentication
Required permissions: update on token resource

​
Path Parameters

​
id
string
required
Token ID (UUID format)

​
Request Body

​
name
string
Updated token name
​
permissions
array
Updated permissions (cannot exceed user’s permissions)
​
expires_at
string
Updated expiration date

​
Example

curl -X PATCH "https://api.garnet.ai/v1/tokens/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated CI/CD Token",
    "expires_at": "2026-12-31T23:59:59Z"
  }'

​
Response

​
id
string
Token identifier
​
name
string
Updated token name
​
permissions
array
Token permissions
​
updated_at
string
Update timestamp