Reset a key's counter

DELETE

/v1/namespaces/{ns}/keys/{key}

curl --request DELETE \
  --url https://example.com/v1/namespaces/example/keys/example \
  --header 'Authorization: Bearer <token>'

Authorizations

• api_key

Parameters

Path Parameters

ns

required

string

Namespace name

key

required

string

Limiter key to reset

Responses

204

Counter reset (idempotent)

400

Namespace/key empty

Media typeapplication/json

The JSON body returned for every error response: { "error": "<message>" }, optionally with a stable machine code ({ "error": ..., "code": ... }). The code lets clients map an error to their own localized copy instead of showing the English error string; it is present only for errors we’ve assigned a stable code, and omitted otherwise.

object

code

Stable machine-readable error code for client-side localization, when one is defined for this error (e.g. key_not_found, algorithm_not_on_plan).

string | null

error

required

Human-readable error message. Never contains internal/driver detail.

string

Example^generated

{
  "code": "example",
  "error": "example"
}

401

Missing or invalid API key

Media typeapplication/json

The JSON body returned for every error response: { "error": "<message>" }, optionally with a stable machine code ({ "error": ..., "code": ... }). The code lets clients map an error to their own localized copy instead of showing the English error string; it is present only for errors we’ve assigned a stable code, and omitted otherwise.

object

code

Stable machine-readable error code for client-side localization, when one is defined for this error (e.g. key_not_found, algorithm_not_on_plan).

string | null

error

required

Human-readable error message. Never contains internal/driver detail.

string

Example^generated

{
  "code": "example",
  "error": "example"
}

503

Service temporarily unavailable

Media typeapplication/json

The JSON body returned for every error response: { "error": "<message>" }, optionally with a stable machine code ({ "error": ..., "code": ... }). The code lets clients map an error to their own localized copy instead of showing the English error string; it is present only for errors we’ve assigned a stable code, and omitted otherwise.

object

code

Stable machine-readable error code for client-side localization, when one is defined for this error (e.g. key_not_found, algorithm_not_on_plan).

string | null

error

required

Human-readable error message. Never contains internal/driver detail.

string

Example^generated

{
  "code": "example",
  "error": "example"
}