Skip to main content
PATCH
/
api
/
admin
/
api-keys
/
{id}
Update API key
curl --request PATCH \
  --url https://{cluster_id}.on-hellgate.cloud/api/admin/api-keys/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "scopes": [
    "admin:api-keys:create",
    "admin:api-keys:update"
  ]
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2023-10-01T12:00:00Z",
  "masked_key_value": "key_123xxxx",
  "scopes": [
    "admin:api-keys:create",
    "admin:api-keys:update"
  ]
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string<uuid>
required

The unique identifier of the API key.

Body

application/json
​
scopes
enum<string>[]
required

A list of scopes that the API key will have access to.

Minimum array length: 1
Available options:
admin:api-keys:create,
admin:api-keys:read,
admin:api-keys:update,
admin:api-keys:delete,
admin:webhooks:create,
admin:webhooks:read,
admin:webhooks:delete,
pci:tokens:create,
pci:tokens:read,
pci:tokens:update,
pci:tokens:delete,
pci:tokens:forward,
network:tokens:create,
network:tokens:read,
network:tokens:delete,
network:tokens:use,
generic:tokens:create,
generic:tokens:read,
generic:tokens:delete,
admin:types:create,
admin:types:read,
admin:types:delete

Response

Success response

​
id
string
required
​
created_at
string<date-time>
required
​
masked_key_value
string
required
​
scopes
enum<string>[]
required

A list of scopes that the API key will have access to.

Minimum array length: 1
Available options:
admin:api-keys:create,
admin:api-keys:read,
admin:api-keys:update,
admin:api-keys:delete,
admin:webhooks:create,
admin:webhooks:read,
admin:webhooks:delete,
pci:tokens:create,
pci:tokens:read,
pci:tokens:update,
pci:tokens:delete,
pci:tokens:forward,
network:tokens:create,
network:tokens:read,
network:tokens:delete,
network:tokens:use,
generic:tokens:create,
generic:tokens:read,
generic:tokens:delete,
admin:types:create,
admin:types:read,
admin:types:delete
​
expires_at
string<date-time>