StudioHomepage
ServicesCatalogHTTP APIState

List namespace bindings

POST
/api/catalog/projects/{project_id}/commits/{commit_id}/namespace/list

List the bindings in a namespace scope at one immutable commit. Each page token keeps the scope and the commit of the first request. To read a newer commit, start a new listing. You must have permission to read the project state.

This operation returns results in pages. To get the next page, send the nextPageToken value of the response as pageToken in a new request with the same parameters. When the response has no nextPageToken, there are no more pages. A page can have an empty entries list before the last page.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Path Parameters

project_id*string

Owning project identifier. Nonempty, at most 128 UTF-8 bytes, with no control characters. Project creation belongs to the project service.

commit_id*string

Immutable UUIDv7 project commit identity.

Formatuuid

Request Body

application/json
  1. body

List concrete bindings within the selected resource anchor and implicit-prefix subtree at the exact commit. Traversal stops at concrete resource boundaries. A resource parent lists identity-anchored children. To inspect path-anchored children, use a prefix parent formed from the returned canonical parent and leaf name; aliases may have distinct path subtrees. hasChildren covers either domain. Entries are ordered lexicographically by relative path segments, then resource identity. Implicit prefixes are traversal structure rather than fabricated resource entries. Continuations preserve the parent and exact commit.

pageSize?|null
pageToken?|null
parent*||

Explicit namespace binding domain. Implicit prefixes do not allocate resources. Persistence encoding is an implementation detail.

Response Body

Success

application/json
  1. response
commitId*catalog.CommitId

Immutable UUIDv7 project commit identity.

Formatuuid
entries*array<>
nextPageToken?|null
curl -X POST 'https://api.spiraldb.dev/api/catalog/projects/string/commits/497f6eca-6276-4993-bfeb-53cbbbba6f08/namespace/list' \  -H 'Content-Type: application/json' \  -d '{  "parent": {    "prefix": {      "path": [        "string"      ]    },    "type": "prefix"  }}'
{  "commitId": "a1b223ee-0195-4e35-9b2a-72c93f345117",  "entries": [    {      "hasChildren": true,      "name": "string",      "parent": {        "prefix": {          "path": [            "string"          ],          "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6"        },        "type": "prefix"      },      "relativePath": [        "string"      ],      "resource": {        "descriptor": {          "kind": "string",          "namespaceManaged": true,          "namespaceRoot": "cfa7f0de-65e7-43ae-ae5e-e42145401b8a",          "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6",          "service": "string"        },        "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"      }    }  ],  "nextPageToken": "string"}