Update Api Key V1

Update a key’s name / scopes / rate limit / active flag. Cannot rotate the underlying secret — for that, delete and re-create…

PATCH /api/v1/keys/{key_id}

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/keys/{key_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "scopes": [
    "string"
  ],
  "rate_limit_per_minute": 8,
  "is_active": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "key_prefix": "string",
  "scopes": [
    "string"
  ],
  "rate_limit_per_minute": 8,
  "is_active": true,
  "last_used_at": "2026-08-31T14:22:05Z",
  "expires_at": "2026-08-31T14:22:05Z",
  "created_at": "2026-08-31T14:22:05Z",
  "is_current": false
}

Update a key’s name / scopes / rate limit / active flag.

Cannot rotate the underlying secret — for that, delete and re-create. A key cannot deactivate itself (would lock the caller out mid-request), so trying to set is_active=false on the calling key returns 409.

Path parameters

key_id · string (uuid) · required

Request body

UpdateAPIKeyRequest

name · string,null

scopes · string[],null

rate_limit_per_minute · integer,null

is_active · boolean,null

Response

APIKeySummary

id · string · required

name · string · required

key_prefix · string · required

First 12 chars of the key (e.g. ‘sk_ss_aBc12’).

scopes · string[] · required

rate_limit_per_minute · integer · required

is_active · boolean · required

last_used_at · string,null

expires_at · string,null

created_at · string · required

is_current · boolean

True for the key making this request (callers can self-identify).

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request PATCH \
  --url 'https://api.computer.stateset.app/api/v1/keys/{key_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Two-Person Tent",
  "scopes": [
    "string"
  ],
  "rate_limit_per_minute": 8,
  "is_active": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "key_prefix": "string",
  "scopes": [
    "string"
  ],
  "rate_limit_per_minute": 8,
  "is_active": true,
  "last_used_at": "2026-08-31T14:22:05Z",
  "expires_at": "2026-08-31T14:22:05Z",
  "created_at": "2026-08-31T14:22:05Z",
  "is_current": false
}