API Reference

http://catalog-service.matih-data-plane.svc.cluster.local:8086/v1

GET /v1/catalog/browse?level={level}&dataSource={dataSourceId}

GET /v1/catalog/tables/{tableFqn}

{
  "fqn": "pg-analytics.analytics.public.orders",
  "name": "orders",
  "description": "Customer order transactions",
  "columns": [
    {"name": "order_id", "type": "BIGINT", "nullable": false, "primaryKey": true}
  ],
  "rowCount": 15234567,
  "sizeBytes": 3221225472,
  "owner": "data-engineering-team",
  "tags": ["transactional", "finance"],
  "qualityScore": 0.94,
  "lastUpdatedAt": "2026-02-12T08:00:00Z"
}

GET /v1/catalog/search?q={query}&type={entityType}&tags={tags}&limit={limit}

POST /v1/catalog/datasources

{
  "name": "analytics-postgres",
  "type": "POSTGRESQL",
  "connectionSecretRef": "analytics-postgres-credentials",
  "properties": {"sslMode": "require"}
}

GET /v1/catalog/datasources

POST /v1/catalog/datasources/{dataSourceId}/ingest

DELETE /v1/catalog/datasources/{dataSourceId}

POST /v1/lineage/events

GET /v1/lineage/graph?table={tableFqn}&depth={depth}&direction={direction}

GET /v1/lineage/columns?table={tableFqn}&column={columnName}

POST /v1/lineage/impact-analysis

{
  "tableFqn": "raw.orders",
  "changeType": "COLUMN_REMOVED",
  "columnName": "discount_code",
  "includeIndirect": true
}

POST /v1/catalog/classification/detect-pii

{
  "tableFqn": "analytics.public.customers",
  "sampleSize": 1000,
  "autoClassify": false
}

POST /v1/catalog/tags

{
  "entityType": "COLUMN",
  "entityFqn": "analytics.public.customers.email",
  "tags": ["PII", "PII:EMAIL"],
  "classification": "RESTRICTED"
}

GET /v1/catalog/tags?entityType={type}&entityFqn={fqn}

POST /v1/catalog/classification/run-rules

{
  "tableFqn": "analytics.public.customers",
  "autoApply": false
}

POST /v1/catalog/contracts

{
  "name": "Sales Data Contract",
  "dataset": "analytics.public.daily_sales",
  "producer": {"team": "data-engineering"},
  "consumer": {"team": "analytics"},
  "sla": {
    "freshness": {"maxDelayMinutes": 60},
    "quality": {"minScore": 0.95}
  }
}

GET /v1/catalog/contracts?dataset={tableFqn}&status={status}

GET /v1/catalog/contracts/{contractId}/status

POST /v1/catalog/glossary/terms

GET /v1/catalog/glossary/search?q={query}

GET /v1/catalog/glossary/terms/{termId}

POST /v1/catalog/polaris/grants
GET /v1/catalog/polaris/grants?namespace={namespace}
DELETE /v1/catalog/polaris/grants/{grantId}

POST /v1/catalog/sync/trigger
GET /v1/catalog/sync/status

http://governance-service.matih-data-plane.svc.cluster.local:8080/v1

POST /v1/governance/rls/evaluate

{
  "tenantId": "tenant-123",
  "userId": "user-456",
  "userRoles": ["analyst"],
  "userAttributes": {"region": "US-EAST"},
  "resourceFqn": "analytics.public.orders",
  "resourceType": "TABLE",
  "operation": "SELECT"
}

{
  "requiresFiltering": true,
  "whereClause": "region = 'US-EAST'",
  "appliedPolicies": [
    {"policyId": "region-restriction", "policyName": "Region Restriction"}
  ],
  "accessDenied": false
}

POST /v1/governance/policies

GET /v1/governance/policies?resource={resourceFqn}

POST /v1/governance/access/evaluate

GET /v1/governance/compliance/status?framework={framework}

POST /v1/governance/compliance/dsr

GET /v1/governance/compliance/retention?classification={classification}

GET /v1/governance/access-reviews?status=PENDING

POST /v1/governance/access-reviews/{reviewId}/decision

GET /v1/governance/audit?resource={resourceFqn}&startDate={date}&endDate={date}

http://data-quality-service.matih-data-plane.svc.cluster.local:8000/v1

POST /v1/quality/rules

{
  "name": "order_amount_positive",
  "tableFqn": "analytics.public.orders",
  "ruleType": "RANGE",
  "column": "amount",
  "config": {"min": 0.01},
  "severity": "CRITICAL",
  "schedule": "0 */6 * * *"
}

GET /v1/quality/rules?table={tableFqn}

POST /v1/quality/validations/run

{
  "tableFqn": "analytics.public.orders",
  "rules": ["rule-001", "rule-002"]
}

GET /v1/quality/validations?table={tableFqn}&startDate={date}

GET /v1/quality/scores?table={tableFqn}

GET /v1/quality/scores/history?table={tableFqn}&days={days}

GET /v1/quality/scores/trends?period=30d

GET /v1/quality/anomalies?table={tableFqn}&status=OPEN

POST /v1/quality/anomalies/{anomalyId}/acknowledge

POST /v1/quality/profiles/run

{
  "tableFqn": "analytics.public.orders",
  "sampleSize": 10000,
  "computeHistograms": true
}

GET /v1/quality/profiles?table={tableFqn}

GET /v1/quality/sla/dashboard

GET /v1/quality/sla/contracts/{contractId}