Skip to main content
GET
Retrieve the Semantic Layer root
Assigning a Semantic Layer permission needs the UUID of a catalog, folder, or document. Three read endpoints provide them, and an API key may call all three. Each list is already filtered to what your key’s creator can reach, so anything it returns is a resource you may name in an assignment.
These endpoints are read-only for API keys. Creating or editing Semantic Layer documents and folders through a machine credential returns 403; use the app or an MCP token for that.

Walk the tree, then grant

/api/v1/context-documents/ is a legacy alias of the documents endpoint, kept while internal clients migrate. It is not part of the published API — build against /api/v1/semantic-layer/documents/.

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Response

200 - application/json

The root. Has no name and no parent -- it exists to hold the root-level items.

id
string<uuid>
required
read-only