Skip to content

List the tenant's config entries

GET
/v1/tenant/config
curl --request GET \
--url 'https://example.com/v1/tenant/config?limit=25&kind=env' \
--header 'Authorization: Bearer <token>'

Cursor-paginated: the env entries (in the env binding order), then the secret entries (in the secrets binding order); a page holds at most limit entries and nextCursor resumes where it ended. Optional ?kind= narrows to one slot (env / config / secret); ?keyPrefix= matches on entry key. Secret values are ALWAYS redacted on this admin surface — the dispatch path is the only reader that receives raw material.

limit
integer
default: 25 >= 1 <= 100

1..100. Default 25.

cursor
string

Opaque cursor from a prior response. Absent → first page.

kind

Slot for a tenant config entry (tenant-scoped). env and config both address EnvBinding; secret addresses SecretBinding. Prefer /v1/env/* + /v1/secrets/* for new callers.

string
Allowed values: env config secret

Restrict to one slot: env, config, or secret.

keyPrefix
string

Prefix match on entry key.

Page of tenant-config entries.

Media typeapplication/json
object
data
required
Array<object>
object
tenantId
required
string
kind
required

Slot for a tenant config entry (tenant-scoped). env and config both address EnvBinding; secret addresses SecretBinding. Prefer /v1/env/* + /v1/secrets/* for new callers.

string
Allowed values: env config secret
key
required
string
value
required

Entry value. For kind: "secret" this is ALWAYS [redacted] on this admin surface; use the /v1/secrets/* routes and SecretBinding.resolve on the dispatch path to read plaintext.

string
sensitive
required
boolean
revision
required
integer
updatedAt
required
string
hasMore
required
boolean
nextCursor
string
Example
{
"data": [
{
"kind": "env"
}
]
}

Malformed query parameter.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": {},
"requestId": "example"
}
}

Missing / malformed / expired / revoked bearer token.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": {},
"requestId": "example"
}
}