{"openapi":"3.1.0","info":{"title":"OMNIA Open Measurement API","version":"0.28.0","summary":"Vendor-neutral energy, frequency, vibration, signal, sensor, and arbitrary-data ingress.","description":"OMNIA accepts calibrated physical observations, digital signal features, explicit inferences, and named interpretive mappings without conflating their evidence classes. Every integration retains device, calibration, timing, uncertainty, consent, provenance, and lineage metadata."},"servers":[{"url":"/","description":"Current OMNIA deployment"}],"tags":[{"name":"OMNIA Product"},{"name":"Discovery"},{"name":"Devices"},{"name":"Measurements"},{"name":"Sources"},{"name":"Connectors"},{"name":"Intelligence"},{"name":"Synchronization"},{"name":"Interoperability"},{"name":"System"},{"name":"Performance"},{"name":"Trust"},{"name":"Data Rights"},{"name":"Workers"},{"name":"Agents"},{"name":"JWLS"},{"name":"Agent Platform","description":"Your account's agents: build, run, schedule, trigger, rate and evaluate them. Authenticate with your account key (Bearer omk_...)."}],"paths":{"/v1/services/product/resource-research":{"post":{"tags":["OMNIA Product"],"operationId":"startResearchSearch","description":"Search four free catalogs concurrently with consent. Returns an account-scoped search ID; poll GET for progressive results. Sources fail independently. Completed previews can be reviewed and saved with resource-import. No paid calls, model use or underlying file downloads.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query","consent"],"properties":{"query":{"type":"string","minLength":2,"maxLength":200},"consent":{"const":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"get":{"tags":["OMNIA Product"],"operationId":"getResearchSearch","description":"Read progressive results, source failures and a final saveable preview. Metadata conflicts and computed relevance remain separate from reliability.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/v1/services/product/resource-collections":{"get":{"tags":["OMNIA Product"],"operationId":"listResearchCollections","description":"List named private source selections and saved queries.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["OMNIA Product"],"operationId":"useResearchCollection","description":"Open a saved snapshot without a provider call, rename with revision checking, or explicitly refresh its bounded saved query. Refresh returns a review preview; it never changes the saved selection until resource-import is approved.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action","id"],"properties":{"action":{"enum":["open","refresh","rename"]},"id":{"type":"string","format":"uuid"},"consent":{"const":true},"name":{"type":"string","minLength":1,"maxLength":120},"expectedRevision":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/resource-connections":{"get":{"tags":["OMNIA Product"],"operationId":"getDataConnections","description":"Account-scoped setup and successful-search timestamps. No keys are returned and no external request is made.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["OMNIA Product"],"operationId":"configureDataConnection","description":"Save or remove a provider key in the encrypted account vault. Saving does not test the key or enable paid calls. Use the private browser form, not chat, for secrets.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["provider","action"],"properties":{"provider":{"enum":["usda","fred","brave","firecrawl","deepgram","places","openmeteo"]},"action":{"enum":["save","remove"]},"key":{"type":"string","writeOnly":true,"minLength":8,"maxLength":512},"consent":{"const":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/resource-catalog":{"get":{"tags":["OMNIA Product"],"operationId":"getFreeDataCatalog","description":"List the bounded no-key public connectors and optional free-account sources. Does not perform a paid call.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/resource-search":{"post":{"tags":["OMNIA Product"],"operationId":"searchFreePublicData","description":"Send only the supplied search parameters to an allowlisted public source after user consent. Returns at most 20 catalog entries or 100 reported observations. Catalog entries do not include underlying files. Preview expires after 20 minutes.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["provider","consent"],"properties":{"provider":{"enum":["datacite","huggingface","crossref","worldbank","openalex","usda","fred"]},"query":{"type":"string","minLength":2,"maxLength":200},"countries":{"type":"string","description":"One to five three-letter codes, e.g. USA,ISR"},"indicator":{"enum":["AG.YLD.CREL.KG","SP.POP.TOTL","NY.GDP.MKTP.CD","NY.GDP.PCAP.CD","EG.ELC.ACCS.ZS","AG.LND.AGRI.ZS"]},"startYear":{"type":"integer","minimum":1850},"endYear":{"type":"integer","minimum":1850},"series":{"type":"string","maxLength":80},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"asOf":{"type":"string","format":"date"},"commodity":{"type":"string","maxLength":80},"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"statistic":{"enum":["YIELD","PRODUCTION","AREA HARVESTED","AREA PLANTED"]},"consent":{"const":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/resource-import":{"post":{"tags":["OMNIA Product"],"operationId":"saveFreePublicData","description":"Save selected server-held preview records to this account’s searchable dataset. Repeated identical records deduplicate. Returns a JSON analysis input, with source identity and rights retained; not a training label or verified claim.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["previewId","indices","consent"],"properties":{"collectionName":{"type":"string","minLength":1,"maxLength":120},"previewId":{"type":"string","format":"uuid"},"indices":{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"items":{"type":"integer","minimum":0,"maximum":99}},"consent":{"const":true}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/resource-saved":{"get":{"tags":["OMNIA Product"],"operationId":"searchSavedPublicData","description":"Search account-owned external records inside OMNIA without contacting an external provider.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":500}},{"name":"cursor","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000}}]}},"/v1/services/product/resource-open":{"post":{"tags":["OMNIA Product"],"operationId":"openSavedPublicData","description":"Open account-owned external records, verifying archived payloads if necessary. Returns a bounded JSON input for a separate consented analysis. Does not run an analysis or contact the source.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"items":{"type":"string","maxLength":100}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/capabilities":{"get":{"tags":["OMNIA Product"],"operationId":"getOmniaProductCapabilities","description":"Supported adapters, processing limits and extraction availability.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/runs":{"get":{"tags":["OMNIA Product"],"operationId":"listOmniaProductRuns","description":"List up to 30 recent private outputs for this account.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["OMNIA Product"],"operationId":"runOmniaProduct","description":"Analyze inputs, fission evidence and fuse selected tables. Consent must be explicit. Public URLs are fetched only when supplied as sources.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["consent","sources"],"properties":{"consent":{"const":true},"question":{"type":"string","maxLength":2000},"sources":{"type":"array","minItems":1,"maxItems":8,"items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":240},"mediaType":{"type":"string"},"text":{"type":"string","maxLength":200000},"base64":{"type":"string","contentEncoding":"base64"},"url":{"type":"string","format":"uri","pattern":"^https://"},"units":{"type":"object","additionalProperties":{"type":"string","maxLength":80}}},"oneOf":[{"required":["text"]},{"required":["base64"]},{"required":["url"]}]}},"joins":{"type":"array","maxItems":3,"items":{"type":"object","required":["sourceName","leftKey","rightKey"],"properties":{"sourceName":{"type":"string"},"leftKey":{"type":"string"},"rightKey":{"type":"string"}}}},"derived":{"type":"array","maxItems":10,"items":{"type":"object","required":["name","left","right","operation"],"properties":{"name":{"type":"string"},"left":{"type":"string"},"right":{"type":"string"},"operation":{"enum":["sum","difference","product","ratio"]}}}}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":128},"description":"Optional retry key retained for 24 hours, bounded to the latest 100 successful keyed runs per account. Reusing a key with different input returns 409."}]}},"/v1/services/product/runs/{id}":{"get":{"tags":["OMNIA Product"],"operationId":"getOmniaProductRun","description":"Retrieve a private output with its measurements and source lineage.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/v1/services/product/runs/{id}/export":{"get":{"tags":["OMNIA Product"],"operationId":"exportOmniaProductRun","description":"Export an authorized JSON bundle, CSV table or readable Markdown report.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Output file","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"No table or unsupported format"},"404":{"description":"Run not found"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"query","schema":{"enum":["json","csv","report"],"default":"json"}}]}},"/v1/services/product/actions":{"get":{"tags":["OMNIA Product"],"operationId":"listOmniaProductActions","description":"List private follow-up records, optionally for one run.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"runId","in":"query","schema":{"type":"string","format":"uuid"}}]},"post":{"tags":["OMNIA Product"],"operationId":"createOmniaProductAction","description":"Create a private action linked to source evidence. This does not execute an external action.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["runId","title","sourceIds"],"properties":{"runId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":240},"note":{"type":"string","maxLength":4000},"sourceIds":{"type":"array","minItems":1,"maxItems":8,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/notion":{"get":{"tags":["OMNIA Product"],"operationId":"getOmniaNotionConnection","description":"Read this account’s Notion connection status; never returns a token.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"post":{"tags":["OMNIA Product"],"operationId":"connectOmniaNotion","description":"Validate and encrypt an account-owned Notion integration token.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","dataSourceId","consent"],"properties":{"token":{"type":"string","writeOnly":true},"dataSourceId":{"type":"string","format":"uuid"},"consent":{"const":true},"statusProperty":{"type":"string"},"statusValue":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}},"delete":{"tags":["OMNIA Product"],"operationId":"disconnectOmniaNotion","description":"Remove the stored Notion connection.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/actions/{id}/execute":{"post":{"tags":["OMNIA Product"],"operationId":"executeOmniaNotionAction","description":"Create a Notion task with explicit consent. Duplicate requests reuse the receipt. Uncertain delivery blocks retry.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["consent","expectedRevision"],"properties":{"consent":{"const":true},"expectedRevision":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/v1/services/product/actions/{id}":{"patch":{"tags":["OMNIA Product"],"operationId":"updateOmniaProductAction","description":"Update action status with optimistic revision checking.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedRevision","status"],"properties":{"expectedRevision":{"type":"integer","minimum":1},"status":{"enum":["open","in-progress","completed","cancelled"]}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/v1/services/product/shares":{"get":{"tags":["OMNIA Product"],"operationId":"listOmniaProductShares","description":"List this account’s share metadata. Secret link tokens are never returned again.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"runId","in":"query","schema":{"type":"string","format":"uuid"}}]},"post":{"tags":["OMNIA Product"],"operationId":"createOmniaProductShare","description":"Create an expiring bearer link to an allowlisted frozen snapshot. Requires explicit owner permission to publish. Raw inputs, credentials and private actions are excluded.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["runId","title","sourceIds","publishConsent"],"properties":{"runId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":160},"sourceIds":{"type":"array","minItems":1,"maxItems":8,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"includeEvidence":{"type":"boolean","default":false},"includeTable":{"type":"boolean","default":false},"publishConsent":{"const":true},"expiresInHours":{"type":"integer","minimum":1,"maximum":168,"default":24}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/services/product/shares/{id}":{"delete":{"tags":["OMNIA Product"],"operationId":"revokeOmniaProductShare","description":"Revoke a read-only link. Previously downloaded copies remain outside this control.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/v1/product-shares":{"post":{"tags":["OMNIA Product"],"operationId":"readOmniaSharedSnapshot","security":[],"description":"Read the explicitly shared snapshot using its bearer token. Token stays in the request body, not the URL.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/product-agent-manifest":{"get":{"tags":["OMNIA Product"],"operationId":"getOmniaAgentManifest","security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"403":{"description":"Permission required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Not found in this account","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"409":{"description":"Revision or idempotency conflict","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"413":{"description":"Input too large","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"description":"Engine busy","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/v1/dataset/capabilities":{"get":{"tags":["Agent Platform"],"summary":"Discover supported dataset transports, scopes and limits","description":"External stable keys must be at most 200 characters. Oversized keys are refused instead of truncated.","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/dataset/kinds":{"get":{"tags":["Agent Platform"],"summary":"Discover registered record kinds and their required fields","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/dataset/records":{"post":{"tags":["Agent Platform"],"summary":"Append replayable structured records to this account’s dataset","description":"Account identity is stamped from the authenticated key. Records use registered kinds; general JSON values can be sent as observations. Stable keys plus the same source make retries idempotent. Invalid record schemas are quarantined and counted. Generated profiles and pilot plans use their dedicated workflows. Maximum body size: 25 MiB.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"properties":{"source":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]{0,62}$","default":"api"},"records":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string"},"key":{"type":"string","maxLength":200},"signal":{"type":"string"},"value":{"description":"Any non-null JSON scalar, object or array; required for observations."}}}}}}}}},"responses":{"200":{"description":"Accepted, duplicate and quarantined counts with validation reasons"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Dataset scope required"},"404":{"description":"Not found in this account"},"413":{"description":"Body exceeds 25 MiB"}}}},"/v1/dataset/stream":{"post":{"tags":["Agent Platform"],"summary":"Stream account-scoped records as NDJSON with bounded partial commits","description":"One JSON object per line. Limits: 25 MiB per request, 128 KiB per line, 10000 records, 128 records per commit. Up to two streams per account and four per process. Reuse stable record keys and the same source when retrying. An error receipt reports the committed prefix; pending records are not committed. Transport disconnection can prevent receipt delivery. No model calls.","parameters":[{"name":"source","in":"query","schema":{"type":"string","default":"api","pattern":"^[a-z0-9][a-z0-9._-]{0,62}$"}}],"requestBody":{"required":true,"content":{"application/x-ndjson":{"schema":{"type":"string"},"example":"{\"kind\":\"observation\",\"key\":\"sample-1\",\"signal\":\"temperature\",\"value\":21,\"unit\":\"C\"}\n"}}},"responses":{"200":{"description":"Commit receipt: accepted, duplicates, quarantined, rejected line numbers and lastCommittedLine"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Dataset scope required"},"404":{"description":"Not found in this account"},"408":{"description":"Aborted; receipt identifies committed records when deliverable"},"413":{"description":"Transport limit exceeded; may include a partial receipt"},"415":{"description":"Use uncompressed application/x-ndjson"},"429":{"description":"Stream capacity busy; Retry-After header supplied"}}}},"/v1/platform/dataset/records/batch":{"post":{"tags":["Agent Platform"],"summary":"Read up to 100 records from the authenticated account","description":"Results preserve requested order. Missing, deleted and foreign IDs all return null. Archives are hash-verified; private text is excluded.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":200}}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Read or agents scope required"},"404":{"description":"Not found in this account"},"503":{"description":"Archive unavailable, busy or failed integrity verification"}}}},"/v1/system/learning-dataset/performance":{"get":{"tags":["Agent Platform"],"summary":"Owner: bounded aggregate dataset timings and capacity","description":"Last 256 samples per stage within one hour. No queries, record IDs or account IDs. Local operation times are not a network SLA.","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/dataset/records/{recordId}":{"parameters":[{"name":"recordId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"tags":["Agent Platform"],"summary":"Read one account-owned record, verifying archived bytes first; no private text returned","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Scope refused"},"404":{"description":"Not found in this account"},"503":{"description":"Archive unavailable or integrity check failed"}}}},"/v1/system/learning-dataset/records/{recordId}":{"parameters":[{"name":"recordId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"tags":["Agent Platform"],"summary":"Owner: read a verified active or archived record without private text","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"},"503":{"description":"Archive unavailable or integrity check failed"}}}},"/v1/system/learning-dataset/index-archives":{"post":{"tags":["Agent Platform"],"summary":"Owner: verify and catalog up to two older pruned archive segments","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"},"503":{"description":"Archive unavailable or integrity check failed"}}}},"/v1/platform/dataset/search":{"get":{"tags":["Agent Platform"],"summary":"Search this account’s active and archived learning metadata","description":"Account comes from the authenticated key. Agents/read scopes may search; dataset-only keys remain write-only.","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":500},"description":"Literal AND-prefix terms over structured metadata; private text is not indexed."},{"name":"kind","in":"query","schema":{"type":"string"}},{"name":"subject","in":"query","schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string"}},{"name":"until","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Scope refused"},"404":{"description":"Not found in this account"}}}},"/v1/system/learning-dataset/search":{"get":{"tags":["Agent Platform"],"summary":"Owner: search active and archived dataset metadata","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":500},"description":"Literal AND-prefix terms over structured metadata; private text is not indexed."},{"name":"kind","in":"query","schema":{"type":"string"}},{"name":"subject","in":"query","schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string"}},{"name":"until","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000}},{"name":"account","in":"query","schema":{"type":"string"},"description":"Optional pseudonymous account filter"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"}}}},"/v1/system/learning-dataset/cycle":{"post":{"tags":["Agent Platform"],"summary":"Owner: process up to 500 new numeric observations into lineage-linked profiles","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"}}}},"/v1/system/learning-dataset/pilot-plan":{"get":{"tags":["Agent Platform"],"summary":"Owner: open the locked evaluation plan","parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string"}},{"name":"pilotId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"}}},"post":{"tags":["Agent Platform"],"summary":"Owner: register immutable rules before collecting pilot results","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["accountId","pilotId","task","baselineName","omniaVersion","metric","unit","direction","cases","minimumImprovement","maximumRegressionPct"],"properties":{"accountId":{"type":"string","minLength":1,"maxLength":200},"pilotId":{"type":"string","minLength":1,"maxLength":200},"task":{"type":"string","minLength":1,"maxLength":200},"baselineName":{"type":"string","minLength":1,"maxLength":200},"omniaVersion":{"type":"string","minLength":1,"maxLength":200},"metric":{"type":"string","minLength":1,"maxLength":200},"unit":{"type":"string","minLength":1,"maxLength":200},"direction":{"enum":["higher","lower"]},"cases":{"type":"array","minItems":1,"maxItems":200,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":100}},"minimumImprovement":{"type":"number","minimum":0},"maximumRegressionPct":{"type":"number","minimum":0,"maximum":100},"synthetic":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"},"409":{"description":"Locked plan differs, prior measurements exist, or archives need indexing"}}}},"/v1/system/learning-dataset/pilot-pair":{"post":{"tags":["Agent Platform"],"summary":"Owner: save one reported baseline/OMNIA pair under a locked plan","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["accountId","pilotId","caseId","baseline","omnia","observedAt"],"properties":{"accountId":{"type":"string"},"pilotId":{"type":"string"},"caseId":{"type":"string"},"baseline":{"type":"number"},"omnia":{"type":"number"},"observedAt":{"type":"string","format":"date-time"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"},"409":{"description":"Existing pair differs; measurements cannot be overwritten"}}}},"/v1/system/learning-dataset/pilot-report":{"post":{"tags":["Agent Platform"],"summary":"Owner: calculate and save a paired descriptive pilot comparison","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["accountId","pilotId"],"description":"Set registered=true to use the locked plan. Otherwise metric, unit and direction are required.","properties":{"accountId":{"type":"string"},"pilotId":{"type":"string"},"metric":{"type":"string"},"unit":{"type":"string"},"direction":{"enum":["higher","lower"]},"registered":{"type":"boolean","default":false},"includeSynthetic":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"403":{"description":"Owner required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/capabilities":{"get":{"tags":["Agent Platform"],"summary":"Step types, models, prices and default budgets","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/catalog":{"get":{"tags":["Agent Platform"],"summary":"Ready-built agents to start from","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents":{"get":{"tags":["Agent Platform"],"summary":"List your agents","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}},"post":{"tags":["Agent Platform"],"summary":"Create an agent from a spec","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","steps"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputs":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","long","json"]},"description":{"type":"string"},"example":{"type":"string"}}}},"steps":{"type":"array","items":{"type":"object","required":["id","use"],"properties":{"id":{"type":"string"},"use":{"enum":["model","agent","http","fetch-page","measure-text","flow","template","diff-text","social-scout","evidence-research","signal-quality","bias-governance","dataset-search","dataset-read"]},"with":{"type":"object"},"when":{"type":"string"}}}},"output":{"type":"string"},"schedule":{"type":"object","properties":{"everyMinutes":{"type":"integer","minimum":15},"inputs":{"type":"object"}}},"delivery":{"type":"object","properties":{"webhookUrl":{"type":"string","format":"uri"}}},"trigger":{"type":"object","properties":{"enabled":{"type":"boolean"}}},"budget":{"type":"object","properties":{"maxRunsPerDay":{"type":"integer"},"maxCostPerRunUsd":{"type":"number"},"monthlyUsd":{"type":"number"}}}}}}}},"responses":{"200":{"description":"OK"},"201":{"description":"Created; webhookSecret and triggerSecret are shown once"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"get":{"tags":["Agent Platform"],"summary":"An agent and its version history","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}},"put":{"tags":["Agent Platform"],"summary":"Save a new version","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","steps"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputs":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","long","json"]},"description":{"type":"string"},"example":{"type":"string"}}}},"steps":{"type":"array","items":{"type":"object","required":["id","use"],"properties":{"id":{"type":"string"},"use":{"enum":["model","agent","http","fetch-page","measure-text","flow","template","diff-text","social-scout","evidence-research","signal-quality","bias-governance","dataset-search","dataset-read"]},"with":{"type":"object"},"when":{"type":"string"}}}},"output":{"type":"string"},"schedule":{"type":"object","properties":{"everyMinutes":{"type":"integer","minimum":15},"inputs":{"type":"object"}}},"delivery":{"type":"object","properties":{"webhookUrl":{"type":"string","format":"uri"}}},"trigger":{"type":"object","properties":{"enabled":{"type":"boolean"}}},"budget":{"type":"object","properties":{"maxRunsPerDay":{"type":"integer"},"maxCostPerRunUsd":{"type":"number"},"monthlyUsd":{"type":"number"}}}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/runs":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}},{"name":"wait","in":"query","schema":{"enum":["1"]},"description":"Wait for the run to finish"}],"get":{"tags":["Agent Platform"],"summary":"Recent runs, newest first","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}},"post":{"tags":["Agent Platform"],"summary":"Run the agent now","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"type":"object"}}}}}},"responses":{"200":{"description":"Finished (with wait=1)"},"202":{"description":"Started"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"402":{"description":"Budget or account limit reached"},"404":{"description":"Not found in this account"},"429":{"description":"Daily run limit reached"}}}},"/v1/platform/agents/{agentId}/status":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Pause or resume","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"enum":["active","paused"]}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/evaluate":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Replay recent real inputs through a candidate spec; verdict safe or regressed","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["candidate"],"properties":{"candidate":{"type":"object","required":["name","steps"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputs":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","long","json"]},"description":{"type":"string"},"example":{"type":"string"}}}},"steps":{"type":"array","items":{"type":"object","required":["id","use"],"properties":{"id":{"type":"string"},"use":{"enum":["model","agent","http","fetch-page","measure-text","flow","template","diff-text","social-scout","evidence-research","signal-quality","bias-governance","dataset-search","dataset-read"]},"with":{"type":"object"},"when":{"type":"string"}}}},"output":{"type":"string"},"schedule":{"type":"object","properties":{"everyMinutes":{"type":"integer","minimum":15},"inputs":{"type":"object"}}},"delivery":{"type":"object","properties":{"webhookUrl":{"type":"string","format":"uri"}}},"trigger":{"type":"object","properties":{"enabled":{"type":"boolean"}}},"budget":{"type":"object","properties":{"maxRunsPerDay":{"type":"integer"},"maxCostPerRunUsd":{"type":"number"},"monthlyUsd":{"type":"number"}}}}},"sample":{"type":"integer","minimum":1,"maximum":20}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/experiments":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"get":{"tags":["Agent Platform"],"summary":"Live A/B experiments and where each stands","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}},"post":{"tags":["Agent Platform"],"summary":"Start a live experiment: a share of real runs goes to a candidate; ratings decide","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["candidate"],"properties":{"candidate":{"type":"object","required":["name","steps"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputs":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","long","json"]},"description":{"type":"string"},"example":{"type":"string"}}}},"steps":{"type":"array","items":{"type":"object","required":["id","use"],"properties":{"id":{"type":"string"},"use":{"enum":["model","agent","http","fetch-page","measure-text","flow","template","diff-text","social-scout","evidence-research","signal-quality","bias-governance","dataset-search","dataset-read"]},"with":{"type":"object"},"when":{"type":"string"}}}},"output":{"type":"string"},"schedule":{"type":"object","properties":{"everyMinutes":{"type":"integer","minimum":15},"inputs":{"type":"object"}}},"delivery":{"type":"object","properties":{"webhookUrl":{"type":"string","format":"uri"}}},"trigger":{"type":"object","properties":{"enabled":{"type":"boolean"}}},"budget":{"type":"object","properties":{"maxRunsPerDay":{"type":"integer"},"maxCostPerRunUsd":{"type":"number"},"monthlyUsd":{"type":"number"}}}}},"share":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}}}}}},"responses":{"200":{"description":"OK"},"201":{"description":"Started"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/experiments/{experimentId}/{action}":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}},{"name":"experimentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"action","in":"path","required":true,"schema":{"enum":["apply","stop"]}}],"post":{"tags":["Agent Platform"],"summary":"Apply a proven winner as a new version, or stop","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/webhook-secret":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Rotate the delivery signing secret","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/agents/{agentId}/trigger-secret":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Rotate the inbound trigger secret","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/triggers/{agentId}":{"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","pattern":"^agent_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Start a run from another app","description":"Authenticate with ?token=<triggerSecret>, or sign: x-omnia-signature: t=<unix>,v1=HMAC-SHA256(secret, \"t.body\"). JSON fields matching input names become inputs; the whole payload is {{trigger.body}}.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"202":{"description":"Run started"},"401":{"description":"Signature or token invalid"}}}},"/v1/platform/runs/{runId}":{"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","pattern":"^arun_[0-9a-f]+$"}}],"get":{"tags":["Agent Platform"],"summary":"One run with each step, cost and output","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/runs/{runId}/feedback":{"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","pattern":"^arun_[0-9a-f]+$"}}],"post":{"tags":["Agent Platform"],"summary":"Rate a run (this is how your agents improve)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rating"],"properties":{"rating":{"enum":["up","down"]},"note":{"type":"string"},"expected":{"description":"What the output should have been"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/secrets":{"get":{"tags":["Agent Platform"],"summary":"Names of your stored secrets (values are never returned)","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}},"post":{"tags":["Agent Platform"],"summary":"Store or replace a secret for your agents to use","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,63}$"},"value":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"201":{"description":"Stored"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/secrets/{name}":{"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"delete":{"tags":["Agent Platform"],"summary":"Delete a secret","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/usage":{"get":{"tags":["Agent Platform"],"summary":"This month's spend and runs, per agent","responses":{"200":{"description":"OK"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/platform/mcp":{"post":{"tags":["Agent Platform"],"summary":"Hosted MCP (Streamable HTTP): every active agent is a tool","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"A JSON-RPC 2.0 MCP message"}}}},"responses":{"200":{"description":"OK"},"202":{"description":"Notification accepted"},"400":{"description":"Invalid request"},"401":{"description":"Account key required"},"404":{"description":"Not found in this account"}}}},"/v1/services":{"get":{"summary":"List owned service integrations","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Register a service and its success metric","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","metric","direction","idempotencyKey"],"properties":{"name":{"type":"string","maxLength":160},"metric":{"type":"string","maxLength":160},"direction":{"enum":["higher","lower"]},"idempotencyKey":{"type":"string","maxLength":160}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/services/{serviceId}/runs":{"parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Retrieve measured service runs","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"summary":"Measure text or attach an authorized Flux record to a service run","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["idempotencyKey","consent"],"oneOf":[{"required":["text"],"not":{"anyOf":[{"required":["fluxId"]},{"required":["observations"]}]}},{"required":["fluxId"],"not":{"anyOf":[{"required":["text"]},{"required":["observations"]}]}},{"required":["observations"],"not":{"anyOf":[{"required":["text"]},{"required":["fluxId"]}]}}],"properties":{"observations":{"type":"array","minItems":1,"maxItems":256,"items":{"type":"object","required":["evidenceClass","quantityKind","value","unit","method","methodVersion"]}},"text":{"type":"string","maxLength":100000},"fluxId":{"type":"string"},"variant":{"type":"string","default":"baseline"},"idempotencyKey":{"type":"string"},"consent":{"type":"object","required":["measure","store"],"properties":{"measure":{"const":true},"store":{"const":true}}}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/services/{serviceId}/outcomes":{"parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"summary":"Record one actual reported outcome per service run","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["runId","value","idempotencyKey"],"properties":{"runId":{"type":"string"},"value":{"type":"number"},"idempotencyKey":{"type":"string"}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/services/{serviceId}/evaluation":{"parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Compare reported baseline and variant outcomes without claiming causation","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/healthz":{"get":{"tags":["Discovery"],"operationId":"getHealth","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/launchpad":{"get":{"tags":["Discovery"],"operationId":"getLaunchpad","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/integration":{"get":{"tags":["Discovery"],"operationId":"getIntegrationCapabilities","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/capabilities":{"get":{"tags":["Discovery"],"operationId":"getCapabilities","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/video-analysis/jobs":{"post":{"tags":["Intelligence"],"operationId":"createPrivateVideoAnalysisJob","security":[{"bearerAuth":[]}],"description":"Streams a private MP4, MOV, WebM, or Matroska source into the bounded native video queue. Sources must be no longer than 65 seconds and are deleted after analysis.","parameters":[{"name":"X-File-Name","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"video/mp4":{"schema":{"type":"string","format":"binary"}},"video/quicktime":{"schema":{"type":"string","format":"binary"}},"video/webm":{"schema":{"type":"string","format":"binary"}},"video/x-matroska":{"schema":{"type":"string","format":"binary"}}}},"responses":{"202":{"description":"Private native video-analysis job queued","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"413":{"description":"Compressed source exceeds the configured safe limit"},"415":{"description":"Unsupported video container media type"},"507":{"description":"Insufficient temporary storage for safe analysis"}}}},"/v1/video-analysis/jobs/{jobId}":{"get":{"tags":["Intelligence"],"operationId":"getPrivateVideoAnalysisJob","security":[{"bearerAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Returns queue progress or the compact visual and audio timeline to the submitting authorization boundary only.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-coach/recommendations":{"post":{"tags":["Intelligence"],"operationId":"createAutomaticPersonalResonanceRecommendation","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Combines a reported current state, chosen bounded lift, context, decoded candidate songs, and authorized personal feedback into a private automatic match-then-elevate sequence.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","current","candidates","consent"],"properties":{"subjectRef":{"type":"string"},"current":{"type":"object","required":["valence","energy"]},"goal":{"type":"object"},"context":{"type":"object"},"candidates":{"type":"array","minItems":2,"items":{"type":"object"}},"consent":{"type":"object","required":["analyze","personalize","store"]}},"additionalProperties":true}}}},"responses":{"201":{"description":"Private automatic personal resonance recommendation created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-coach/feedback":{"post":{"tags":["Intelligence"],"operationId":"recordPersonalResonanceOutcome","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records a private reported response to one recommendation and recalculates only that person’s profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","recommendationId","after","outcome","consent"],"properties":{"outcome":{"enum":["better","same","worse"]}},"additionalProperties":true}}}},"responses":{"201":{"description":"Private personal outcome learned","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-coach/profile":{"get":{"tags":["Intelligence"],"operationId":"getPrivatePersonalResonanceProfile","security":[{"bearerAuth":[]}],"parameters":[{"name":"subjectRef","in":"query","required":true,"schema":{"type":"string"}}],"description":"Returns only the authorized person-specific outcome model, without claiming consciousness or objective human frequency.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions":{"get":{"tags":["Intelligence"],"operationId":"listAuthorizedSharedResonanceSessions","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"createSharedResonanceSession","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Creates a private two-person synchronized measurement session. Both people must independently consent to measurement, comparison, storage, and sharing derived results with each other.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["participants"],"properties":{"participants":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","required":["participantId","consent"],"properties":{"participantId":{"type":"string"},"label":{"type":"string"},"consent":{"type":"object","required":["measure","compare","store","shareDerivedWithPartner"]}},"additionalProperties":true}},"relationshipContext":{"type":["object","null"],"additionalProperties":true},"artifact":{"type":["object","null"],"additionalProperties":true},"timing":{"type":"object","additionalProperties":true},"retention":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Private Shared Resonance session created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/review-queue":{"get":{"tags":["Intelligence"],"operationId":"listAuthorizedResonanceEvidenceReviewQueue","security":[{"bearerAuth":[]}],"description":"Lists completed authorized Shared Resonance pilot summaries that have not received a human evidence decision. Raw frames, notes, and participant identities are excluded.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/reviews":{"post":{"tags":["Intelligence"],"operationId":"reviewSharedResonancePilotEvidence","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records a confirmed human include, exclude, or needs-more-information decision. Inclusion authorizes cohort analysis only; global training remains false.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sessionId","decision","reason","checklist","actor","consent"],"properties":{"sessionId":{"type":"string"},"decision":{"enum":["include","exclude","needs-more-information"]},"reason":{"type":"string","minLength":1,"maxLength":2000},"checklist":{"type":"object","additionalProperties":{"type":"boolean"}},"actor":{"type":"object","required":["type","subjectRef","confirmed"],"additionalProperties":true},"consent":{"type":"object","required":["analyze","store"],"additionalProperties":true}},"additionalProperties":false}}}},"responses":{"201":{"description":"Resonance evidence review stored","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/cohorts":{"get":{"tags":["Intelligence"],"operationId":"analyzeAuthorizedResonanceEvidenceCohort","security":[{"bearerAuth":[]}],"description":"Aggregates independent human-reviewed sessions with 95% intervals and minimum-cohort suppression. Reported and measured layers remain separate.","parameters":[{"name":"minimumCohortSize","in":"query","schema":{"type":"integer","minimum":3,"maximum":50,"default":5}},{"name":"artifactId","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/atlas":{"get":{"tags":["Intelligence"],"operationId":"getAuthorizedSongResponseAtlas","security":[{"bearerAuth":[]}],"description":"Groups reviewed cohort summaries by song while preserving uncertainty and suppressing undersized artifacts.","parameters":[{"name":"minimumCohortSize","in":"query","schema":{"type":"integer","minimum":3,"maximum":50,"default":5}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/experiments":{"get":{"tags":["Validation"],"operationId":"listAuthorizedResonanceExperimentPlans","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Validation"],"operationId":"createResonanceExperimentPlan","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Creates an inert preregistered experiment draft with one locked primary outcome, counterbalanced controls, repetitions, uncertainty, and stopping rules.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question","artifactIds","primaryOutcome","actor","consent"],"properties":{"question":{"type":"string","minLength":1},"artifactIds":{"type":"array","minItems":1,"items":{"type":"string"}},"primaryOutcome":{"enum":["reported-valence-lift","reported-connection-lift","reported-safety-lift","reported-pleasure-lift","artifact-residualized-convergence"]},"repetitions":{"type":"integer","minimum":2,"maximum":12},"actor":{"type":"object"},"consent":{"type":"object"}},"additionalProperties":false}}}},"responses":{"201":{"description":"Resonance experiment draft preregistered","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/resonance-evidence/status":{"get":{"tags":["Intelligence"],"operationId":"getResonanceEvidenceLabStatus","security":[{"bearerAuth":[]}],"description":"Reports authorized review, cohort, experiment, QA, and global-training gate counts without exposing participant data.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/pilot-protocol":{"get":{"tags":["Intelligence"],"operationId":"getSharedResonancePilotProtocol","description":"Creates a hardware-independent, counterbalanced, preregistered pilot protocol for consented audio/video uploads and participant reports. Synthetic data is explicitly limited to software QA.","parameters":[{"name":"seed","in":"query","schema":{"type":"string"}},{"name":"repetitions","in":"query","schema":{"type":"integer","minimum":2,"maximum":12,"default":3}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}":{"get":{"tags":["Intelligence"],"operationId":"getAuthorizedSharedResonanceSession","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"tags":["Data Rights"],"operationId":"deleteSharedResonanceSession","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Deletes the synchronized frames and derived analysis for the named authorized session.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}/frames":{"post":{"tags":["Synchronization"],"operationId":"appendSharedResonanceFrames","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Appends a bounded monotonic batch to a baseline, separate-artifact, joint-artifact, no-artifact, or control condition.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["conditionId","frames"],"properties":{"conditionId":{"enum":["person-a-alone","person-b-alone","together-no-artifact","person-a-artifact-alone","person-b-artifact-alone","together-artifact","control"]},"frames":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","required":["t"],"additionalProperties":true}}},"additionalProperties":false}}}},"responses":{"202":{"description":"Synchronized frames accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}/check-ins":{"post":{"tags":["Intelligence"],"operationId":"appendSharedResonanceParticipantCheckIn","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Stores one participant-reported experience check-in for a named pilot condition. Reports remain separate from measured synchronized frames.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["checkInId","conditionId","participantId","experience"],"properties":{"checkInId":{"type":"string"},"conditionId":{"enum":["person-a-alone","person-b-alone","together-no-artifact","person-a-artifact-alone","person-b-artifact-alone","together-artifact","control"]},"participantId":{"type":"string"},"exposureSeconds":{"type":"number","minimum":0,"maximum":3600},"notes":{"type":["string","null"],"maxLength":2000},"experience":{"type":"object","required":["valence","arousal","reportedConnection","reportedSafety","reportedPleasure"],"properties":{"valence":{"type":"number","minimum":0,"maximum":10},"arousal":{"type":"number","minimum":0,"maximum":10},"reportedConnection":{"type":"number","minimum":0,"maximum":10},"reportedSafety":{"type":"number","minimum":0,"maximum":10},"reportedPleasure":{"type":"number","minimum":0,"maximum":10}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Participant-reported condition check-in stored","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}/pilot-report":{"post":{"tags":["Intelligence"],"operationId":"createSharedResonancePilotReport","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Creates an evidence-separated guided pilot report: reported song and togetherness contrasts, measured convergence only when frames exist, uncertainty, and a human-review-only learning candidate.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"201":{"description":"Guided Shared Resonance pilot report created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}/coach-handoffs":{"post":{"tags":["Intelligence"],"operationId":"createSharedResonanceCoachHandoff","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"With separate participant consent, transforms only that participant’s latest reported pilot state into a private Personal Resonance Coach starting point. The partner’s report is not copied and the handoff is never automatically eligible for global training.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["participantId","consent"],"properties":{"participantId":{"type":"string"},"goal":{"type":"object","additionalProperties":true},"context":{"type":"object","additionalProperties":true},"consent":{"type":"object","required":["personalize","store"],"properties":{"personalize":{"const":true},"store":{"const":true}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Private participant-specific coach handoff created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/shared-resonance/sessions/{sessionId}/analyze":{"post":{"tags":["Intelligence"],"operationId":"analyzeSharedResonance","security":[{"bearerAuth":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"description":"Calculates raw and artifact-residualized coupling, circular-shift controls, lead/lag candidates, condition contrasts, triadic emergence, reported experience, confidence, alternatives, and explicit prohibited claims.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"201":{"description":"Shared Resonance analysis created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/cellular/value-analysis":{"post":{"tags":["Intelligence"],"operationId":"analyzeCellularNetworkValue","security":[{"bearerAuth":[]}],"description":"Fuses exact plan cost, data usage, needed-place coverage, measured performance, reliability, and evidence completeness into a traceable cellular value ranking. It does not guarantee service or claim browser access to radio metrics.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plans"],"properties":{"plans":{"type":"array","minItems":2,"items":{"type":"object","required":["carrier","planName","monthlyPrice"],"additionalProperties":true}},"observations":{"type":"array","items":{"type":"object"}},"usage":{"type":"object","properties":{"monthlyGb":{"type":"number","minimum":0},"lines":{"type":"integer","minimum":1}}},"profile":{"enum":["balanced","value","creator","safety"]},"currentMonthlyCost":{"type":["number","null"],"minimum":0}},"additionalProperties":false}}}},"responses":{"200":{"description":"Evidence-backed cellular value analysis","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/status":{"get":{"tags":["Agents"],"operationId":"getExecutiveOperatingAgentStatus","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/snapshot":{"get":{"tags":["Agents"],"operationId":"getExecutiveCompanySnapshot","security":[{"bearerAuth":[]}],"description":"Returns bounded operational summaries across connectors, evidence sources, pipelines, delivery, QA, OMNIA Flow, and BillChat Market Scout. Raw content and personal data are excluded.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/briefs":{"get":{"tags":["Agents"],"operationId":"listExecutiveBriefs","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Agents"],"operationId":"createExecutiveBrief","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Creates a founder-facing three-priority brief, scorecard, risk prompts, stop-doing list, owners, and deadlines from authorized operational summaries. It never executes external actions.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["context"],"properties":{"trigger":{"type":"string"},"context":{"type":"object","required":["consent"],"properties":{"company":{"type":"object","additionalProperties":true},"goals":{"type":"array","items":{"type":"string"}},"consent":{"type":"object","required":["analyze","store"],"properties":{"analyze":{"const":true},"store":{"const":true}}}},"additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Executive brief created and privately bound","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/briefs/latest":{"get":{"tags":["Agents"],"operationId":"getLatestExecutiveBrief","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/briefs/{briefId}":{"get":{"tags":["Agents"],"operationId":"getExecutiveBrief","security":[{"bearerAuth":[]}],"parameters":[{"name":"briefId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/decisions":{"get":{"tags":["Agents"],"operationId":"listExecutiveDecisions","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Agents"],"operationId":"recordExecutiveDecision","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records an accountable human decision against one prompt. Recording is not proof of external execution.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["briefId","promptId","decision","consent"],"properties":{"briefId":{"type":"string"},"promptId":{"type":"string"},"decision":{"type":"string"},"rationale":{"type":"string"},"decidedBy":{"type":"string"},"consent":{"type":"object","required":["store"],"properties":{"store":{"const":true}}}},"additionalProperties":false}}}},"responses":{"201":{"description":"Executive decision recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/executive/tick":{"post":{"tags":["Agents"],"operationId":"tickExecutiveOperatingAgent","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trigger":{"type":"string"},"context":{"type":["object","null"],"additionalProperties":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/billchat/market-agent/sources":{"get":{"tags":["Agents"],"operationId":"listBillChatHomeServicesMarketSources","description":"Lists first-party, public, authorized, licensed, prepared, and limited home-services demand and sales sources with truthful connection prerequisites.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/billchat/market-agent/collect":{"post":{"tags":["Agents"],"operationId":"collectBillChatHomeServicesMarketSignals","security":[{"bearerAuth":[]}],"description":"Collects signals from explicitly requested rights-declared connectors. OpenFEMA is live without credentials; other catalog entries report their prerequisite rather than fabricating data.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["markets"],"properties":{"markets":{"type":"array","minItems":1,"items":{"type":"object","required":["marketId"],"additionalProperties":true}},"sourceIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/billchat/market-agent/runs":{"get":{"tags":["Agents"],"operationId":"listAuthorizedBillChatHomeServicesMarketRuns","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Agents"],"operationId":"runBillChatHomeServicesMarketAgent","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Fissions authorized home-services signals by market, trade, time, rights, freshness, and evidence; fuses demand, intent, triggers, unit economics, competition, and capacity into a governed marketing slate.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["markets","consent"],"properties":{"markets":{"type":"array","minItems":1,"items":{"type":"object","required":["marketId"],"additionalProperties":true}},"signals":{"type":"array","items":{"type":"object","required":["sourceId","marketId","trade","metric"],"additionalProperties":true}},"firstParty":{"type":"array","items":{"type":"object","required":["marketId","trade"],"additionalProperties":true}},"asOf":{"type":"string","format":"date-time"},"consent":{"type":"object","required":["analyze"]}},"additionalProperties":true}}}},"responses":{"201":{"description":"Private BillChat home-services opportunity slate created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/billchat/market-agent/runs/{runId}":{"get":{"tags":["Agents"],"operationId":"getAuthorizedBillChatHomeServicesMarketRun","security":[{"bearerAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/omnia-flow/runs":{"get":{"tags":["Intelligence"],"operationId":"listAuthorizedOmniaFlowRuns","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"runMassiveFissionFusionFlow","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Repeats decode/transform, source fission, top-impact fusion, structural lift, fused-result fission, recursive fusion, and quality evaluation until every declared gate passes or a visible safety stop fires. The strongest verified candidate is retained.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data","consent"],"properties":{"sourceId":{"type":"string"},"data":{"type":"object"},"objective":{"enum":["understand","normalize","privacy","derive"]},"maxIterations":{"type":"integer","minimum":1,"maximum":12},"maxConvergenceCycles":{"type":"integer","minimum":1,"maximum":12,"default":8},"stagnationLimit":{"type":"integer","minimum":1,"maximum":4,"default":2},"top":{"type":"integer","minimum":1,"maximum":13},"lift":{"type":"number","minimum":0,"maximum":1},"consent":{"type":"object","required":["analyze","transform","fuse"]}},"additionalProperties":true}}}},"responses":{"201":{"description":"Private OMNIA Flow converged or stopped with a reviewable best candidate","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/omnia-flow/runs/{flowRunId}":{"get":{"tags":["Intelligence"],"operationId":"getAuthorizedOmniaFlowRun","security":[{"bearerAuth":[]}],"parameters":[{"name":"flowRunId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/omnia-flow/runs/{flowRunId}/events":{"post":{"tags":["Intelligence"],"operationId":"attachWidgetEventToOmniaFlow","security":[{"bearerAuth":[]}],"parameters":[{"name":"flowRunId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Joins Song Intelligence, Personal Resonance, NOUS, or another authorized widget artifact to the same flow. Personal resonance feedback closes the loop.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["widget","type"],"properties":{"widget":{"type":"string"},"type":{"type":"string"},"artifact":{"type":["object","null"]},"summary":{"type":["string","null"]}}}}}},"responses":{"201":{"description":"Widget event joined to the flow","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/open-protocol":{"get":{"tags":["Interoperability"],"operationId":"getOpenFluxProtocol","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/system/manifest":{"get":{"tags":["System"],"operationId":"getSystemManifest","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/operations/quality":{"get":{"tags":["Performance"],"operationId":"getOperationalQuality","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/status":{"get":{"tags":["Agents"],"operationId":"getCorrectionAgentStatus","description":"Reports the governed correction agent state and its immutable authority boundaries.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/runs":{"get":{"tags":["Agents"],"operationId":"listAuthorizedCorrectionAgentRuns","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000,"default":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Agents"],"operationId":"runCorrectionIntelligenceAgent","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Uses learning-consented corrections, scored predictions, outcomes, and time-aligned signals to propose algorithm corrections and holdout-validated inferred relationships. It never mutates production.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","consent"],"properties":{"subjectRef":{"type":"string"},"actionContext":{"type":"string"},"useStoredEvidence":{"type":"boolean","default":true},"confirmations":{"type":"array","items":{"type":"object","additionalProperties":true}},"predictions":{"type":"array","items":{"type":"object","additionalProperties":true}},"outcomes":{"type":"array","items":{"type":"object","additionalProperties":true}},"signals":{"type":"array","items":{"type":"object","additionalProperties":true}},"targets":{"type":"array","items":{"type":"object","additionalProperties":true}},"targetMetric":{"type":"string"},"configuration":{"type":"object","additionalProperties":true},"consent":{"type":"object","required":["analyze","store"],"properties":{"analyze":{"const":true},"store":{"const":true}},"additionalProperties":true}},"additionalProperties":true}}}},"responses":{"201":{"description":"Governed correction cycle completed and privately bound","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/recommendations":{"get":{"tags":["Agents"],"operationId":"listAuthorizedAlgorithmRecommendations","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000,"default":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/evaluations":{"post":{"tags":["Agents"],"operationId":"evaluateCorrectionAgentChallenger","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recommendationId","sampleSize","champion","challenger","holdout","safety"],"additionalProperties":true}}}},"responses":{"201":{"description":"Locked-holdout challenger evaluation recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/promotions":{"post":{"tags":["Agents"],"operationId":"decideCorrectionAgentPromotion","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records a confirmed human decision. Approval authorizes only a bounded challenger canary, never automatic production promotion.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recommendationId","evaluationId","decision","actor"],"additionalProperties":true}}}},"responses":{"201":{"description":"Human promotion decision recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/agents/correction/relationships/{relationshipCandidateId}/approve":{"post":{"tags":["Agents"],"operationId":"approveInferredRelationshipCandidate","security":[{"bearerAuth":[]}],"parameters":[{"name":"relationshipCandidateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Human approval materializes a holdout-validated association as inferred graph evidence. It never creates a causal claim.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["actor"],"additionalProperties":true}}}},"responses":{"201":{"description":"Human-approved inferred graph relationship recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/status":{"get":{"tags":["JWLS"],"operationId":"getJwlsPolicyEngineStatus","description":"Reports policy-engine counts and the boundary that OMNIA cannot execute a credit or mint.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/policies":{"get":{"tags":["JWLS"],"operationId":"listJwlsEarningPolicies","description":"Lists versioned earning policies, formulas, caps, and supply effects.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/status":{"get":{"tags":["JWLS"],"operationId":"getJwlsLiquidityVaultStatus","description":"Reports aggregate settled, held, consumed, and available reserve accounting plus connection and authority boundaries. A rate is never derived from EFVT, Hz, color, emotion, Hawkins labels, +111, or hype.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/funding":{"post":{"tags":["JWLS"],"operationId":"recordJwlsLiquidityFunding","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records verified external funding evidence. OMNIA does not custody USD.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["source","usdCents","providerReceiptId","settledAt","verification"],"additionalProperties":true}}}},"responses":{"201":{"description":"Funding evidence recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/quotes":{"post":{"tags":["JWLS"],"operationId":"createJwlsUsdRedemptionQuote","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Creates an expiring reserve-coverage quote after verifying a standalone-ledger balance attestation and liquidity buffer.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","requestedJwl","ledgerAttestation","consent"],"additionalProperties":true}}}},"responses":{"201":{"description":"Redemption quote created; no reserve or ledger movement executed","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/holds":{"post":{"tags":["JWLS"],"operationId":"holdJwlsUsdRedemption","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Reserves USD accounting only after the standalone JWLS ledger attests a matching JWL Treasury-escrow hold.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quoteId","ledgerHoldAttestation"],"additionalProperties":true}}}},"responses":{"201":{"description":"Redemption hold recorded","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/payouts/prepare":{"post":{"tags":["JWLS"],"operationId":"prepareJwlsUsdPayout","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Prepares a provider-neutral Stripe Connect or Circle instruction after KYC, sanctions, risk, tax, consent, and hold gates. OMNIA does not execute it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["holdId","compliance","destination"],"additionalProperties":true}}}},"responses":{"201":{"description":"Payout instruction prepared; not executed","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/payouts/reconcile":{"post":{"tags":["JWLS"],"operationId":"reconcileJwlsUsdPayout","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records a signature-verified paid or failed provider event and proposes the corresponding standalone-ledger settlement or hold release.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["payoutId","providerEvent"],"additionalProperties":true}}}},"responses":{"201":{"description":"Provider event reconciled","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/liquidity/records":{"get":{"tags":["JWLS"],"operationId":"listAuthorizedJwlsLiquidityRecords","parameters":[{"name":"kind","in":"query","required":true,"schema":{"enum":["quotes","holds","payouts","reconciliations"]}},{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/claims/evaluate":{"post":{"tags":["JWLS"],"operationId":"evaluateJwlsRewardClaim","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Creates an explainable reward proposal from verified action evidence. Literal Hz, color, emotion estimates, vibe labels, normalized EFVT, and +111 cannot directly authorize value.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["policy","subjectRef","sourceApp","authorityBasis","action","verification","consent"],"properties":{"policy":{"type":"string"},"subjectRef":{"type":"string"},"sourceApp":{"type":"string"},"authorityBasis":{"enum":["verified-action","verified-outcome","verified-financial-event","verified-community-impact"]},"action":{"type":"object","required":["type","occurredAt","inputs"],"additionalProperties":true},"efvt":{"type":"object","properties":{"energy":{"type":"number","minimum":0,"maximum":1},"frequency":{"type":"number","minimum":0,"maximum":1},"vibration":{"type":"number","minimum":0,"maximum":1},"time":{"type":"number","minimum":0,"maximum":1}}},"evidenceIds":{"type":"array","items":{"type":"string"}},"verification":{"type":"object","required":["status","confidence"],"additionalProperties":true},"consent":{"type":"object","required":["store","economicEvaluation"],"properties":{"store":{"const":true},"economicEvaluation":{"const":true}},"additionalProperties":true},"idempotencyKey":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Reward claim evaluated and receipt stored; no ledger movement executed","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/decisions":{"get":{"tags":["JWLS"],"operationId":"listAuthorizedJwlsPolicyDecisions","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"enum":["eligible","ineligible","nominated"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/receipts":{"get":{"tags":["JWLS"],"operationId":"listAuthorizedJwlsRewardReceipts","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/receipts/{receiptId}":{"get":{"tags":["JWLS"],"operationId":"getAuthorizedJwlsRewardReceipt","parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/jwls/mint-approvals":{"get":{"tags":["JWLS"],"operationId":"listAuthorizedJwlsMintApprovals","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["JWLS"],"operationId":"approveJwlsExceptionalMint","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"description":"Records a separate confirmed human review for a qualifying exceptional nomination. Produces exactly 144 JWL as an unexecuted ledger instruction.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["decisionId","actor","evidenceIds","reason"],"properties":{"decisionId":{"type":"string"},"actor":{"type":"object","required":["type","subjectRef","confirmed"],"properties":{"type":{"const":"human"},"subjectRef":{"type":"string"},"confirmed":{"const":true}}},"evidenceIds":{"type":"array","minItems":2,"items":{"type":"string"}},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}},"additionalProperties":true}}}},"responses":{"201":{"description":"Human mint review recorded; ledger execution remains external","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/quality/validate":{"post":{"tags":["Trust"],"operationId":"validateDataQuality","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["records"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/quality/drift":{"post":{"tags":["Trust"],"operationId":"evaluateMetricDrift","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["metric","baseline","current"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/baselines/personal":{"post":{"tags":["Trust"],"operationId":"calculatePersonalBaseline","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","metric","observations"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/privacy/cohorts/aggregate":{"post":{"tags":["Data Rights"],"operationId":"createPrivacySafeCohortAggregate","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cohortId","metric","values"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/contracts/compatibility":{"post":{"tags":["Interoperability"],"operationId":"evaluateContractCompatibility","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["previous","next"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/validation/multiple-testing":{"post":{"tags":["Trust"],"operationId":"validateResearchFamily","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["familyId","tests"],"additionalProperties":true}}}},"responses":{"200":{"description":"Multiplicity-adjusted research family report","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence/score-card":{"get":{"tags":["Trust"],"operationId":"getInfluenceScoreCard","parameters":[{"name":"actionContext","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/moments":{"get":{"tags":["Intelligence"],"operationId":"listOmniaMoments","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"createOmniaMoment","security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","observedAt"],"additionalProperties":true}}}},"responses":{"201":{"description":"Content-addressed OMNIA Moment created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/receipts/anchor":{"get":{"tags":["Trust"],"operationId":"getReceiptAnchor","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/receipts/anchor/verify":{"post":{"tags":["Trust"],"operationId":"verifyReceiptAnchor","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["anchor","publicKey"],"additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/data-rights/export-manifest":{"get":{"tags":["Data Rights"],"operationId":"getDataExportManifest","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/data-rights/deletion-requests":{"get":{"tags":["Data Rights"],"operationId":"listDeletionRequests","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Data Rights"],"operationId":"createDeletionRequest","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean"},"quarantineDays":{"type":"integer","minimum":0,"maximum":30}}}}}},"responses":{"202":{"description":"Deletion cascade requested","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/workers/status":{"get":{"tags":["Workers"],"operationId":"getCloudWorkerStatus","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/workers/jobs":{"get":{"tags":["Workers"],"operationId":"listCloudWorkerJobs","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Workers"],"operationId":"enqueueCloudWorkerJob","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sourceRef","modality","adapterVersion"],"additionalProperties":true}}}},"responses":{"202":{"description":"Cloud analysis job queued","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/devices":{"get":{"tags":["Devices"],"operationId":"listDevices","parameters":[{"name":"status","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Devices"],"operationId":"registerDevice","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegistration"}}}},"responses":{"201":{"description":"Device registered or versioned","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/devices/{deviceId}":{"get":{"tags":["Devices"],"operationId":"getDevice","parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/devices/{deviceId}/versions":{"get":{"tags":["Devices"],"operationId":"getDeviceVersions","parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/attestations":{"get":{"tags":["Intelligence"],"operationId":"listAttestations","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.attestation/v1 records","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"recordAttestation","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","label","issuer","consent"],"properties":{"subjectRef":{"type":"string"},"kind":{"type":"string","enum":["award","chart","placement","certification","license","press","endorsement","other"]},"label":{"type":"string"},"issuer":{"type":"string"},"issuedAt":{"type":"string","format":"date-time"},"sourceUrl":{"type":"string"},"actionContext":{"type":"string"},"consent":{"type":"object","properties":{"store":{"type":"boolean"}}}}}}}},"responses":{"201":{"description":"Third-party attestation stored as reported evidence with a named issuer","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/directions":{"get":{"tags":["Intelligence"],"operationId":"listDirections","parameters":[{"name":"fromSubjectRef","in":"query","schema":{"type":"string"}},{"name":"targetRef","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.directed-flux/v1 records","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"directFlux","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fromSubjectRef","target","fluxId","intent","consent"],"properties":{"fromSubjectRef":{"type":"string"},"target":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["subject","node","flux","external","place","device"]},"ref":{"type":"string","description":"Required except for place targets"},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"address":{"type":"string"},"name":{"type":"string"}}},"fluxId":{"type":"string"},"intent":{"type":"string"},"message":{"type":"string"},"directedAt":{"type":"string","format":"date-time"},"consent":{"type":"object","properties":{"store":{"type":"boolean"},"deliver":{"type":"boolean"}}}}}}}},"responses":{"201":{"description":"Direction recorded: who directed which measured moment at what, with intent; no transmission claim, target consent gates delivery","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/predictions":{"get":{"tags":["Intelligence"],"operationId":"listPredictions","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"model","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["open","due","resolved"]}}],"responses":{"200":{"description":"The accountable prediction ledger","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"declarePrediction","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","statement","probability","horizon","model","modelVersion","criterion","consent"],"properties":{"subjectRef":{"type":"string"},"statement":{"type":"string"},"probability":{"type":"number","minimum":0,"maximum":1},"horizon":{"type":"string","format":"date-time"},"model":{"type":"string"},"modelVersion":{"type":"string"},"criterion":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["outcome-count","manual"]},"actionContext":{"type":"string"},"kind":{"type":"string"},"minCount":{"type":"integer","minimum":1}}},"evidenceNodeIds":{"type":"array","items":{"type":"string"}},"consent":{"type":"object","properties":{"store":{"type":"boolean"}}}}}}}},"responses":{"201":{"description":"Prediction declared on the ledger; resolution is deterministic and Brier-scored","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/predictions/auto-declare":{"post":{"tags":["Intelligence"],"operationId":"autoDeclareForecasts","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subjectRef":{"type":"string"},"actionContext":{"type":"string"}}}}}},"responses":{"200":{"description":"Standardized baseline forecast slates declared for subject+context pairs with recorded outcomes; open duplicates skipped","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/predictions/resolve":{"post":{"tags":["Intelligence"],"operationId":"resolvePredictions","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"predictionId":{"type":"string"},"reportedOutcome":{"type":"string","enum":["happened","did-not-happen"]}}}}}},"responses":{"200":{"description":"Due auto predictions swept against the outcome ledger, or one manual prediction resolved by report; resolutions immutable","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/predictions/calibration":{"get":{"tags":["Intelligence"],"operationId":"getPredictionCalibration","parameters":[{"name":"model","in":"query","schema":{"type":"string"}},{"name":"subjectRef","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Brier means, hit rates, predicted-vs-observed bins, forecasters ranked best-first","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/geocode":{"get":{"tags":["Intelligence"],"operationId":"geocodeAddress","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provider-reported coordinates for an address (Nominatim/OpenStreetMap, attributed); never a measured location","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/inbox":{"get":{"tags":["Intelligence"],"operationId":"listVibeInbox","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Vibe-message envelopes: sender, intent, time, status; content sealed until opened","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/directions/{directionId}/open":{"post":{"tags":["Intelligence"],"operationId":"openVibeMessage","security":[{"bearerAuth":[]}],"parameters":[{"name":"directionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subjectRef":{"type":"string","description":"The recipient"}}}}}},"responses":{"200":{"description":"Opening is the consent act: returns the direction, measured Flux, and visual-vibration frames","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/directions/{directionId}/decline":{"post":{"tags":["Intelligence"],"operationId":"declineVibeMessage","security":[{"bearerAuth":[]}],"parameters":[{"name":"directionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subjectRef":{"type":"string"},"blockSender":{"type":"boolean","description":"Also block future directions from this sender"}}}}}},"responses":{"200":{"description":"Direction declined; optionally blocks the sender","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/outcomes":{"get":{"tags":["Intelligence"],"operationId":"listOutcomes","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"actionContext","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.outcome/v1 records","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"recordOutcome","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","label","consent"],"properties":{"subjectRef":{"type":"string"},"actionContext":{"type":"string","default":"omnia.general"},"kind":{"type":"string","enum":["conversion","release","placement","goal","payout","confirmation","custom"]},"label":{"type":"string"},"magnitude":{"type":"number","minimum":0},"magnitudeUnit":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"evidenceNodeIds":{"type":"array","items":{"type":"string"}},"consent":{"type":"object","properties":{"store":{"type":"boolean"}}}}}}}},"responses":{"201":{"description":"Outcome stored as reported evidence with attributed-to links; feeds outcome attribution","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence/contexts":{"get":{"tags":["Intelligence"],"operationId":"listInfluenceContexts","responses":{"200":{"description":"Named action-context profiles with per-component weights","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence/explain":{"get":{"tags":["Intelligence"],"operationId":"explainInfluenceWeight","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"actionContext","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Freshly computed weight with per-component evidence node IDs and linked outcomes (not persisted)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence":{"get":{"tags":["Intelligence"],"operationId":"listInfluenceWeights","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"actionContext","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.influence-weight/v1 records for the subject","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence/latest":{"get":{"tags":["Intelligence"],"operationId":"getLatestInfluenceWeight","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"actionContext","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Newest stored influence weight for the subject","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/influence/compute":{"post":{"tags":["Intelligence"],"operationId":"computeInfluenceWeight","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subjectRef":{"type":"string"},"actionContext":{"type":"string","default":"omnia.general"}}}}}},"responses":{"201":{"description":"Deterministic 0–111 per-context influence weight; calculated evidence, never worth or JWLS authorization","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/social/metrics":{"get":{"tags":["Measurements"],"operationId":"listSocialMetrics","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}},{"name":"platform","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.social-metrics/v1 snapshots","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Measurements"],"operationId":"ingestSocialMetrics","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["platform","subjectRef","consent","metrics"],"properties":{"platform":{"type":"string"},"subjectRef":{"type":"string"},"accountRef":{"type":"string"},"capturedAt":{"type":"string","format":"date-time"},"consent":{"type":"object","properties":{"store":{"type":"boolean"}}},"metrics":{"type":"object","properties":{"followers":{"type":"integer","minimum":0},"following":{"type":"integer","minimum":0},"posts":{"type":"integer","minimum":0},"likes":{"type":"integer","minimum":0},"comments":{"type":"integer","minimum":0},"shares":{"type":"integer","minimum":0},"views":{"type":"integer","minimum":0}}}}}}}},"responses":{"201":{"description":"Platform-reported social metrics stored as reported-layer evidence","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/financial/connections":{"get":{"tags":["Measurements"],"operationId":"listFinancialConnections","parameters":[{"name":"subjectRef","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Stored omnia.financial-connection/v1 records — existence and freshness only","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Measurements"],"operationId":"ingestFinancialConnection","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subjectRef","itemId","consent"],"properties":{"subjectRef":{"type":"string"},"itemId":{"type":"string"},"institution_id":{"type":"string"},"institution_name":{"type":"string"},"status":{"type":"string"},"last_synced_at":{"type":"string","format":"date-time"},"accounts":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string"},"name":{"type":"string"},"mask":{"type":"string"}}}},"consent":{"type":"object","properties":{"store":{"type":"boolean"}}}}}}}},"responses":{"201":{"description":"Verified financial connection stored; balances and amounts are refused","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/ingest/observations":{"post":{"tags":["Measurements"],"operationId":"ingestObservations","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Visibility","in":"header","required":false,"schema":{"type":"string","enum":["private","public"],"default":"private"},"description":"Visibility for derived records. Public still requires X-Publish-Consent: true."},{"name":"X-Publish-Consent","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Explicit owner consent required when X-Visibility is public."},{"name":"X-Public-Discovery","in":"header","required":false,"schema":{"type":"boolean","default":false}},{"name":"X-Organization-Share","in":"header","required":false,"schema":{"type":"boolean","default":false},"description":"Requires verified organization membership; applies only to private records."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UniversalObservationIngress"}}}},"responses":{"201":{"description":"Observations normalized, persisted, and linked into NOUS","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/measurements/calibrations":{"post":{"tags":["Measurements"],"operationId":"createCalibration","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Calibration record created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/measurements":{"get":{"tags":["Measurements"],"operationId":"listMeasurements","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/sources":{"get":{"tags":["Sources"],"operationId":"listSources","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Sources"],"operationId":"registerSource","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Source registered or versioned","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/sources/{sourceId}/events":{"post":{"tags":["Sources"],"operationId":"ingestArbitraryDataEvent","security":[{"bearerAuth":[]}],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Arbitrary event linked into NOUS","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/connectors/runtime":{"get":{"tags":["Connectors"],"operationId":"getConnectorRuntime","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/connectors/runtime/runs":{"get":{"tags":["Connectors"],"operationId":"listConnectorRuns","parameters":[{"name":"connectorId","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/connectors/runtime/{connectorId}":{"get":{"tags":["Connectors"],"operationId":"getConnectorState","parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"patch":{"tags":["Connectors"],"operationId":"setConnectorStatus","security":[{"bearerAuth":[]}],"parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["active","paused","revoked"]}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/connectors/runtime/{connectorId}/run":{"post":{"tags":["Connectors"],"operationId":"runConnector","security":[{"bearerAuth":[]}],"parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/trending":{"get":{"tags":["Intelligence"],"operationId":"getNousTrending","description":"Ranks change across every graph record authorized for the requester by comparing two equal time windows. The score is descriptive network movement, not truth, importance, sentiment, value, or currency eligibility.","parameters":[{"name":"windowMinutes","in":"query","schema":{"type":"integer","minimum":5,"maximum":1440,"default":60}},{"name":"direction","in":"query","schema":{"type":"string","enum":["all","rising","cooling"],"default":"all"}},{"name":"category","in":"query","schema":{"type":"string","enum":["topic","place","source","modality","signal"]}},{"name":"scope","in":"query","schema":{"type":"string","enum":["all-authorized","public","personal","organization"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/spatiotemporal":{"get":{"tags":["Intelligence"],"operationId":"calculateSpatiotemporalIntelligence","parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"latitude","in":"query","schema":{"type":"number"}},{"name":"longitude","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","minimum":0}},{"name":"bucketSeconds","in":"query","schema":{"type":"integer","minimum":60}},{"name":"cellDegrees","in":"query","schema":{"type":"number","minimum":0.01,"maximum":30}},{"name":"minimumBaselineBuckets","in":"query","schema":{"type":"integer","minimum":3}},{"name":"anomalyZScore","in":"query","schema":{"type":"number","minimum":1}},{"name":"assertion","in":"query","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/system-map":{"get":{"tags":["System"],"operationId":"getLivingOmniaSystemMap","description":"Returns the live, credential-safe topology of OMNIA components, integrations, sources, runtime health, and typed relationships.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/stress/status":{"get":{"tags":["Performance"],"operationId":"getRealtimeStressStatus","description":"Returns the active isolated load test, limits, and latency distributions.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/stress/runs":{"get":{"tags":["Performance"],"operationId":"listRealtimeStressRuns","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Performance"],"operationId":"createRealtimeStressRun","description":"Starts an isolated synthetic test. Individual events never enter the permanent evidence graph.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"eventCount":{"type":"integer","minimum":100,"maximum":25000,"default":5000},"eventsPerSecond":{"type":"integer","minimum":10,"maximum":5000,"default":1000},"concurrency":{"type":"integer","minimum":1,"maximum":128,"default":32},"modality":{"type":"string","enum":["mixed","audio","text","image","video","sensor"],"default":"mixed"}},"additionalProperties":false}}}},"responses":{"202":{"description":"Stress run started","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/stress/runs/{runId}/stop":{"post":{"tags":["Performance"],"operationId":"stopRealtimeStressRun","security":[{"bearerAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/stress/runs/{runId}/display-receipts":{"post":{"tags":["Performance"],"operationId":"recordRealtimeDisplayReceipt","security":[{"bearerAuth":[]}],"description":"Records requestAnimationFrame timing for ingestion-to-pixel latency.","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sampleId","displayedAtMs"],"properties":{"sampleId":{"type":"string"},"displayedAtMs":{"type":"number"}},"additionalProperties":false}}}},"responses":{"202":{"description":"Display receipt accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/stress/stream":{"get":{"tags":["Performance"],"operationId":"streamRealtimeStressRun","description":"Streams aggregate run progress and sampled visual frames using server-sent events.","responses":{"200":{"description":"Live stress-run stream","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/v1/flight-recorder/metrics":{"get":{"tags":["Performance"],"operationId":"getFlightRecorderMetrics","description":"Returns privacy-safe p50, p95, and p99 timing for real OMNIA traffic.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":25000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/flight-recorder/traces":{"get":{"tags":["Performance"],"operationId":"listFlightTraces","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"sourceSystem","in":"query","schema":{"type":"string"}},{"name":"modality","in":"query","schema":{"type":"string"}},{"name":"route","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/flight-recorder/traces/{traceId}":{"get":{"tags":["Performance"],"operationId":"getFlightTrace","parameters":[{"name":"traceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"tags":["Performance"],"operationId":"deleteFlightTrace","security":[{"bearerAuth":[]}],"parameters":[{"name":"traceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/flight-recorder/traces/{traceId}/spans":{"post":{"tags":["Performance"],"operationId":"appendFlightTraceSpan","description":"Open timing-only receipt seam for devices, providers, workers, and other OMNIA components.","security":[{"bearerAuth":[]}],"parameters":[{"name":"traceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["stage"],"properties":{"stage":{"type":"string"},"startedAtMs":{"type":"number"},"completedAtMs":{"type":"number"},"durationMs":{"type":"number","minimum":0},"details":{"type":"object","additionalProperties":true}},"additionalProperties":false}}}},"responses":{"202":{"description":"Timing span accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/flight-recorder/traces/{traceId}/display-receipts":{"post":{"tags":["Performance"],"operationId":"appendFlightDisplayReceipt","description":"Records the requestAnimationFrame moment a traced event reaches a visual display.","security":[{"bearerAuth":[]}],"parameters":[{"name":"traceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["displayedAtMs"],"properties":{"displayedAtMs":{"type":"number"},"view":{"type":"string"}},"additionalProperties":false}}}},"responses":{"202":{"description":"Display receipt accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/flight-recorder/stream":{"get":{"tags":["Performance"],"operationId":"streamFlightTraces","description":"Streams privacy-safe trace state without exposing event payloads or content.","responses":{"200":{"description":"Live flight trace stream","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/v1/delivery/metrics":{"get":{"tags":["Performance"],"operationId":"getDeliveryMetrics","description":"Returns durable queue health and real remote acknowledgement latency.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/deliveries":{"get":{"tags":["Performance"],"operationId":"listDeliveries","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"destination","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["pending","delivering","retrying","delivered","dead-letter"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/deliveries/retry-dead-letters":{"post":{"tags":["Performance"],"operationId":"retryDeadLetterDeliveries","security":[{"bearerAuth":[]}],"description":"Returns a bounded set of retained dead-letter deliveries to the durable retry queue.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":10000,"default":1000}},"additionalProperties":false}}}},"responses":{"202":{"description":"Dead-letter deliveries queued for recovery","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/deliveries/{deliveryId}":{"get":{"tags":["Performance"],"operationId":"getDelivery","parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"delete":{"tags":["Performance"],"operationId":"deleteDelivery","security":[{"bearerAuth":[]}],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/deliveries/{deliveryId}/retry":{"post":{"tags":["Performance"],"operationId":"retryDelivery","security":[{"bearerAuth":[]}],"description":"Explicitly returns a retained failed delivery to the durable retry queue.","parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Delivery queued for retry","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/delivery/stream":{"get":{"tags":["Performance"],"operationId":"streamDeliveries","description":"Streams payload-free delivery state and remote acknowledgement receipts.","responses":{"200":{"description":"Live delivery state stream","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/v1/nous/intelligence/spatiotemporal/materialize":{"post":{"tags":["Intelligence"],"operationId":"materializeSpatiotemporalIntelligence","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","additionalProperties":true},"configuration":{"type":"object","additionalProperties":true},"consent":{"type":["object","null"],"additionalProperties":true},"access":{"type":["object","null"],"additionalProperties":true}},"additionalProperties":false}}}},"responses":{"201":{"description":"Calculated intelligence materialized with evidence relationships","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs":{"get":{"tags":["Intelligence"],"operationId":"listSpatiotemporalIntelligenceJobs","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"createSpatiotemporalIntelligenceJob","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pageSize":{"type":"integer","minimum":100,"maximum":10000,"default":2000},"accessScope":{"type":"string","enum":["all-authorized","public","personal","organization"],"default":"all-authorized","description":"Controls which authorized evidence can be measured; independent from result visibility."},"visibility":{"type":"string","enum":["private","public"],"default":"private"},"consent":{"type":"object","properties":{"publish":{"type":"boolean"},"publicDiscovery":{"type":"boolean"}},"additionalProperties":false},"query":{"type":"object","additionalProperties":true},"configuration":{"type":"object","additionalProperties":true}},"additionalProperties":false}}}},"responses":{"202":{"description":"Snapshot-bounded resumable analysis job accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}":{"get":{"tags":["Intelligence"],"operationId":"getSpatiotemporalIntelligenceJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}/resume":{"post":{"tags":["Intelligence"],"operationId":"resumeSpatiotemporalIntelligenceJob","security":[{"bearerAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Job resume accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}/incremental":{"post":{"tags":["Intelligence"],"operationId":"advanceSpatiotemporalIntelligenceJob","description":"Creates a new immutable intelligence version by scanning only graph records appended after the completed base job checkpoint. Returns unchanged when no new graph range exists.","security":[{"bearerAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Change-only intelligence update accepted","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}/result":{"get":{"tags":["Intelligence"],"operationId":"getSpatiotemporalIntelligenceResult","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}/materialize":{"post":{"tags":["Intelligence"],"operationId":"materializePartitionedSpatiotemporalIntelligence","security":[{"bearerAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Analysis and partition lineage permanently materialized into NOUS","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/jobs/{jobId}/evidence":{"get":{"tags":["Intelligence"],"operationId":"pageSpatiotemporalBucketEvidence","description":"Exact evidence receipts remain restricted to their authorized owner or organization even when derived intelligence is public.","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}},{"name":"bucketId","in":"query","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions":{"get":{"tags":["Intelligence"],"operationId":"listContinuousIntelligenceSubscriptions","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}},"post":{"tags":["Intelligence"],"operationId":"createContinuousIntelligenceSubscription","description":"Creates a durable, permission-bound background subscription from a completed intelligence checkpoint.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["baseJobId"],"properties":{"baseJobId":{"type":"string"},"intervalSeconds":{"type":"integer","minimum":5,"maximum":86400,"default":30}},"additionalProperties":false}}}},"responses":{"201":{"description":"Continuous intelligence subscription created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/status":{"get":{"tags":["Intelligence"],"operationId":"getContinuousIntelligenceStatus","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}":{"get":{"tags":["Intelligence"],"operationId":"getContinuousIntelligenceSubscription","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}/run":{"post":{"tags":["Intelligence"],"operationId":"runContinuousIntelligenceSubscription","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}/pause":{"post":{"tags":["Intelligence"],"operationId":"pauseContinuousIntelligenceSubscription","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}/resume":{"post":{"tags":["Intelligence"],"operationId":"resumeContinuousIntelligenceSubscription","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}/runs":{"get":{"tags":["Intelligence"],"operationId":"listContinuousIntelligenceRuns","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/nous/intelligence/subscriptions/{subscriptionId}/stream":{"get":{"tags":["Intelligence"],"operationId":"streamContinuousIntelligenceSubscription","description":"Server-sent subscription updates for near-real-time NOUS visualization refresh.","security":[{"bearerAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Live subscription event stream","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/v1/sync/batch":{"post":{"tags":["Synchronization"],"operationId":"synchronizeBatch","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/interoperability/sensorthings":{"post":{"tags":["Interoperability"],"operationId":"exportSensorThingsObservation","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}},"/v1/interoperability/fhir":{"post":{"tags":["Interoperability"],"operationId":"exportFhirObservation","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}},"403":{"description":"Source, device, consent, or access policy rejected the request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"requestId":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque OMNIA API token"}},"schemas":{"UniversalObservationIngress":{"type":"object","required":["sourceId","modality","observations"],"properties":{"ingestionId":{"type":"string","description":"Client-generated stable identifier for idempotency."},"sourceId":{"type":"string"},"deviceId":{"type":["string","null"]},"modality":{"type":"string","examples":["sensor","environment","physiology","audio","light"]},"capturedAt":{"type":"string","format":"date-time"},"adapterId":{"type":["string","null"]},"adapterVersion":{"type":["string","null"]},"externalSchema":{"type":["string","null"]},"observations":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","required":["quantityKind","value","unit"],"properties":{"observationId":{"type":"string"},"evidenceClass":{"type":"string","enum":["observed_physical","derived_signal","inferred_expression","interpretive_mapping"],"default":"observed_physical"},"quantityKind":{"type":"string","minLength":1},"value":{"oneOf":[{"type":"number"},{"type":"array","items":{"type":"number"}}]},"unit":{"type":"string","description":"UCUM-compatible unit, for example Hz, m/s2, Cel, Pa, V, nm, /min, or 1."},"observedAt":{"type":"string","format":"date-time"},"durationSeconds":{"type":"number","minimum":0},"confidence":{"type":"number","minimum":0,"maximum":1,"default":1},"method":{"type":"string"},"methodVersion":{"type":"string"},"sensor":{"type":"object","additionalProperties":true},"calibration":{"type":["object","null"],"additionalProperties":true},"uncertainty":{"type":["object","null"],"additionalProperties":true},"quality":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"calibrationRecords":{"type":"array","items":{"type":"object","additionalProperties":true}},"timing":{"type":"object","additionalProperties":true},"environment":{"type":"object","additionalProperties":true},"quality":{"type":"object","additionalProperties":true},"consent":{"type":["object","null"],"additionalProperties":true},"rawDataHash":{"type":["string","null"]},"notes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"MeasurementObservationInput":{"type":"object","required":["quantityKind","value","unit"],"properties":{"observationId":{"type":"string"},"evidenceClass":{"type":"string","enum":["observed_physical","derived_signal","inferred_expression","interpretive_mapping"],"default":"observed_physical"},"quantityKind":{"type":"string","minLength":1},"value":{"oneOf":[{"type":"number"},{"type":"array","items":{"type":"number"}}]},"unit":{"type":"string","description":"UCUM-compatible unit, for example Hz, m/s2, Cel, Pa, V, nm, /min, or 1."},"observedAt":{"type":"string","format":"date-time"},"durationSeconds":{"type":"number","minimum":0},"confidence":{"type":"number","minimum":0,"maximum":1,"default":1},"method":{"type":"string"},"methodVersion":{"type":"string"},"sensor":{"type":"object","additionalProperties":true},"calibration":{"type":["object","null"],"additionalProperties":true},"uncertainty":{"type":["object","null"],"additionalProperties":true},"quality":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":true},"PermissionBindingReceipt":{"type":"object","required":["bindingId","resourceCount","visibility","ownerBound","atomic"],"properties":{"schema":{"const":"omnia.permission-binding-receipt/v1"},"bindingId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"resourceCount":{"type":"integer","minimum":1},"policyWriteCount":{"type":"integer","minimum":0},"reusedPolicyCount":{"type":"integer","minimum":0},"visibility":{"type":"string","enum":["private","public"]},"publicDiscovery":{"type":"boolean"},"organizationShared":{"type":"boolean"},"ownerBound":{"const":true},"organizationBound":{"type":"boolean"},"atomic":{"const":true},"contentCaptured":{"const":false},"retention":{"const":"until-deleted"}},"additionalProperties":false},"DeviceRegistration":{"type":"object","required":["name","type"],"properties":{"deviceId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"manufacturer":{"type":["string","null"]},"model":{"type":["string","null"]},"serialNumber":{"type":["string","null"]},"firmware":{"type":["string","null"]},"sourceId":{"type":["string","null"]},"transport":{"type":"string","enum":["http","websocket","mqtt","ble","usb","serial","lsl","sensorthings","file","custom"]},"capabilities":{"type":"object","additionalProperties":true},"calibrationIds":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":true}}},"x-omnia-evidence-classes":["observed_physical","derived_signal","inferred_expression","interpretive_mapping"],"x-omnia-retention":"until-deleted","x-omnia-extension-policy":"New adapters translate external records into the universal ingress without changing core evidence contracts."}