List namespace rules

GET

/v1/namespaces/{ns}/rules

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

Authorizations

• api_key

Parameters

Path Parameters

ns

required

string

Namespace name

Responses

200

The namespace’s default rule

Media typeapplication/json

The default rule for a namespace. limit/window_ms are u64 on the wire but stored as int/bigint; values are range-checked before insert.

object

algorithm

required

string

limit

required

integer format: int64

name

string | null

namespace

required

string

window_ms

required

integer format: int64

Example

{
  "algorithm": "sliding_window"
}

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"
}

404

No rule for this namespace

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"
}