Catalog

List catalog concepts

get

/api/v1/workspaces/{wsId}/catalog/concepts

Returns ontology concepts for the workspace in catalog shape: id, name, description, schemaFieldName, schemaType, classification, fieldMappings (tableId, field), metadata, etc. Optional query param sourceId filters to concepts that have a field mapping for that source. Paginated (limit, default 200; cursor).

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Path parameters

wsIdstringRequired

Path parameter: wsId

Example: 123

Query parameters

sourceIdstringOptional

Restrict to concepts mapped to this source.

Example: 123

Responses

200

Successful response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

get/api/v1/workspaces/{wsId}/catalog/concepts

GET /api/v1/workspaces/{wsId}/catalog/concepts HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [],
  "pagination": {
    "cursor": "text",
    "hasMore": true,
    "total": 1
  }
}

Get catalog knowledge graph

get

/api/v1/workspaces/{wsId}/catalog/graph

Returns the ontology as a graph: nodes are concepts (id, name, schemaType, classification, suggestedRole); edges are anchor links (type "anchor") and temporal prerequisites (type "temporal_prerequisite"). Built from workspace concepts in platform MongoDB; no proxy.

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Path parameters

wsIdstringRequired

Path parameter: wsId

Example: 123

Responses

200

Successful response

application/json

dataany of · nullableRequired

Payload not declared in this repo

stringOptional

or

numberOptional

or

booleanOptional

or

or

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

get/api/v1/workspaces/{wsId}/catalog/graph

GET /api/v1/workspaces/{wsId}/catalog/graph HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": "text"
}

List catalog tables

get

/api/v1/workspaces/{wsId}/catalog/tables

Returns tabular sources in the workspace as catalog "tables": id, name, namespace (workspaceId), schema (field, type, subtype, description), documentCount, format, createdAt. Only dataFormat Tabular; virtual and folder-only are excluded. Paginated (limit, default 200; cursor). Used by semantic catalog and MCP.

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Path parameters

wsIdstringRequired

Path parameter: wsId

Example: 123

Responses

200

Successful response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

get/api/v1/workspaces/{wsId}/catalog/tables

GET /api/v1/workspaces/{wsId}/catalog/tables HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [],
  "pagination": {
    "cursor": "text",
    "hasMore": true,
    "total": 1
  }
}

List catalog views

get

/api/v1/workspaces/{wsId}/catalog/views

Returns datasets in the workspace as catalog "views": id, name, description, namespace, sources, operationCount, rowCount, timestamps. Read from platform MongoDB (integration views). Paginated (limit, default 200; cursor). Used by semantic catalog and MCP.

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Path parameters

wsIdstringRequired

Path parameter: wsId

Example: 123

Responses

200

Successful response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

get/api/v1/workspaces/{wsId}/catalog/views

GET /api/v1/workspaces/{wsId}/catalog/views HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [],
  "pagination": {
    "cursor": "text",
    "hasMore": true,
    "total": 1
  }
}