StudioHomepage
ServicesCatalogHTTP APIState

Resolve a namespace path

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

Find the resource that a namespace path refers to at one immutable commit. When no resource has the path, the response has no resource. You must have permission to read the project state.

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

Resolve one absolute path at the exact commit in the route. An absent binding returns no resource, while an unknown commit is an error.

path*array<>

Absolute path from the project root, or a relative path where explicitly stated. Empty selects the root. At most 64 segments.

Response Body

Success

application/json
  1. response
commitId*catalog.CommitId

Immutable UUIDv7 project commit identity.

Formatuuid
resource?|null
curl -X POST 'https://api.spiraldb.dev/api/catalog/projects/string/commits/497f6eca-6276-4993-bfeb-53cbbbba6f08/namespace/resolve' \  -H 'Content-Type: application/json' \  -d '{  "path": [    "string"  ]}'
{  "commitId": "a1b223ee-0195-4e35-9b2a-72c93f345117",  "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"  }}