Skip to main content

Schema Summary

Get aggregate structuring metrics for a schema across all runs including capture hit rate, synthesize rate, strategy distribution, and tier funnel.

Telemetry endpoints aggregate structuring metrics (capture hit rate, synthesize rate, strategy distribution, tier funnel) per schema or per run.

GET/v1/telemetry/schemas/{id}/summary

Response

Response fields

run_idstringUUID of the latest run used for this summary.
schema_idstringSchema UUID.
capture_hit_ratenumberFraction of cells filled via registry capture (0–1).
synthesize_ratenumberFraction of cells filled via LLM synthesis (0–1).
strategy_distributionobjectCount of cells filled per strategy (transfer, extract, compute, skip).
tier_funnelobjectCount of cells resolved per registry tier (tier1, tier2, tier3, unresolved).

Response

{
  "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "schema_id": "sch-uuid-1",
  "capture_hit_rate": 0.72,
  "synthesize_rate": 0.18,
  "strategy_distribution": {
    "transfer": 1240,
    "extract": 310,
    "compute": 88,
    "skip": 22
  },
  "tier_funnel": {
    "tier1": 840,
    "tier2": 400,
    "tier3": 200,
    "unresolved": 220
  }
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
404not_foundNo schema with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Schema Trend
Schema Fields