Update API key name

PATCHhttps://app.speybooks.com/api/v1/api-keys/{id}

Update the display name of an API key. Scopes are immutable — to change scopes, create a new key. Revoked keys cannot be updated.

Path parameters

idintegerrequired

API key ID.

Body parameters

namestringoptional

New display name for the key. Scopes are immutable; create a new key to change scopes.

max length: 100

Response

200API key name updated.

Show response fields

idinteger

updatedboolean

Error codes

400Invalid name or validation error.

404API key not found.

409Cannot update a revoked key.

RequestPATCH/v1/api-keys/{id}curl

curl -X PATCH https://api.speybooks.com/v1/api-keys/7 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Production v2"}'

Response200

{
  "success": true,
  "data": {
    "id": 7,
    "updated": true
  }
}