--- title: "List available domains (builtins + caller's custom domains)" method: GET path: "/v1/embeddings/band-schemas" tags: ["v1", "Band Schemas"] --- # List available domains (builtins + caller's custom domains) `GET /v1/embeddings/band-schemas` ## Request - Base URL: `https://memory.papr.ai` - URL: `https://memory.papr.ai/v1/embeddings/band-schemas` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer ## Response `200` Successful Response - GraphDomainList - `domains` GraphDomainSpec[], required - `domain_id` string, required - `name` string, required - `description` string, required - `signals` SignalField[], required - `name` string, required: Snake_case signal identifier. - `description` string, required: Human prompt used by extractor. - `weight` number: Relative weight in the fusion. - `frequency_hz` number, nullable: Hz band mapping (0.1 … 70.0). Auto-assigned if omitted. - `type` 'enum' | 'text' | 'numeric' | 'date' | 'boolean' | 'multi_value_text': Extraction / phase type for this signal. - `allowed_values` string[], nullable: For type='enum': allowed vocabulary. - `required` boolean: Warn when missing at extract time. - `signal_multipliers` object, nullable: Domain-level default signal multipliers (see GraphDomainCreate). - `routing_config` GraphDomainRoutingConfig: Domain-scoped CAESAR-VIII routing overrides (stored on graph_domains). - `disabled_rules` string[], nullable: Global SciFact routing rule names to skip for this domain (e.g. 'DANGER_LOW_RSG_LOW_PHI'). - `enabled_rule_packs` string[], nullable: Named domain rule packs to run after global rules (e.g. 'cosqa_caesar8_v2'). - `threshold_overrides` object, nullable: Optional CaesarConfig field overrides keyed by threshold name (e.g. {'cmas_c4_trust_jaccard_threshold': 0.95}). - `enhanced_initial_source` string, nullable: CAESAR-VIII initial source for the CE-on path. Domain defaults may pin 'caesar4_5_v4a' on code_search for public enhanced; public max overrides to 'caesar7' unless this field is set. - `holographic_floor` boolean, nullable: When true, never return a ranking worse than max(v4a, baseline) unless CE gate (ce_gate_min_phi) passes. - `ce_gate_min_phi` number, nullable: Minimum phi to allow caesar7/baseline_rerank to bypass holographic floor. - `egr_lambda_ce` number, nullable: Stacked EGR entailment fusion weight (0–1). Lower for code domains. - `caesar4_source` string, nullable: Which ranking is exposed as rankings['caesar4'] to CAESAR-VIII rules (c4_c7_diverge, etc.). Accepts 'v4a' (default — alias to family-routed v4a / v3a fallback), 'v3a' (force v3a only), or 'legacy' (SKIP the alias; keep the original Jaccard / trust-score selection at rankings['caesar4'] and stash a copy at rankings['_caesar4_legacy']). Use 'legacy' to A/B C-VIII rules against the original SciFact calibration semantics. Label-free in all modes. - `catalog_config` DomainCatalogConfig: Catalog settings on a domain. - `enabled` boolean: Whether to auto-accumulate signals on transform. - `refresh_every_n` integer: Run LLM clustering after this many buffered entries. - `catalog` DomainCatalog: Curated summary of what's in a domain's frequency space. - `entity_clusters` CatalogEntityCluster[] - `label` string, required: LLM-chosen canonical label for this cluster. - `members` string[]: Raw signal values merged into this cluster. - `count` integer: Total occurrences across all transforms. - `relationship_patterns` CatalogRelationshipPattern[] - `label` string, required: Canonical label (e.g. 'Causal', 'Preventive'). - `members` string[]: Raw relationship values in this cluster. - `count` integer: Total occurrences. - `domain_distribution` object: Signal band name -> total doc count. - `signal_value_counts` object: Per-band raw value counts, e.g. {'domain': {'Health': 500, 'Tech': 200}}. - `total_documents` integer: Total transforms processed. - `last_refreshed` string, nullable: ISO timestamp of last LLM clustering run. - `last_updated` string, nullable: ISO timestamp of last buffer append. - `catalog_buffer` CatalogBufferEntry[]: Buffered raw signals awaiting LLM clustering (internal). - `signals` object, required: Band name -> extracted value. - `timestamp` string, required: ISO timestamp of the transform call. - `builtin` boolean: True for built-in domains shipped with Papr (read-only). - `created_at` string, nullable - `owner_user_id` string, nullable - `owner_workspace_id` string, nullable: Workspace that owns this domain. Domains are scoped to workspace when set. - `owner_organization_id` string, nullable: Organization that owns this domain. - `owner_namespace_id` string, nullable: Namespace this domain belongs to, if any. - `band_schema_id` string, required: Canonical name for domain_id; both are serialized. - `band_schemas` GraphDomainSpec[], required: Canonical name for the collection; `domains` is the prior name. - `domain_id` string, required - `name` string, required - `description` string, required - `signals` SignalField[], required - `name` string, required: Snake_case signal identifier. - `description` string, required: Human prompt used by extractor. - `weight` number: Relative weight in the fusion. - `frequency_hz` number, nullable: Hz band mapping (0.1 … 70.0). Auto-assigned if omitted. - `type` 'enum' | 'text' | 'numeric' | 'date' | 'boolean' | 'multi_value_text': Extraction / phase type for this signal. - `allowed_values` string[], nullable: For type='enum': allowed vocabulary. - `required` boolean: Warn when missing at extract time. - `signal_multipliers` object, nullable: Domain-level default signal multipliers (see GraphDomainCreate). - `routing_config` GraphDomainRoutingConfig: Domain-scoped CAESAR-VIII routing overrides (stored on graph_domains). - `disabled_rules` string[], nullable: Global SciFact routing rule names to skip for this domain (e.g. 'DANGER_LOW_RSG_LOW_PHI'). - `enabled_rule_packs` string[], nullable: Named domain rule packs to run after global rules (e.g. 'cosqa_caesar8_v2'). - `threshold_overrides` object, nullable: Optional CaesarConfig field overrides keyed by threshold name (e.g. {'cmas_c4_trust_jaccard_threshold': 0.95}). - `enhanced_initial_source` string, nullable: CAESAR-VIII initial source for the CE-on path. Domain defaults may pin 'caesar4_5_v4a' on code_search for public enhanced; public max overrides to 'caesar7' unless this field is set. - `holographic_floor` boolean, nullable: When true, never return a ranking worse than max(v4a, baseline) unless CE gate (ce_gate_min_phi) passes. - `ce_gate_min_phi` number, nullable: Minimum phi to allow caesar7/baseline_rerank to bypass holographic floor. - `egr_lambda_ce` number, nullable: Stacked EGR entailment fusion weight (0–1). Lower for code domains. - `caesar4_source` string, nullable: Which ranking is exposed as rankings['caesar4'] to CAESAR-VIII rules (c4_c7_diverge, etc.). Accepts 'v4a' (default — alias to family-routed v4a / v3a fallback), 'v3a' (force v3a only), or 'legacy' (SKIP the alias; keep the original Jaccard / trust-score selection at rankings['caesar4'] and stash a copy at rankings['_caesar4_legacy']). Use 'legacy' to A/B C-VIII rules against the original SciFact calibration semantics. Label-free in all modes. - `catalog_config` DomainCatalogConfig: Catalog settings on a domain. - `enabled` boolean: Whether to auto-accumulate signals on transform. - `refresh_every_n` integer: Run LLM clustering after this many buffered entries. - `catalog` DomainCatalog: Curated summary of what's in a domain's frequency space. - `entity_clusters` CatalogEntityCluster[] - `label` string, required: LLM-chosen canonical label for this cluster. - `members` string[]: Raw signal values merged into this cluster. - `count` integer: Total occurrences across all transforms. - `relationship_patterns` CatalogRelationshipPattern[] - `label` string, required: Canonical label (e.g. 'Causal', 'Preventive'). - `members` string[]: Raw relationship values in this cluster. - `count` integer: Total occurrences. - `domain_distribution` object: Signal band name -> total doc count. - `signal_value_counts` object: Per-band raw value counts, e.g. {'domain': {'Health': 500, 'Tech': 200}}. - `total_documents` integer: Total transforms processed. - `last_refreshed` string, nullable: ISO timestamp of last LLM clustering run. - `last_updated` string, nullable: ISO timestamp of last buffer append. - `catalog_buffer` CatalogBufferEntry[]: Buffered raw signals awaiting LLM clustering (internal). - `signals` object, required: Band name -> extracted value. - `timestamp` string, required: ISO timestamp of the transform call. - `builtin` boolean: True for built-in domains shipped with Papr (read-only). - `created_at` string, nullable - `owner_user_id` string, nullable - `owner_workspace_id` string, nullable: Workspace that owns this domain. Domains are scoped to workspace when set. - `owner_organization_id` string, nullable: Organization that owns this domain. - `owner_namespace_id` string, nullable: Namespace this domain belongs to, if any. - `band_schema_id` string, required: Canonical name for domain_id; both are serialized. ## Changes - **2026-10-16** `0e7a5c0d125d`: 1 info - endpoint added [Operation history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/embeddings/band-schemas/get.md) --- [API](https://skmtc.dev/papr-ai/apis/papr-memory-api.md) - [All operations](https://skmtc.dev/papr-ai/apis/papr-memory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/papr-ai/apis/papr-memory-api/revisions/6fc381dc78b3?raw)