Documentation menu

Catalog API#

The catalog API exposes the tables this credential may query. It never reveals whether a hidden name exists in another organization.

List schemas#

GET/catalog

Returns visible schema resources. Names match the middle part of titan.<schema>.<table>.

List tables#

GET/catalog/{schema}

Returns tables and logical views in one schema. URL-encode the schema as one path segment.

Describe a table#

GET/catalog/{schema}/{table}

Returns the qualified name and ordered columns with data type and nullability. Use this response to build a query without scraping presentation labels.

json

{
  "object": "table",
  "schema": "stripe",
  "name": "charges",
  "qualified_name": "titan.stripe.charges",
  "columns": [
    { "name": "id", "type": "string", "nullable": false },
    { "name": "amount", "type": "integer", "nullable": true }
  ]
}

Missing and unauthorized names both return 404 catalog_not_found. Catalog reads require a data- or query-read scope accepted by the current API rollout.

The response reflects one catalog view at request time. If a source discovers a column after you fetch metadata, retrieve the table again before generating a strict projection.