StudioHomepage
ServicesCatalogHTTP APIState

Resolve namespace paths

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

Resolve a batch of namespace paths at one immutable commit. The response has one result for each path in the request. A request can have at most 1000 paths. 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 1 through 1000 absolute paths at one immutable commit, retaining request order and duplicate paths.

paths*array<array<>>

Response Body

Success

application/json
  1. response
commitId*catalog.CommitId

Immutable UUIDv7 project commit identity.

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