Skip to content
Patomic

Update name, rate limit, or expiry of an API key

PATCH
/v1/keys/{id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string
/^apk_[a-z0-9]{21}$/

Request Body required

Section titled “Request Body required ”
object
name
string
>= 1 characters <= 255 characters
rate_limit_rpm
integer
>= 1 <= 100000
expires_at
integer
nullable

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Updated key.

object
id
required
string
name
required
string
key_prefix
required
string
rate_limit_rpm
required
number
last_used_at
required
number
nullable
expires_at
required
number
nullable
created_at
required
number
revoked_at
required
number
nullable

400

Section titled “400 ”

Request body failed validation.

object
error
required
object
type
required
string
Allowed values: authentication_error rate_limit_error invalid_request_error idempotency_error not_found_error internal_error
code
required
string
Allowed values: unauthorized rate_limit_exceeded invalid_idempotency_key idempotency_key_conflict invalid_parameter not_found internal_error
message
required
string
param
required
string
nullable
docs_url
required
string format: uri
request_id
required
string
suggestion
required
string
nullable

401

Section titled “401 ”

Missing or invalid API key.

object
error
required
object
type
required
string
Allowed values: authentication_error rate_limit_error invalid_request_error idempotency_error not_found_error internal_error
code
required
string
Allowed values: unauthorized rate_limit_exceeded invalid_idempotency_key idempotency_key_conflict invalid_parameter not_found internal_error
message
required
string
param
required
string
nullable
docs_url
required
string format: uri
request_id
required
string
suggestion
required
string
nullable

404

Section titled “404 ”

Key not found or not owned by the authenticated user.

object
error
required
object
type
required
string
Allowed values: authentication_error rate_limit_error invalid_request_error idempotency_error not_found_error internal_error
code
required
string
Allowed values: unauthorized rate_limit_exceeded invalid_idempotency_key idempotency_key_conflict invalid_parameter not_found internal_error
message
required
string
param
required
string
nullable
docs_url
required
string format: uri
request_id
required
string
suggestion
required
string
nullable

429

Section titled “429 ”

Rate limit exceeded.

object
error
required
object
type
required
string
Allowed values: authentication_error rate_limit_error invalid_request_error idempotency_error not_found_error internal_error
code
required
string
Allowed values: unauthorized rate_limit_exceeded invalid_idempotency_key idempotency_key_conflict invalid_parameter not_found internal_error
message
required
string
param
required
string
nullable
docs_url
required
string format: uri
request_id
required
string
suggestion
required
string
nullable