List Namespaces
List all namespaces for a user
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Include read-only system namespaces (e.g. sample-data)
Response detail level. 'full' (default) returns complete namespace objects. 'summary' omits heavy per-namespace config (payload_indexes, feature_extractors, vector_inference_map, vector_configs) — ~93% smaller — for high-frequency list/switcher views. Fetch full config via GET /v1/namespaces/{namespace_identifier}.
full, summary 1 <= x <= 10001 <= x <= 10000 <= x <= 10000x >= 1Body
Request schema for listing namespaces.
Inherits body-level limit/page_size/offset/page (BACKE-2846) — body values win over query pagination via merge_body_pagination.
Page size. A body value wins over the limit query param.
1 <= x <= 1000Alias for limit (page size). If both are given, limit wins.
1 <= x <= 1000Number of results to skip (legacy, use cursor instead). A body value wins over the offset query param.
0 <= x <= 100001-indexed page number. Folds to offset = (page-1) * limit. If both page and offset are given, offset wins.
x >= 1Optional filters to apply to the namespace list. Supports filtering by namespace_id or namespace_name.
Optional sort criteria for the namespace list (single-column, legacy).
Sort criteria as a list of {field, direction} — the shape Studio datatables and the retriever list send. The first entry is the primary sort. Takes precedence over the singular sort.
Search term for wildcard search across namespace_id, namespace_name, description, and other text fields.
"ns_abc123"
If True, filters and search will be case-sensitive
Response
Successful Response
Response schema for listing namespaces.
List of namespaces matching the query
Pagination information for the current result window
Total number of namespaces that match the query
Aggregate statistics across all namespaces in the result

