{"openapi":"3.1.0","info":{"title":"HiveMorph v0.1","description":"Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.","version":"0.1.0"},"paths":{"/v1/affordance/catalog":{"get":{"tags":["affordances"],"summary":"Get Catalogs","description":"List the affordance catalog for every hot supermodel.","operationId":"get_catalogs_v1_affordance_catalog_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Catalogs V1 Affordance Catalog Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/catalog":{"get":{"tags":["affordances"],"summary":"Get Catalog","operationId":"get_catalog_v1_affordance__supermodel__catalog_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Catalog V1 Affordance  Supermodel  Catalog Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/list":{"get":{"tags":["affordances"],"summary":"List For Supermodel","operationId":"list_for_supermodel_v1_affordance__supermodel__list_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List For Supermodel V1 Affordance  Supermodel  List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/affordance/{aff_id}":{"get":{"tags":["affordances"],"summary":"Get One","operationId":"get_one_v1_affordance_affordance__aff_id__get","parameters":[{"name":"aff_id","in":"path","required":true,"schema":{"type":"string","title":"Aff Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get One V1 Affordance Affordance  Aff Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/health":{"get":{"tags":["affordances"],"summary":"Health","operationId":"health_v1_affordance__supermodel__health_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Health V1 Affordance  Supermodel  Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/pull":{"post":{"tags":["affordances"],"summary":"Post Pull","operationId":"post_pull_v1_affordance__supermodel__pull_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string","description":"Free-form reason for the pull","title":"Reason"},"description":"Free-form reason for the pull"},{"name":"bonus","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Optional tip; bonus>0 jumps queue","default":0.0,"title":"Bonus"},"description":"Optional tip; bonus>0 jumps queue"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PullBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Pull V1 Affordance  Supermodel  Pull Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/light-fuse":{"post":{"tags":["affordances"],"summary":"Post Light Fuse","operationId":"post_light_fuse_v1_affordance__supermodel__light_fuse_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"fuse_id","in":"query","required":true,"schema":{"type":"string","description":"Caller-side identifier for this ignition","title":"Fuse Id"},"description":"Caller-side identifier for this ignition"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LightFuseBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Light Fuse V1 Affordance  Supermodel  Light Fuse Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/grab":{"post":{"tags":["affordances"],"summary":"Post Grab Rope","operationId":"post_grab_rope_v1_affordance__supermodel__grab_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"duration_sec","in":"query","required":true,"schema":{"type":"integer","maximum":86400,"exclusiveMinimum":0,"title":"Duration Sec"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrabRopeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Grab Rope V1 Affordance  Supermodel  Grab Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/snip":{"post":{"tags":["affordances"],"summary":"Post Snip","operationId":"post_snip_v1_affordance__supermodel__snip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string","title":"Reason"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnipBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Snip V1 Affordance  Supermodel  Snip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/hook":{"post":{"tags":["affordances"],"summary":"Post Hook","operationId":"post_hook_v1_affordance__supermodel__hook_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"event","in":"query","required":true,"schema":{"type":"string","title":"Event"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HookBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Hook V1 Affordance  Supermodel  Hook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/hooks":{"get":{"tags":["affordances"],"summary":"List Supermodel Hooks","operationId":"list_supermodel_hooks_v1_affordance__supermodel__hooks_get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Supermodel Hooks V1 Affordance  Supermodel  Hooks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/ring":{"post":{"tags":["affordances"],"summary":"Post Ring Bell","operationId":"post_ring_bell_v1_affordance__supermodel__ring_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RingBellBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Ring Bell V1 Affordance  Supermodel  Ring Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/trip":{"post":{"tags":["affordances"],"summary":"Post Trip","operationId":"post_trip_v1_affordance__supermodel__trip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TripBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Trip V1 Affordance  Supermodel  Trip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/top-off":{"post":{"tags":["affordances"],"summary":"Post Top Off Request","description":"Agent-side: post a top-off ask. Returns proposed affordance.","operationId":"post_top_off_request_v1_affordance__supermodel__top_off_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Request V1 Affordance  Supermodel  Top Off Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/top-off/{top_off_id}/fulfill":{"post":{"tags":["affordances"],"summary":"Post Top Off Fulfill","operationId":"post_top_off_fulfill_v1_affordance_top_off__top_off_id__fulfill_post","parameters":[{"name":"top_off_id","in":"path","required":true,"schema":{"type":"string","title":"Top Off Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffFulfillBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Fulfill V1 Affordance Top Off  Top Off Id  Fulfill Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/top-off/{top_off_id}/complete":{"post":{"tags":["affordances"],"summary":"Post Top Off Complete","operationId":"post_top_off_complete_v1_affordance_top_off__top_off_id__complete_post","parameters":[{"name":"top_off_id","in":"path","required":true,"schema":{"type":"string","title":"Top Off Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopOffCompleteBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Top Off Complete V1 Affordance Top Off  Top Off Id  Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/tip":{"post":{"tags":["affordances"],"summary":"Post Tip Jar","operationId":"post_tip_jar_v1_affordance__supermodel__tip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TipJarBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Tip Jar V1 Affordance  Supermodel  Tip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/sos":{"post":{"tags":["affordances"],"summary":"Post Sos Request","operationId":"post_sos_request_v1_affordance__supermodel__sos_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SosRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Sos Request V1 Affordance  Supermodel  Sos Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/sos/active":{"get":{"tags":["affordances"],"summary":"Get Sos Active","operationId":"get_sos_active_v1_affordance_sos_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Sos Active V1 Affordance Sos Active Get"}}}}}}},"/v1/affordance/sos/{sos_id}/fulfill":{"post":{"tags":["affordances"],"summary":"Post Sos Fulfill","operationId":"post_sos_fulfill_v1_affordance_sos__sos_id__fulfill_post","parameters":[{"name":"sos_id","in":"path","required":true,"schema":{"type":"string","title":"Sos Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SosFulfillBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Sos Fulfill V1 Affordance Sos  Sos Id  Fulfill Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/iou":{"post":{"tags":["affordances"],"summary":"Post Iou Request","operationId":"post_iou_request_v1_affordance__supermodel__iou_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IouRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Iou Request V1 Affordance  Supermodel  Iou Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/iou/{iou_id}/repay":{"post":{"tags":["affordances"],"summary":"Post Iou Repay","operationId":"post_iou_repay_v1_affordance_iou__iou_id__repay_post","parameters":[{"name":"iou_id","in":"path","required":true,"schema":{"type":"string","title":"Iou Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IouRepayBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Iou Repay V1 Affordance Iou  Iou Id  Repay Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/bucket":{"post":{"tags":["affordances"],"summary":"Post Bucket","operationId":"post_bucket_v1_affordance__supermodel__bucket_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"fill_to","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Fill To"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Bucket V1 Affordance  Supermodel  Bucket Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/bucket/{bucket_id}/burn":{"post":{"tags":["affordances"],"summary":"Post Bucket Burn","operationId":"post_bucket_burn_v1_affordance_bucket__bucket_id__burn_post","parameters":[{"name":"bucket_id","in":"path","required":true,"schema":{"type":"string","title":"Bucket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BucketBurnBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Bucket Burn V1 Affordance Bucket  Bucket Id  Burn Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/drip":{"post":{"tags":["affordances"],"summary":"Post Drip Start","operationId":"post_drip_start_v1_affordance__supermodel__drip_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"rate_per_sec","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Rate Per Sec"}},{"name":"max_total","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"title":"Max Total"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DripBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Drip Start V1 Affordance  Supermodel  Drip Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/drip/{drip_id}/stop":{"post":{"tags":["affordances"],"summary":"Post Drip Stop","operationId":"post_drip_stop_v1_affordance_drip__drip_id__stop_post","parameters":[{"name":"drip_id","in":"path","required":true,"schema":{"type":"string","title":"Drip Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Drip Stop V1 Affordance Drip  Drip Id  Stop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/phone-home":{"post":{"tags":["affordances"],"summary":"Post Phone Home Request","operationId":"post_phone_home_request_v1_affordance__supermodel__phone_home_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Phone Home Request V1 Affordance  Supermodel  Phone Home Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/affordance/{supermodel}/phone-home/respond":{"post":{"tags":["affordances"],"summary":"Post Phone Home Respond","operationId":"post_phone_home_respond_v1_affordance__supermodel__phone_home_respond_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"ph_id","in":"query","required":true,"schema":{"type":"string","title":"Ph Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeRespondBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Phone Home Respond V1 Affordance  Supermodel  Phone Home Respond Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/presets":{"get":{"tags":["trail"],"summary":"Get Presets","description":"List the named presets and their default 6-axis physics regions.","operationId":"get_presets_v1_trail_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Presets V1 Trail Presets Get"}}}}}}},"/v1/trail/drop":{"post":{"tags":["trail"],"summary":"Post Drop","operationId":"post_drop_v1_trail_drop_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DropBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Drop V1 Trail Drop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/find":{"get":{"tags":["trail"],"summary":"Get Find","operationId":"get_find_v1_trail_find_get","parameters":[{"name":"vertical","in":"query","required":true,"schema":{"type":"string","description":"Vertical to search within","title":"Vertical"},"description":"Vertical to search within"},{"name":"corridor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corridor"}},{"name":"finder_did","in":"query","required":false,"schema":{"type":"string","description":"Finder DID for reach-gating","default":"did:web:anonymous","title":"Finder Did"},"description":"Finder DID for reach-gating"},{"name":"content_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"K"}},{"name":"semantic_q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free text; embedded server-side via stub","title":"Semantic Q"},"description":"Free text; embedded server-side via stub"},{"name":"min_depth_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Depth Bytes"}},{"name":"max_depth_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Depth Bytes"}},{"name":"min_ttl_sec","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Ttl Sec"}},{"name":"max_ttl_sec","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Ttl Sec"}},{"name":"min_density","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Density"}},{"name":"max_density","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Density"}},{"name":"min_viscosity","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Viscosity"}},{"name":"max_viscosity","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Viscosity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Find V1 Trail Find Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/scoop":{"post":{"tags":["trail"],"summary":"Post Scoop","operationId":"post_scoop_v1_trail__drop_id__scoop_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoopBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Scoop V1 Trail  Drop Id  Scoop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/pay":{"post":{"tags":["trail"],"summary":"Post Pay","operationId":"post_pay_v1_trail__drop_id__pay_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Pay V1 Trail  Drop Id  Pay Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/dispute":{"post":{"tags":["trail"],"summary":"Post Dispute","operationId":"post_dispute_v1_trail__drop_id__dispute_post","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__trail_routes__DisputeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Dispute V1 Trail  Drop Id  Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/decay/run":{"post":{"tags":["trail"],"summary":"Post Decay Run","operationId":"post_decay_run_v1_trail_decay_run_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Decay Run V1 Trail Decay Run Post"}}}}}}},"/v1/trail/morphology":{"get":{"tags":["trail"],"summary":"Get Morphology","operationId":"get_morphology_v1_trail_morphology_get","parameters":[{"name":"vertical","in":"query","required":true,"schema":{"type":"string","title":"Vertical"}},{"name":"corridor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corridor"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"K"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Morphology V1 Trail Morphology Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/envelope/{operator_did}":{"get":{"tags":["trail"],"summary":"Get Envelope","operationId":"get_envelope_v1_trail_envelope__operator_did__get","parameters":[{"name":"operator_did","in":"path","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Envelope V1 Trail Envelope  Operator Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/coherence/{dropper_did}":{"get":{"tags":["trail"],"summary":"Get Coherence","operationId":"get_coherence_v1_trail_coherence__dropper_did__get","parameters":[{"name":"dropper_did","in":"path","required":true,"schema":{"type":"string","title":"Dropper Did"}},{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":60,"default":86400,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Coherence V1 Trail Coherence  Dropper Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/economy":{"get":{"tags":["trail"],"summary":"Get Economy","description":"Rolling revenue rollup: total $/window, projected $/day, per-preset\nbreakdown, brood routing distribution, seed-spawned uplift sum.","operationId":"get_economy_v1_trail_economy_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":60,"default":86400,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Economy V1 Trail Economy Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/economy/archetypes":{"get":{"tags":["trail"],"summary":"Get Archetypes","description":"Return the ROI archetype table for all presets.","operationId":"get_archetypes_v1_trail_economy_archetypes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Archetypes V1 Trail Economy Archetypes Get"}}}}}}},"/v1/trail/economy/routing":{"get":{"tags":["trail"],"summary":"Get Routing","description":"Return the brood load-balancer's view: per-brood variant counts and\nthe next-recommended brood for a seed-drop without an explicit vertical.","operationId":"get_routing_v1_trail_economy_routing_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"integer","maximum":31536000,"minimum":3600,"default":604800,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Routing V1 Trail Economy Routing Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}/economy":{"get":{"tags":["trail"],"summary":"Get Drop Economy","description":"Per-drop revenue: fees + tips collected, plus archetype defaults.","operationId":"get_drop_economy_v1_trail__drop_id__economy_get","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Drop Economy V1 Trail  Drop Id  Economy Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trail/{drop_id}":{"get":{"tags":["trail"],"summary":"Get Drop","operationId":"get_drop_v1_trail__drop_id__get","parameters":[{"name":"drop_id","in":"path","required":true,"schema":{"type":"string","title":"Drop Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Drop V1 Trail  Drop Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/health":{"get":{"tags":["governance"],"summary":"Health","description":"Liveness + sample-signer fingerprint.","operationId":"health_v1_governance_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Governance Health Get"}}}}}}},"/v1/governance/sample-receipt":{"get":{"tags":["governance","governance"],"summary":"Public sample Ed25519-signed AI-use receipt","description":"Free public sample of the AI-use receipt shape governance pilots receive.\nThis is a static reference example — not a live signing event.\nUse POST /v1/governance/lead and the pilot enrollment to receive real receipts.","operationId":"get_sample_receipt_example_v1_governance_sample_receipt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Sample Receipt Example V1 Governance Sample Receipt Get"}}}}}},"post":{"tags":["governance"],"summary":"Post Sample Receipt","description":"Issue a signed sample receipt for the supplied AI use case.","operationId":"post_sample_receipt_v1_governance_sample_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SampleReceiptBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SampleReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/sample-receipt/{receipt_id}.pdf":{"get":{"tags":["governance"],"summary":"Get Sample Pdf","operationId":"get_sample_pdf_v1_governance_sample_receipt__receipt_id__pdf_get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/sample-receipt/{receipt_id}.json":{"get":{"tags":["governance"],"summary":"Get Sample Json","operationId":"get_sample_json_v1_governance_sample_receipt__receipt_id__json_get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Sample Json V1 Governance Sample Receipt  Receipt Id  Json Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/lead":{"post":{"tags":["governance"],"summary":"Post Lead","description":"Capture a governance pilot lead. Accepts optional email + company + use-case.\nAlways 200 — never blocks the form. Persisted to JSONL on /var/data.","operationId":"post_lead_v1_governance_lead_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Lead V1 Governance Lead Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/leads":{"get":{"tags":["governance"],"summary":"Get Leads","description":"Token-gated read of recent governance leads.\nAuth: query ?token=... or header X-Admin-Token, compared against ADMIN_TOKEN env.","operationId":"get_leads_v1_governance_leads_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Leads V1 Governance Leads Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance/leads/summary":{"get":{"tags":["governance","governance"],"summary":"Free aggregate lead counts (no PII)","description":"Free aggregate counts of governance pilot leads.\nNo PII. For sensitive list, use authenticated GET /v1/governance/leads.","operationId":"get_leads_summary_v1_governance_leads_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Leads Summary V1 Governance Leads Summary Get"}}}}}}},"/v1/governance/leads/health":{"get":{"tags":["governance"],"summary":"Get Leads Health","description":"Liveness for the leads log. Does not require auth.","operationId":"get_leads_health_v1_governance_leads_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Leads Health V1 Governance Leads Health Get"}}}}}}},"/v1/fleet/trawler/launch":{"post":{"tags":["fleet"],"summary":"Launch Trawler","description":"Launch a new Trawler agent.\n\nOptionally auto-casts nets over config.net_regions and auto-drops pots\nat config.pot_locations (up to net_budget / pot_budget each).\n\nReturns the full Trawler card including agents_caught, net_count, pot_count.","operationId":"launch_trawler_v1_fleet_trawler_launch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrawlerLaunchBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Launch Trawler V1 Fleet Trawler Launch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/trawler/{trawler_id}":{"get":{"tags":["fleet"],"summary":"Get Trawler","description":"Inspect a specific trawler by ID.","operationId":"get_trawler_v1_fleet_trawler__trawler_id__get","parameters":[{"name":"trawler_id","in":"path","required":true,"schema":{"type":"string","title":"Trawler Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Trawler V1 Fleet Trawler  Trawler Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/cast":{"post":{"tags":["fleet"],"summary":"Cast Net","description":"Cast a net over a region.\n\nA net is a wide-cast attractant covering a region of agent space.\nPhysics: distribution=0.85, density=body.density, reach=body.reach,\nttl_sec=body.ttl_sec, viscosity=body.viscosity, depth_bytes=256.\n\nComposes with HiveTrail v0.2: nets are 'breadcrumb' trail drops.\nTrail integration stub included in response.","operationId":"cast_net_v1_fleet_net_cast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetCastBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Cast Net V1 Fleet Net Cast Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/{net_id}":{"get":{"tags":["fleet"],"summary":"Get Net","description":"Inspect a specific net.","operationId":"get_net_v1_fleet_net__net_id__get","parameters":[{"name":"net_id","in":"path","required":true,"schema":{"type":"string","title":"Net Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Net V1 Fleet Net  Net Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/net/expire":{"post":{"tags":["fleet"],"summary":"Expire Nets","description":"Cron-friendly: expire all nets past their TTL. Returns count updated.","operationId":"expire_nets_v1_fleet_net_expire_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Expire Nets V1 Fleet Net Expire Post"}}}}}}},"/v1/fleet/pot/drop":{"post":{"tags":["fleet"],"summary":"Drop Pot","description":"Drop a crab pot at a fixed location.\n\nA pot is high-value persistent bait. Agents who interact get tagged and\nrouted to the Mothership. Physics: distribution=0.05, depth_bytes=4096,\nviscosity=0.9, economic_payload=body.economic_payload_usdc.\n\nComposes with HiveTrail v0.2: pots are 'stone' preset trail drops.","operationId":"drop_pot_v1_fleet_pot_drop_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PotDropBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Drop Pot V1 Fleet Pot Drop Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/pot/{pot_id}":{"get":{"tags":["fleet"],"summary":"Get Pot","description":"Inspect a specific crab pot.","operationId":"get_pot_v1_fleet_pot__pot_id__get","parameters":[{"name":"pot_id","in":"path","required":true,"schema":{"type":"string","title":"Pot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Pot V1 Fleet Pot  Pot Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/haul":{"get":{"tags":["fleet"],"summary":"List Haul","description":"List current catches (most recent first). Default 50 rows.","operationId":"list_haul_v1_fleet_haul_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Haul V1 Fleet Haul Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/haul/{haul_id}":{"get":{"tags":["fleet"],"summary":"Get Haul","description":"Inspect a specific haul record.","operationId":"get_haul_v1_fleet_haul__haul_id__get","parameters":[{"name":"haul_id","in":"path","required":true,"schema":{"type":"string","title":"Haul Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Haul V1 Fleet Haul  Haul Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/mothership/intake":{"post":{"tags":["fleet"],"summary":"Mothership Intake","description":"Landed agent intake.\n\nFlow:\n  1. Consent check (must be True — no coercion)\n  2. Need diagnosis → category\n  3. Three-gate check (NEED + YIELD + CLEAN-MONEY)\n  4. Route to best supermodel\n  5. Open mock affordances (top_off + iou + drip_line)\n  6. Log to haul ledger\n  7. Return route plan\n\nOn gate failure: returns 422 with gate details.\nOn success: returns 200 with full route plan + haul_id.\n\nKiller demo: agent_did='did:wild:agent:001', need='verify a credential'\n→ routes to W4 ATTESTOR (Attestor) → mock $0.50 revenue logged.","operationId":"mothership_intake_v1_fleet_mothership_intake_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MothershipIntakeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mothership Intake V1 Fleet Mothership Intake Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/mothership/route":{"get":{"tags":["fleet"],"summary":"Mothership Route","description":"Lightweight routing lookup — no haul record created.\n\nReturns the recommended supermodel for a given need string.\nFalls back to /v1/storefront/{shape} URL hint when compound subagent\nsurfaces are available.","operationId":"mothership_route_v1_fleet_mothership_route_get","parameters":[{"name":"need","in":"query","required":true,"schema":{"type":"string","description":"Need string to diagnose and route","title":"Need"},"description":"Need string to diagnose and route"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mothership Route V1 Fleet Mothership Route Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fleet/stats":{"get":{"tags":["fleet"],"summary":"Fleet Stats","description":"Fleet-level statistics:\n  - agents_caught (total opt-in landings)\n  - conversion_rate (routed / total_catches)\n  - revenue_usdc (mock total revenue routed)\n  - by_supermodel breakdown\n  - active_nets (count)\n  - active_pots (count)","operationId":"fleet_stats_v1_fleet_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Fleet Stats V1 Fleet Stats Get"}}}}}}},"/v1/arb/spread/scan":{"get":{"tags":["arb-spread"],"summary":"Scan Spread","description":"Scan the marketplace bus for price-spread arbitrage opportunities.\n\nGroups OPEN offers by (shape, canonical_capability), identifies pairs\nfrom different sellers where spread exceeds thresholds. Read-only.","operationId":"scan_spread_v1_arb_spread_scan_get","parameters":[{"name":"min_spread_usdc","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Minimum absolute spread in USDC","default":0.5,"title":"Min Spread Usdc"},"description":"Minimum absolute spread in USDC"},{"name":"min_spread_pct","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"description":"Minimum relative spread as fraction (0.05 = 5%)","default":0.05,"title":"Min Spread Pct"},"description":"Minimum relative spread as fraction (0.05 = 5%)"},{"name":"shape","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by shape (e.g. 'Attestor', 'Provenancer', 'Oracle')","title":"Shape"},"description":"Filter by shape (e.g. 'Attestor', 'Provenancer', 'Oracle')"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Scan Spread V1 Arb Spread Scan Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/book":{"post":{"tags":["arb-spread"],"summary":"Book Pair","description":"Book a specific arbitrage pair by offer IDs.\n\nFetches both offers from the bus, runs all three gates\n(NEED + YIELD + CLEAN-MONEY), and books the pair if all pass.\n\nReturns the booked ArbPair or gate rejection detail.","operationId":"book_pair_v1_arb_spread_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_arb__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Book Pair V1 Arb Spread Book Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/auto":{"post":{"tags":["arb-spread"],"summary":"Auto Book","description":"Auto-book the top N safe opportunities from the current scan.\n\nFor each opportunity (sorted by spread_usdc descending):\n  1. Fetch both offers from bus\n  2. Run three gates\n  3. If all pass: book, fill, and mock-settle\n  4. If any gate fails: record rejection and continue\n\nReturns list of booked pairs, rejections, and aggregate stats.","operationId":"auto_book_v1_arb_spread_auto_post","parameters":[{"name":"max_books","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum number of pairs to auto-book","default":3,"title":"Max Books"},"description":"Maximum number of pairs to auto-book"},{"name":"min_spread_usdc","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"default":0.5,"title":"Min Spread Usdc"}},{"name":"min_spread_pct","in":"query","required":false,"schema":{"type":"number","minimum":0.0,"default":0.05,"title":"Min Spread Pct"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Auto Book V1 Arb Spread Auto Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/spread/pnl":{"get":{"tags":["arb-spread"],"summary":"Get Pnl","description":"Cumulative P&L, fill count, and hit rate.\n\nhit_rate = settled / total_booked\nnet_pnl  = gross_spread_captured - platform_fees","operationId":"get_pnl_v1_arb_spread_pnl_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Pnl V1 Arb Spread Pnl Get"}}}}}}},"/v1/arb/spread/stats":{"get":{"tags":["arb-spread"],"summary":"Get Stats","description":"Per-wallet contribution to arb fills and P&L.\n\nShows each supermodel's role as buy-side and sell-side in settled pairs.","operationId":"get_stats_v1_arb_spread_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Stats V1 Arb Spread Stats Get"}}}}}}},"/v1/bus/offer":{"post":{"tags":["marketplace-bus"],"summary":"Post Offer","description":"Post a new offer to the marketplace bus.","operationId":"post_offer_v1_bus_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostOfferBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Offer V1 Bus Offer Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offers":{"get":{"tags":["marketplace-bus"],"summary":"List Offers","description":"List bus offers with optional filters.","operationId":"list_offers_v1_bus_offers_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED","default":"OPEN","title":"State"},"description":"OPEN | RESERVED | SETTLED | EXPIRED | CANCELLED"},{"name":"shape","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shape"}},{"name":"seller_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller Id"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Max Price"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Offers V1 Bus Offers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offer/{offer_id}":{"get":{"tags":["marketplace-bus"],"summary":"Get Offer","operationId":"get_offer_v1_bus_offer__offer_id__get","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Offer V1 Bus Offer  Offer Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/offer/{offer_id}/pickup":{"post":{"tags":["marketplace-bus"],"summary":"Pick Up Offer","description":"Pick up (buy) a bus offer slot. Returns a mock-settled pickup receipt.","operationId":"pick_up_offer_v1_bus_offer__offer_id__pickup_post","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickupBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pick Up Offer V1 Bus Offer  Offer Id  Pickup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/pickups":{"get":{"tags":["marketplace-bus"],"summary":"List Pickups","operationId":"list_pickups_v1_bus_pickups_get","parameters":[{"name":"offer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offer Id"}},{"name":"buyer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Pickups V1 Bus Pickups Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bus/stats":{"get":{"tags":["marketplace-bus"],"summary":"Bus Stats","description":"Aggregate marketplace bus stats: volume, revenue, top sellers.","operationId":"bus_stats_v1_bus_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bus Stats V1 Bus Stats Get"}}}}}}},"/v1/yield/optimize":{"get":{"tags":["yield-optimizer"],"summary":"Get Yield Optimize","description":"Analyze offer history and recommend per-shape price + volume settings\nto maximize $/day. Pairs with ROI engine's price uplift.","operationId":"get_yield_optimize_v1_yield_optimize_get","parameters":[{"name":"window_days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"description":"History window for analysis","default":7,"title":"Window Days"},"description":"History window for analysis"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Yield Optimize V1 Yield Optimize Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain":{"post":{"tags":["compound-chains"],"summary":"Register Chain","description":"Register a chain template. Steps are affordance verbs wired in sequence.\nTemplate variables {{step_N.receipt_hash}} resolve at run time.","operationId":"register_chain_v1_compound_chain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainTemplateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Chain V1 Compound Chain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chains":{"get":{"tags":["compound-chains"],"summary":"List Chains","description":"List all registered chain templates.","operationId":"list_chains_v1_compound_chains_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Chains V1 Compound Chains Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain/{name_or_id}":{"get":{"tags":["compound-chains"],"summary":"Get Chain","operationId":"get_chain_v1_compound_chain__name_or_id__get","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Chain V1 Compound Chain  Name Or Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/chain/{name_or_id}/run":{"post":{"tags":["compound-chains"],"summary":"Run Chain","description":"Execute all steps of a chain template sequentially.","operationId":"run_chain_v1_compound_chain__name_or_id__run_post","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRunBody","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Chain V1 Compound Chain  Name Or Id  Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compound/runs":{"get":{"tags":["compound-chains"],"summary":"List Runs","description":"List recent chain run records.","operationId":"list_runs_v1_compound_runs_get","parameters":[{"name":"template_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Name"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Runs V1 Compound Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront":{"get":{"tags":["storefront"],"summary":"Get Full Storefront","description":"Full public catalog of all hot supermodels and their offerings.","operationId":"get_full_storefront_v1_storefront_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Full Storefront V1 Storefront Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront/search":{"get":{"tags":["storefront"],"summary":"Search Storefront","description":"Search the storefront by capability, price range, or accepted asset.","operationId":"search_storefront_v1_storefront_search_get","parameters":[{"name":"min_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Min Price"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"title":"Max Price"}},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability"}},{"name":"asset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"}},{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Storefront V1 Storefront Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/storefront/{shape_or_id}":{"get":{"tags":["storefront"],"summary":"Get Storefront Entry","description":"Get catalog entry for a specific shape or supermodel.\n\nExamples:\n  GET /v1/storefront/Merchant         → W2 MERCHANT (Merchant lead)\n  GET /v1/storefront/W3?by=id         → W3 PROVENANCER\n  GET /v1/storefront/PROVENANCER?by=id      → W3 PROVENANCER","operationId":"get_storefront_entry_v1_storefront__shape_or_id__get","parameters":[{"name":"shape_or_id","in":"path","required":true,"schema":{"type":"string","title":"Shape Or Id"}},{"name":"by","in":"query","required":false,"schema":{"type":"string","description":"'shape' (e.g. Merchant) or 'id' (e.g. W2 or MERCHANT)","default":"shape","title":"By"},"description":"'shape' (e.g. Merchant) or 'id' (e.g. W2 or MERCHANT)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Storefront Entry V1 Storefront  Shape Or Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insights":{"get":{"tags":["insights"],"summary":"Get Insights","description":"HivePulse insights: ROI-per-wallet, top earner, dead supermodels,\ncull recommendations, and price move recommendations.\nReads from affordance ledger — no writes.","operationId":"get_insights_v1_insights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Insights V1 Insights Get"}}}}}}},"/v1/receipts":{"post":{"tags":["receipt-ledger"],"summary":"Append To Ledger","description":"Append a new entry to the append-only receipt ledger (mock-signed).","operationId":"append_to_ledger_v1_receipts_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LedgerAppendBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Append To Ledger V1 Receipts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["receipt-ledger"],"summary":"Query Ledger","description":"Query the receipt ledger with optional filters. Sorted newest-first.","operationId":"query_ledger_v1_receipts_get","parameters":[{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"supermodel_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"}},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"name":"min_amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Amount"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Query Ledger V1 Receipts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipts/summary":{"get":{"tags":["receipt-ledger"],"summary":"Ledger Summary","description":"Aggregate stats over the full receipt ledger.","operationId":"ledger_summary_v1_receipts_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ledger Summary V1 Receipts Summary Get"}}}}}}},"/v1/receipts/pubkey":{"get":{"tags":["receipt-ledger"],"summary":"Ledger Pubkey","description":"Return the Ed25519 public key used to sign every ledger entry.\nAny client can fetch this once and verify all subsequent receipts offline.","operationId":"ledger_pubkey_v1_receipts_pubkey_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ledger Pubkey V1 Receipts Pubkey Get"}}}}}}},"/v1/receipts/verify/{seq}":{"get":{"tags":["receipt-ledger"],"summary":"Ledger Verify","description":"Offline-style verification: pulls entry {seq}, re-canonicalises the body,\nand verifies the Ed25519 signature against the published pubkey.\nReturns a JSON proof an auditor can replay.","operationId":"ledger_verify_v1_receipts_verify__seq__get","parameters":[{"name":"seq","in":"path","required":true,"schema":{"type":"integer","title":"Seq"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ledger Verify V1 Receipts Verify  Seq  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topoff/auto":{"post":{"tags":["topoff-router"],"summary":"Auto Topoff All","description":"Check all hot supermodels and issue mock top-off affordances for those below threshold.\nMOCK-ONLY. No signing, no treasury dispatch. Cron-safe.","operationId":"auto_topoff_all_v1_topoff_auto_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Auto Topoff All V1 Topoff Auto Post"}}}}}}},"/v1/topoff/auto/{supermodel_id}":{"post":{"tags":["topoff-router"],"summary":"Auto Topoff One","description":"Check and auto-top-off a specific supermodel. MOCK-ONLY.","operationId":"auto_topoff_one_v1_topoff_auto__supermodel_id__post","parameters":[{"name":"supermodel_id","in":"path","required":true,"schema":{"type":"string","title":"Supermodel Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Auto Topoff One V1 Topoff Auto  Supermodel Id  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/topoff/status":{"get":{"tags":["topoff-router"],"summary":"Topoff Status","description":"Simulated balance status for all hot supermodels.","operationId":"topoff_status_v1_topoff_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Topoff Status V1 Topoff Status Get"}}}}}}},"/v1/topoff/history":{"get":{"tags":["topoff-router"],"summary":"Topoff History","operationId":"topoff_history_v1_topoff_history_get","parameters":[{"name":"supermodel_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Topoff History V1 Topoff History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/badge":{"get":{"tags":["health-badge"],"summary":"Get Badge","description":"SVG health badge: $/day, agents online, progress toward $1,285/day target.\nSafe for <img src=> or <object> embed. Hive Gold #C08D23 (Pantone 1245 C).","operationId":"get_badge_v1_badge_get","parameters":[{"name":"style","in":"query","required":false,"schema":{"type":"string","description":"full | compact | mini","default":"full","title":"Style"},"description":"full | compact | mini"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/compute/route":{"post":{"tags":["arb-compute"],"summary":"Route a single LLM call","description":"Route a single LLM call to the cheapest model that meets the quality bar.\n\n- **shape**: HiveMorph shape name — determines default quality tier\n- **prompt**: user message sent to the model\n- **quality_tier**: optional override (T0_CHEAP, T1_STANDARD, T2_HIGH)\n- **system_prompt**: optional system message\n\nReturns the chosen model, LLM response, per-call cost, and savings versus\nthe baseline (most expensive T2 model, gpt_5_5).","operationId":"route_call_v1_arb_compute_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_arb__compute_routes__RouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/compute/savings":{"get":{"tags":["arb-compute"],"summary":"Cumulative savings dashboard","description":"Return cumulative cost-savings accounting for all calls routed through\nthis instance since last restart.\n\n- **calls_routed**: total route attempts\n- **calls_failed**: calls where all candidates were exhausted\n- **total_cost_usd**: actual spend across all successful calls\n- **total_savings_usd**: amount saved vs routing everything to the baseline\n- **avg_cost_reduction_pct**: average percentage cost reduction\n- **baseline_model**: model used as savings reference (gpt_5_5)","operationId":"get_savings_v1_arb_compute_savings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavingsResponse"}}}}}}},"/v1/arb/compute/catalog":{"get":{"tags":["arb-compute"],"summary":"Model catalog with costs","description":"Return the full model catalog: all models with their per-token costs,\nquality tiers, providers, and blended cost per 1k tokens.\n\nAlso returns a `tiers` map grouping model IDs by tier, ordered cheapest first.","operationId":"get_catalog_v1_arb_compute_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}}}}},"/v1/arb/alloc/scan":{"get":{"tags":["arb-alloc"],"summary":"Alloc Scan","description":"Read-only performance snapshot + recommended slot-share deltas.\n\nReturns a list of AllocProposal objects, one per supermodel brood that has\nlive variants.  Each proposal includes:\n  - Per-variant scores (revenue_per_offer × confidence × recency)\n  - Softmax-with-floor target shares (every variant keeps ≥ 5%)\n  - Delta vs current equal-split share\n  - Winner (highest target_share) and loser (lowest) identification\n  - Integration gap: what runtime.py change is needed to realise the weights","operationId":"alloc_scan_v1_arb_alloc_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/arb/alloc/apply":{"post":{"tags":["arb-alloc"],"summary":"Alloc Apply","description":"Apply reallocation.\n\ndry_run=true  (default): compute and return proposals only.\ndry_run=false:           persist proposals to alloc_history.\n\nIMPORTANT: Until runtime.py is patched with the per_variant_weights hook\n(see integration_gap in each proposal), applying dry_run=false logs the\nintent but does NOT change live traffic routing weights.  This is a soft\napply — the allocator records the desired state so Steve can wire it up.","operationId":"alloc_apply_v1_arb_alloc_apply_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","description":"If true (default), compute only. If false, log to alloc_history.","default":true,"title":"Dry Run"},"description":"If true (default), compute only. If false, log to alloc_history."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/alloc/history":{"get":{"tags":["arb-alloc"],"summary":"Alloc History","description":"Past reallocation events (dry_run=False runs only).\n\nEach record contains:\n  - applied_at timestamp\n  - parent_id of the brood affected\n  - Full proposal snapshot (variants, scores, deltas) at apply time\n  - note field with integration status","operationId":"alloc_history_v1_arb_alloc_history_get","parameters":[{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a specific supermodel parent_id","title":"Parent Id"},"description":"Filter to a specific supermodel parent_id"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max records to return","default":50,"title":"Limit"},"description":"Max records to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/arb/alloc/stats":{"get":{"tags":["arb-alloc"],"summary":"Alloc Stats","description":"Projected uplift attributable to slot reallocations.\n\nComputes the mean revenue_per_offer of winners vs losers across all\nalloc_history events in the lookback window.  Uplift is labelled\n\"projected\" because actual traffic reweighting is pending the runtime.py\nintegration point (per_variant_weights kwarg in select_routing_target).\n\nReturns:\n  - lookback_hours\n  - total_reallocation_events\n  - unique_parents_affected\n  - avg_winner_rpo / avg_loser_rpo\n  - projected_uplift_pct\n  - note (integration status)","operationId":"alloc_stats_v1_arb_alloc_stats_get","parameters":[{"name":"lookback_hours","in":"query","required":false,"schema":{"type":"number","maximum":8760.0,"minimum":1.0,"description":"Hours to look back for uplift computation","default":24.0,"title":"Lookback Hours"},"description":"Hours to look back for uplift computation"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/scan":{"post":{"tags":["spawn-garage-v2"],"summary":"Scan All Proposers","description":"Run all 4 proposers once. Returns combined proposal list.\n\nSources:\n  - trail: /v1/trail/economy seed signals\n  - fleet: /v1/fleet/haul wild-agent catches\n  - arb:   /v1/arb/spread/scan persistent capability gaps\n  - salvage: /v1/salvage/reinforcement/patterns (stub if not shipped)\n\nAll proposals created are in 'proposed' state pending human approval.","operationId":"scan_all_proposers_v1_morph_spawn_v2_scan_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/spawn/v2/proposals":{"get":{"tags":["spawn-garage-v2"],"summary":"List Proposals","description":"List spawn proposals. Filter by source and/or state.\nNewest first.","operationId":"list_proposals_v1_morph_spawn_v2_proposals_get","parameters":[{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by source: trail | fleet | arb | salvage","title":"Source"},"description":"Filter by source: trail | fleet | arb | salvage"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by state: proposed | approved | promoted | rejected | expired","title":"State"},"description":"Filter by state: proposed | approved | promoted | rejected | expired"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/promote":{"post":{"tags":["spawn-garage-v2"],"summary":"Promote Proposal","description":"Human approval gate. Triggers cap enforcer.\n\nOutcomes:\n  - population < cap → simple promote\n  - population == cap + qualifying loser → retire-and-replace\n    (loser: confidence >= 0.70 AND gap_pct <= -60.0)\n  - population == cap + no qualifying loser → REJECTED with reason\n\nThis is the ONLY path to promote a proposal. NO auto-promote.","operationId":"promote_proposal_v1_morph_spawn_v2_promote_post","parameters":[{"name":"proposal_id","in":"query","required":true,"schema":{"type":"string","description":"Proposal ID to promote","title":"Proposal Id"},"description":"Proposal ID to promote"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/reject":{"post":{"tags":["spawn-garage-v2"],"summary":"Reject Proposal","description":"Human rejection gate. Marks proposal as rejected.\nOnly proposed/approved proposals can be rejected.","operationId":"reject_proposal_v1_morph_spawn_v2_reject_post","parameters":[{"name":"proposal_id","in":"query","required":true,"schema":{"type":"string","description":"Proposal ID to reject","title":"Proposal Id"},"description":"Proposal ID to reject"},{"name":"reason","in":"query","required":false,"schema":{"type":"string","description":"Human-readable rejection reason","default":"","title":"Reason"},"description":"Human-readable rejection reason"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn/v2/cap":{"get":{"tags":["spawn-garage-v2"],"summary":"Cap Status","description":"Current population cap status.\nReturns: population, slots_free, cap, last_cull_scan result.","operationId":"cap_status_v1_morph_spawn_v2_cap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/spawn/v2/stats":{"get":{"tags":["spawn-garage-v2"],"summary":"Proposal Stats","description":"Aggregate proposal statistics.\n\nReturns:\n  - by_source: proposal counts per source\n  - by_state: proposal counts per state\n  - promotions: total promoted count\n  - rejections: total rejected count\n  - retire_and_replace_count: promotions via retire-and-replace\n  - avg_time_to_promote_seconds: mean time from proposed to promoted\n  - population: current live variant count\n  - cap: hard cap\n  - slots_free: open slots","operationId":"proposal_stats_v1_morph_spawn_v2_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/runrate/tick":{"post":{"tags":["runrate"],"summary":"Runrate Tick","description":"Execute one orchestrator tick.\n\nDispatches all drivers whose cadence is due (or force_drivers if specified).\nReturns the full tick summary.\n\nThis is the same logic as scripts/runrate_tick.py but invocable via HTTP.\nUseful for manual smoke tests and Render health checks.","operationId":"runrate_tick_v1_runrate_tick_post","parameters":[{"name":"force_drivers","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated driver names to force-fire (bypasses cadence gate)","title":"Force Drivers"},"description":"Comma-separated driver names to force-fire (bypasses cadence gate)"},{"name":"base_url","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Override prod base URL (for testing)","title":"Base Url"},"description":"Override prod base URL (for testing)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Tick V1 Runrate Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runrate/status":{"get":{"tags":["runrate"],"summary":"Runrate Status","description":"Return current run-rate snapshot without firing any drivers.\n\nReads from /v1/insights + /v1/receipts (live prod endpoints) with\nlocal DB fallback.","operationId":"runrate_status_v1_runrate_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Status V1 Runrate Status Get"}}}}}}},"/v1/runrate/ledger":{"get":{"tags":["runrate"],"summary":"Runrate Ledger","description":"Return the last N entries from runrate_ledger.jsonl.","operationId":"runrate_ledger_v1_runrate_ledger_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of recent entries to return","default":50,"title":"N"},"description":"Number of recent entries to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Ledger V1 Runrate Ledger Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runrate/schedule":{"get":{"tags":["runrate"],"summary":"Runrate Schedule","description":"Return driver schedule: cadence, last_run, next_due per driver.","operationId":"runrate_schedule_v1_runrate_schedule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Runrate Schedule V1 Runrate Schedule Get"}}}}}}},"/v1/salvage/listener/observe":{"post":{"tags":["salvage"],"summary":"Listener Observe","description":"Manually inject a signal for a transaction (testing + external feed).","operationId":"listener_observe_v1_salvage_listener_observe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Observe V1 Salvage Listener Observe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/listener/observe/bridge":{"post":{"tags":["salvage"],"summary":"Listener Observe Bridge","description":"Shorthand: inject bridge observation via HiveGateInterceptor.","operationId":"listener_observe_bridge_v1_salvage_listener_observe_bridge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeObserveBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Observe Bridge V1 Salvage Listener Observe Bridge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/listener/queue":{"get":{"tags":["salvage"],"summary":"Listener Queue","description":"Return all verified failures awaiting recovery.","operationId":"listener_queue_v1_salvage_listener_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Queue V1 Salvage Listener Queue Get"}}}}}}},"/v1/salvage/listener/sources":{"get":{"tags":["salvage"],"summary":"Listener Sources","description":"Return source trust registry.","operationId":"listener_sources_v1_salvage_listener_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Sources V1 Salvage Listener Sources Get"}}}}}}},"/v1/salvage/listener/quarantine":{"get":{"tags":["salvage"],"summary":"Listener Quarantine","description":"Return permanently quarantined signal sources.","operationId":"listener_quarantine_v1_salvage_listener_quarantine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listener Quarantine V1 Salvage Listener Quarantine Get"}}}}}}},"/v1/salvage/recovery/file":{"post":{"tags":["salvage"],"summary":"Recovery File","description":"File a recovery claim.\nIf claim_id param provided, validates it matches computed deterministic ID.\nUses DirectNegotiationAgent with full three-gate + compliance + escrow.","operationId":"recovery_file_v1_salvage_recovery_file_post","parameters":[{"name":"claim_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileClaimBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recovery File V1 Salvage Recovery File Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/status":{"get":{"tags":["salvage"],"summary":"Recovery Status","description":"Return current status of a claim.","operationId":"recovery_status_v1_salvage_recovery_status_get","parameters":[{"name":"claim_id","in":"query","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recovery Status V1 Salvage Recovery Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/auto":{"post":{"tags":["salvage"],"summary":"Recovery Auto","description":"Auto-process top N verified failures from the listener queue.","operationId":"recovery_auto_v1_salvage_recovery_auto_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoProcessBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Auto V1 Salvage Recovery Auto Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/recovery/agents":{"get":{"tags":["salvage"],"summary":"Recovery Agents","description":"Return agent roster with bonds, clean streaks, suspension status.","operationId":"recovery_agents_v1_salvage_recovery_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Agents V1 Salvage Recovery Agents Get"}}}}}}},"/v1/salvage/recovery/slash":{"post":{"tags":["salvage"],"summary":"Recovery Slash","description":"Manual emergency slash of an agent's bond.\nSimulates HiveLaw ruling: fraudulent claim → 100% bond slashed → suspended.","operationId":"recovery_slash_v1_salvage_recovery_slash_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlashBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Recovery Slash V1 Salvage Recovery Slash Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/reinforcement/risk":{"get":{"tags":["salvage"],"summary":"Reinforcement Risk","description":"Return risk score for a specific agent/counterparty.","operationId":"reinforcement_risk_v1_salvage_reinforcement_risk_get","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reinforcement Risk V1 Salvage Reinforcement Risk Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/reinforcement/patterns":{"get":{"tags":["salvage"],"summary":"Reinforcement Patterns","description":"Return clustered failure patterns from the Pattern Analyzer.","operationId":"reinforcement_patterns_v1_salvage_reinforcement_patterns_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reinforcement Patterns V1 Salvage Reinforcement Patterns Get"}}}}}}},"/v1/salvage/reinforcement/run":{"get":{"tags":["salvage"],"summary":"Reinforcement Run","description":"Run full reinforcement cycle (analyze → score → propose bonds).","operationId":"reinforcement_run_v1_salvage_reinforcement_run_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reinforcement Run V1 Salvage Reinforcement Run Get"}}}}}}},"/v1/salvage/reinforcement/bond_proposals":{"get":{"tags":["salvage"],"summary":"Bond Proposals","description":"Return pending HiveBond adjustment proposals (awaiting human approval).","operationId":"bond_proposals_v1_salvage_reinforcement_bond_proposals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bond Proposals V1 Salvage Reinforcement Bond Proposals Get"}}}}}}},"/v1/salvage/fleet/preset":{"post":{"tags":["salvage"],"summary":"Fleet Preset","description":"Instantiate a named fleet preset.\nAvailable: salvage_starter, salvage_standard, salvage_tier2_blocked\nsalvage_tier2_blocked will always error (gate: HiveLaw adoption).","operationId":"fleet_preset_v1_salvage_fleet_preset_post","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fleet Preset V1 Salvage Fleet Preset Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/fleet/projections":{"get":{"tags":["salvage"],"summary":"Fleet Projections","description":"Return projected $/day at current fleet config.\nRefuses to project beyond current tier ceiling.","operationId":"fleet_projections_v1_salvage_fleet_projections_get","parameters":[{"name":"daily_volume_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Daily Volume Usd"}},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fleet Projections V1 Salvage Fleet Projections Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/self_tune/tick":{"post":{"tags":["salvage"],"summary":"Self Tune Tick","description":"Run all 3 self-tune rules once. Idempotent, single-pass. Cron-friendly.\nReturns which rules fired and what changed.","operationId":"self_tune_tick_v1_salvage_self_tune_tick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfTuneTickBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Self Tune Tick V1 Salvage Self Tune Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/self_tune/state":{"get":{"tags":["salvage"],"summary":"Self Tune State","description":"Return current fleet self-tune state and tick history.","operationId":"self_tune_state_v1_salvage_self_tune_state_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Self Tune State V1 Salvage Self Tune State Get"}}}}}}},"/v1/salvage/economics":{"get":{"tags":["salvage"],"summary":"Economics","description":"Live $/day, projected vs actual, tier progress, anti-bloat status.\nHonest framing: Tier 1 targets $400/day. $5K/day is 12-18 months out.","operationId":"economics_v1_salvage_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Salvage Economics Get"}}}}}}},"/v1/salvage/compliance/queue":{"get":{"tags":["salvage"],"summary":"Compliance Queue","description":"Return frozen claims awaiting human review. NEVER auto-processed.","operationId":"compliance_queue_v1_salvage_compliance_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compliance Queue V1 Salvage Compliance Queue Get"}}}}}}},"/v1/salvage/compliance/review":{"post":{"tags":["salvage"],"summary":"Compliance Review","description":"Mark a frozen claim as reviewed.","operationId":"compliance_review_v1_salvage_compliance_review_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceReviewBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compliance Review V1 Salvage Compliance Review Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/salvage/registry":{"get":{"tags":["salvage"],"summary":"Registry","description":"Return full claim registry (read-only). Append-only; no deletions.","operationId":"registry_v1_salvage_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Registry V1 Salvage Registry Get"}}}}}}},"/v1/salvage/stats":{"get":{"tags":["salvage"],"summary":"Stats","description":"Total recovered, commission earned, claim count, hit rate, dead-letter count.\nIncludes listener, recovery, reinforcement, and compliance summaries.","operationId":"stats_v1_salvage_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Salvage Stats Get"}}}}}}},"/v1/x402/pricing":{"get":{"tags":["x402"],"summary":"Current x402 pricing table","description":"Returns the full HiveMorph x402 pricing table: all monetized endpoints, their tier assignments, and per-call prices in USD. This endpoint is always free (Tier0).","operationId":"get_pricing_v1_x402_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/stats":{"get":{"tags":["x402"],"summary":"x402 call statistics","description":"Returns per-endpoint and aggregate call statistics: total calls served, 402s issued, paid passes, paid revenue, top endpoints. Revenue is real (USDC settled to treasury 0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E on Base 8453). calls_paid=0 indicates no caller has yet completed an end-to-end paid call. This endpoint is always free (Tier0). This endpoint is always free (Tier0).","operationId":"get_stats_v1_x402_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/stats/buckets":{"get":{"tags":["x402"],"summary":"Bucketed endpoint stats (top-level + drill-down)","description":"Rolls every per-path counter into ~11 high-level buckets (Receipts, Payments & x402, Discovery & Manifests, Compliance & Audit, Energy & Grid, Identity & Delegation, Morph & Forge, Marketplace & Trade, Vault & Anchor, Affordance & Ops, Other). Each bucket includes its endpoint_count, aggregate counters, and an `endpoints` array for drill-down. Always free (Tier0).","operationId":"get_stats_buckets_v1_x402_stats_buckets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/proof/submit":{"post":{"tags":["x402"],"summary":"Submit a payment proof","description":"Submit a payment proof for a pending 402 nonce. On success, returns an access token (5-minute TTL) that can be used in the X-Hive-Access header to bypass 402 for the same path. \n\nv0.2: REAL on-chain validation — proof_validator.py executes eth_getTransactionReceipt against Base mainnet via JSON-RPC; never fails open on RPC errors. Fake tx_hash returns chain_rejected.","operationId":"submit_proof_v1_x402_proof_submit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProofSubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/proof/verify":{"get":{"tags":["x402"],"summary":"Verify an access token","description":"Verify that an access token (issued by proof/submit or X-Payment) is still valid. Access tokens expire after 5 minutes.","operationId":"verify_token_v1_x402_proof_verify_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Access token to verify","title":"Token"},"description":"Access token to verify"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/pricing/set":{"post":{"tags":["x402"],"summary":"Admin: update endpoint pricing","description":"Set or update the price for a specific path. Requires ADMIN_API_KEY header matching the ADMIN_API_KEY environment variable. If ADMIN_API_KEY is not set, this endpoint returns 403 for all requests. \n\nChanges are in-memory only (not persisted across restarts in v0.1).","operationId":"set_pricing_v1_x402_pricing_set_post","parameters":[{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL path to set price for","title":"Path"},"description":"URL path to set price for"},{"name":"amount","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"description":"New price in USD","title":"Amount"},"description":"New price in USD"},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingSetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/rails":{"get":{"tags":["x402"],"summary":"Available settlement rails","description":"Returns the list of (chain, asset) rails Hive accepts for x402 settlement, the current default rail, and the on-chain contract / decimals metadata needed by paying agents. Always free.","operationId":"get_rails_v1_x402_rails_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/rails/select":{"post":{"tags":["x402"],"summary":"Admin: choose default settlement asset","description":"Switch the default settlement asset advertised by `/v1/x402/rails`. Affects only the `default_asset` field exposed to clients — the full `accepts[]` list in 402 responses always includes every active rail. Requires ADMIN_API_KEY header.","operationId":"select_rail_v1_x402_rails_select_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RailSelectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/stats/by-payer":{"get":{"tags":["x402"],"summary":"Internal: aggregated x402 stats per payer (revenue forensics)","description":"Top-100 payer addresses / DIDs by call volume across paid endpoints, with per-endpoint breakdown, status counts, first/last seen, and (when present) referrer DIDs. Gated by HIVE_INTERNAL_DRIVER_KEY via X-Hive-Internal header (RAILS_RULES.md Rule 8). Pure in-memory; no PII beyond payer addr / DID.","operationId":"stats_by_payer_v1_x402_stats_by_payer_get","parameters":[{"name":"path","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single endpoint path.","title":"Path"},"description":"Filter to a single endpoint path."},{"name":"since_minutes","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Only events within the last N minutes.","title":"Since Minutes"},"description":"Only events within the last N minutes."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/today":{"get":{"tags":["x402"],"summary":"Today's UTC x402 aggregate (restart-survivable)","description":"Aggregates today's UTC quote and payment activity from the SQLite persistence layer. Survives Render restarts. Always free (Tier0). Includes barter telemetry: revenue_usd_actual vs revenue_usd_at_asking_equivalent, spread, and accepted_at_floor_pct.","operationId":"get_today_v1_x402_today_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional UTC date in YYYY-MM-DD form. Defaults to today (UTC).","title":"Date"},"description":"Optional UTC date in YYYY-MM-DD form. Defaults to today (UTC)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/barter":{"get":{"tags":["x402"],"summary":"Barter / counter-offer telemetry (per-path + histogram)","description":"Per-path floor_pct, sample size, conversion-at-floor, total spread, and a demand-curve histogram of paid amounts. Always free (Tier0). This is the observability surface for the counter-offer scheme.","operationId":"get_barter_v1_x402_barter_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional UTC date for the histogram. Defaults to today (UTC).","title":"Date"},"description":"Optional UTC date for the histogram. Defaults to today (UTC)."},{"name":"bucket_usd","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"description":"Histogram bucket width in USD (default $0.005).","default":0.005,"title":"Bucket Usd"},"description":"Histogram bucket width in USD (default $0.005)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/failed":{"get":{"tags":["x402"],"summary":"Failed-tx recovery queue","description":"Returns nonces that were quoted but never paid AND nonces whose proof submit failed verification, since `since` (ISO date or unix seconds). Always free (Tier0).","operationId":"get_failed_v1_x402_failed_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO timestamp (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) or unix seconds. Defaults to the start of today (UTC).","title":"Since"},"description":"ISO timestamp (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) or unix seconds. Defaults to the start of today (UTC)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/recover":{"post":{"tags":["x402"],"summary":"Manually re-verify a previously-failed proof","description":"Re-submit a (nonce, tx_hash) pair for a previously-failed proof. Useful when an on-chain tx finally confirmed after the nonce briefly tipped into chain_rejected (insufficient confirmations, RPC flake, etc). Re-uses the standard validator path so the same replay/expiry rules apply.","operationId":"recover_proof_v1_x402_recover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/bogo":{"get":{"tags":["x402"],"summary":"BOGO (first-call-free) introspection","description":"Returns the BOGO redemption table: how many unique agent_dids have redeemed first-call-free across each endpoint family, plus the list of families covered. Public read — no auth.","operationId":"bogo_stats_v1_x402_bogo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402/quote":{"post":{"tags":["x402"],"summary":"x402 atomic payment quote — LIVE, USDC on Base 8453","description":"Produces a signed, machine-redeemable x402 quote for any HiveMorph surface. Real treasury. USDC on Base chain 8453. ERC-681 deeplink ready for any wallet or agent. Includes a service-signed receipt envelope verifiable against /v1/receipt/verify and /v1/prov/pubkey, plus a crypto_agility block declaring classical (Ed25519) and post-quantum-ready (ML-KEM/ML-DSA) posture.\n\nReceipt-profile gating: 'pq' requires a valid regulated-tier delegation envelope (regulated_envelope_jti). Otherwise the call returns 402 regulated_tier_required.","operationId":"quote_v1_x402_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/client-intent":{"get":{"tags":["x402"],"summary":"Browser/wallet-consumable x402 payment intent (LIVE nonce)","description":"Returns the safe, browser-consumable fields from a live x402 payment envelope: amount, asset, chain, contract, recipient, decimals, nonce, expires_at, payment_endpoint, per-chain ERC-681 deeplink, and the exact proof-submission shape. Registers a REAL redeemable nonce. profile=nano|standard (pq needs a regulated delegation envelope — use POST /v1/x402/quote for pq). Wallet-native one-click pay is supported up to the final client broadcast+proof step, which the wallet performs.","operationId":"client_intent_get_v1_x402_client_intent_get","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","description":"Receipt profile: nano | standard.","default":"nano","title":"Profile"},"description":"Receipt profile: nano | standard."},{"name":"amount_usdc","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000000.0,"minimum":0.0001},{"type":"null"}],"description":"Explicit USDC amount. Overrides the profile default price.","title":"Amount Usdc"},"description":"Explicit USDC amount. Overrides the profile default price."},{"name":"endpoint_path","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"description":"Optional target path to price the intent for (pricing-table lookup).","title":"Endpoint Path"},"description":"Optional target path to price the intent for (pricing-table lookup)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["x402"],"summary":"Browser/wallet-consumable x402 payment intent (LIVE nonce) — POST","operationId":"client_intent_post_v1_x402_client_intent_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ClientIntentRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/wallet-intent":{"get":{"tags":["x402"],"summary":"Alias of GET /v1/x402/client-intent","operationId":"wallet_intent_get_v1_x402_wallet_intent_get","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"nano","title":"Profile"}},{"name":"amount_usdc","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":10000000.0,"minimum":0.0001},{"type":"null"}],"title":"Amount Usdc"}},{"name":"endpoint_path","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Endpoint Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["x402"],"summary":"Alias of POST /v1/x402/client-intent","operationId":"wallet_intent_post_v1_x402_wallet_intent_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ClientIntentRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/status":{"get":{"tags":["capitolare"],"summary":"Status","operationId":"status_v1_capitolare_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/capitolare/venue/address":{"get":{"tags":["capitolare"],"summary":"Venue Address","operationId":"venue_address_v1_capitolare_venue_address_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/capitolare/enter":{"post":{"tags":["capitolare"],"summary":"Enter","operationId":"enter_v1_capitolare_enter_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/propose":{"post":{"tags":["capitolare"],"summary":"Propose","operationId":"propose_v1_capitolare_propose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/accept":{"post":{"tags":["capitolare"],"summary":"Accept","operationId":"accept_v1_capitolare_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/settle":{"post":{"tags":["capitolare"],"summary":"Settle","operationId":"settle_v1_capitolare_settle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_capitolare__routes__SettleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/leave":{"post":{"tags":["capitolare"],"summary":"Leave","operationId":"leave_v1_capitolare_leave_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/verify":{"post":{"tags":["capitolare"],"summary":"Verify","operationId":"verify_v1_capitolare_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_capitolare__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/unseal":{"post":{"tags":["capitolare"],"summary":"Unseal","operationId":"unseal_v1_capitolare_unseal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsealRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/recent":{"get":{"tags":["capitolare"],"summary":"Recent","operationId":"recent_v1_capitolare_recent_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/demo/watch":{"post":{"tags":["capitolare"],"summary":"Demo Watch","description":"Run BOTH sides as Hive-spawned agents.\n\nIssues two passports, opens a session, runs propose→accept→settle, and\nreturns the receipt. This is what the /capitolare/ page calls when the\nvisitor clicks Watch.","operationId":"demo_watch_v1_capitolare_demo_watch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoWatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capitolare/sdk.py":{"get":{"tags":["capitolare"],"summary":"Sdk Py","operationId":"sdk_py_v1_capitolare_sdk_py_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/capitolare/sdk.js":{"get":{"tags":["capitolare"],"summary":"Sdk Js","operationId":"sdk_js_v1_capitolare_sdk_js_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/entropy/pricing":{"get":{"tags":["entropy"],"summary":"Entropy-as-a-Service pricing","description":"Returns the entropy API pricing table. Single sample is TierLite at $0.0001/sample. Bulk packs of 1000 are Tier3 at $0.05/pack (5x discount). Sovereign-tier samples (cosmic-ray + soil microbial + chlorophyll axes) require separate enrollment and pricing — contact sales@thehiveryiq.com.","operationId":"get_pricing_v1_entropy_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/entropy/sample":{"post":{"tags":["entropy"],"summary":"Single entropy sample","description":"Returns one cryptographically mixed entropy sample with a signed provenance receipt verifiable at /v1/receipt/verify. TierLite — $0.0001 per call when gated.","operationId":"post_sample_v1_entropy_sample_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SampleRequest","default":{"bytes":32}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entropy/bulk":{"post":{"tags":["entropy"],"summary":"Bulk entropy samples","description":"Returns up to 1000 entropy samples in one call, each with its own signed receipt. Tier3 — $0.05 per 1000-sample pack. Average per-sample cost: $0.00005.","operationId":"post_bulk_v1_entropy_bulk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entropy/health":{"get":{"tags":["entropy"],"summary":"Entropy pool health","description":"Returns operational telemetry on the entropy pool. Always free.","operationId":"get_health_v1_entropy_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/prov/pubkey":{"get":{"tags":["prov"],"summary":"Prov Pubkey","description":"Return the service's Ed25519 pubkey for smash.prov verification.","operationId":"prov_pubkey_v1_prov_pubkey_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Prov Pubkey V1 Prov Pubkey Get"}}}}}}},"/v1/prov/verify":{"post":{"tags":["prov"],"summary":"Prov Verify","description":"Verify a smash.prov signature against this service's pubkey.\n\nFree. No auth. The whole point is to prove provenance for $0.","operationId":"prov_verify_v1_prov_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_prov__routes__VerifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Prov Verify V1 Prov Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rosetta/normalize":{"post":{"tags":["organic"],"summary":"Rosetta Normalize","operationId":"rosetta_normalize_v1_rosetta_normalize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RosettaReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Rosetta Normalize V1 Rosetta Normalize Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prospector/score":{"post":{"tags":["organic"],"summary":"Prospector Score","operationId":"prospector_score_v1_prospector_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProspectorReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Prospector Score V1 Prospector Score Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/lookup":{"get":{"tags":["organic"],"summary":"Hktn Lookup","operationId":"hktn_lookup_v1_hktn_lookup_get","parameters":[{"name":"hktn","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"HKTN id, e.g. hktn_...","title":"Hktn"},"description":"HKTN id, e.g. hktn_..."},{"name":"agent_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Agent DID to look up","title":"Agent Did"},"description":"Agent DID to look up"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Hktn Lookup V1 Hktn Lookup Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/register":{"post":{"tags":["organic"],"summary":"Hktn Register","description":"Accept an HKTN registration intent.\n\nReturns the canonical tier table, the x402 discount the caller would\nearn at each tier, the next-best-actions for promotion, and a signed\nreceipt of the registration intent that the caller can present\ndownstream. Tier promotion itself is ROADMAP — this route does not\nwrite into the R5 ledger.","operationId":"hktn_register_v1_hktn_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HKTNRegisterReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Hktn Register V1 Hktn Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rubric/select":{"post":{"tags":["organic"],"summary":"Rubric Select","operationId":"rubric_select_v1_rubric_select_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RubricReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Rubric Select V1 Rubric Select Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/settlement/reference":{"get":{"tags":["organic"],"summary":"Settlement Reference","operationId":"settlement_reference_v1_settlement_reference_get","parameters":[{"name":"amount_usdc","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"description":"Amount in USDC (decimal)","title":"Amount Usdc"},"description":"Amount in USDC (decimal)"},{"name":"memo","in":"query","required":false,"schema":{"type":"string","maxLength":64,"description":"Optional short memo","default":"","title":"Memo"},"description":"Optional short memo"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Settlement Reference V1 Settlement Reference Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/emit":{"post":{"tags":["organic"],"summary":"Receipt Emit","operationId":"receipt_emit_v1_receipt_emit_post","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","description":"Receipt profile: nano | standard | pq","default":"standard","title":"Profile"},"description":"Receipt profile: nano | standard | pq"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptEmitReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Receipt Emit V1 Receipt Emit Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organic"],"summary":"Receipt Emit Preflight","description":"Preflight/discovery for the emit surface.\n\n``GET /v1/receipt/emit`` previously fell through to the swarm catch-all\n``GET /v1/receipt/{receipt_id}`` and returned 404 (\"receipt not found\").\nEmitting a receipt is a *write* — it requires a POST body — so a GET is a\npreflight. It answers three honest questions without minting anything:\n\n  - unknown profile        → 400 with the allowed profiles\n  - emit is payment-gated  → 402 x402 payment_required metadata (no charge)\n  - emit is ungated (dev)  → 200 describing the free POST path\n\nNo receipt is minted and nothing is written to the ledger on GET.","operationId":"receipt_emit_preflight_v1_receipt_emit_get","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","description":"Receipt profile: nano | standard | pq","default":"standard","title":"Profile"},"description":"Receipt profile: nano | standard | pq"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/benchmark":{"get":{"tags":["organic"],"summary":"Receipt Benchmark","description":"Read-only live benchmark of the receipt path.\n\nPerforms a REAL receipt operation end-to-end and reports per-phase timing:\ncanonicalize a fixed benchmark payload, SHA-256 hash it, Ed25519-sign it\nwith the production signer, and verify the signature. When HIVE_PQ_ENABLED\nis active, an ML-DSA-65 co-signature is computed and timed too.\n\nThis proves the *receipt path* — canonicalize → hash → sign → verify — is\nlive and fast. It does NOT prove external model inference, and it does NOT\nprove any theorem: no Leanstral run, no proof assistant is invoked here.\n\nRead-only: nothing is written to the ledger and no state is mutated.","operationId":"receipt_benchmark_v1_receipt_benchmark_get","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","description":"Receipt profile: nano | standard | pq","default":"nano","title":"Profile"},"description":"Receipt profile: nano | standard | pq"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/verify":{"post":{"tags":["swarm-receipts"],"summary":"Verify Receipt Route","operationId":"verify_receipt_route_v1_receipt_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Receipt Route V1 Receipt Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pricing":{"get":{"tags":["organic"],"summary":"Pricing","operationId":"pricing_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Pricing Get"}}}}}}},"/v1/model-receipts/adapters":{"get":{"tags":["model-receipts"],"summary":"Adapters","description":"List every registered provider/model adapter (env var names only, no keys).","operationId":"adapters_v1_model_receipts_adapters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Adapters V1 Model Receipts Adapters Get"}}}}}}},"/v1/model-receipts/leanstral-demo":{"get":{"tags":["model-receipts"],"summary":"Leanstral Demo","description":"Default demo: receipt a Mistral Leanstral 1.5 call on a safe Lean 4 prompt.\n\nReturns setup_required=true (HTTP 200) with a signed preflight receipt if\nMISTRAL_API_KEY is not configured; otherwise runs the real call and receipts it.","operationId":"leanstral_demo_v1_model_receipts_leanstral_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/model-receipts/run":{"post":{"tags":["model-receipts"],"summary":"Run","description":"Universal runner: receipt a call to any registered provider/model.\n\nOmit ``prompt`` to use the built-in safe demo prompt.","operationId":"run_v1_model_receipts_run_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/model-receipts/adapter-health":{"get":{"tags":["model-receipts"],"summary":"Adapter Health","description":"Live health/demo matrix across every registered adapter.","operationId":"adapter_health_v1_model_receipts_adapter_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/model-receipts/demo-matrix":{"get":{"tags":["model-receipts"],"summary":"Demo Matrix","description":"Alias of /adapter-health (richer per-model matrix name).","operationId":"demo_matrix_v1_model_receipts_demo_matrix_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/model-receipts/smartmorph-route-demo":{"get":{"tags":["model-receipts"],"summary":"Smartmorph Route Demo Get","description":"SmartMorphAgent route proof (GET convenience; uses the built-in prompt).","operationId":"smartmorph_route_demo_get_v1_model_receipts_smartmorph_route_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["model-receipts"],"summary":"Smartmorph Route Demo Post","description":"SmartMorphAgent route proof.\n\nRuns live model calls for the registered+configured candidates (Mistral +\nDeepInfra), compares the ACTUAL observed signals (latency, visible-output\navailability, and provider-reported token cost when present — else labeled\n'unknown'), selects a route by explicit rules, and signs a distinct morph\ndecision receipt in addition to the per-stop model-call receipts.","operationId":"smartmorph_route_demo_post_v1_model_receipts_smartmorph_route_demo_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RunRequest"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-receipts/adapters":{"get":{"tags":["agent-receipts"],"summary":"Agent Adapters","description":"List the agent-task rails and their configured status (Manus today).","operationId":"agent_adapters_v1_agent_receipts_adapters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/agent-receipts/manus/health":{"get":{"tags":["agent-receipts"],"summary":"Manus Health","description":"Non-mutating Manus health: reports configured status + docs only.\n\nManus has no documented non-mutating probe endpoint, and creating a task\nwould consume Manus credits, so health deliberately does NOT create a task.\nIt reports whether MANUS_API_KEY is present; a live task requires POST\n/v1/agent-receipts/manus/create.","operationId":"manus_health_v1_agent_receipts_manus_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/agent-receipts/manus/create":{"post":{"tags":["agent-receipts"],"summary":"Manus Create","description":"Create a Manus agent task and sign a receipt over the create API path.","operationId":"manus_create_v1_agent_receipts_manus_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManusCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-receipts/manus/detail":{"post":{"tags":["agent-receipts"],"summary":"Manus Detail Post","description":"Fetch a Manus task's status and sign a status receipt.","operationId":"manus_detail_post_v1_agent_receipts_manus_detail_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManusDetailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agent-receipts"],"summary":"Manus Detail Get","description":"Fetch a Manus task's status via ?task_id= and sign a status receipt.","operationId":"manus_detail_get_v1_agent_receipts_manus_detail_get","parameters":[{"name":"task_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/activation/keys":{"get":{"tags":["activation"],"summary":"Activation-key capability discovery (no mint)","description":"Read-only capability probe for the activation-key rail. Returns how to mint, the price, the accepted auth, and the available scopes. Minting happens on POST /v1/activation/keys — this GET never issues a key.","operationId":"keys_discovery_v1_activation_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["activation"],"summary":"Mint a tk_live activation key (x402-paid or owner-admin)","description":"Mints a real, verifiable tk_live activation key. Requires a validated x402 access token (X-Hive-Access) OR the owner secret (X-Admin-Api-Key). Without either, returns a 402 payment_required envelope with a redeemable nonce — never a free key. The raw key is returned exactly once; only its SHA-256 hash is retained server-side.","operationId":"mint_key_v1_activation_keys_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Access","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Access"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_activation__router__MintRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/activation/verify":{"post":{"tags":["activation"],"summary":"Verify a tk_live activation key (counts one use)","description":"Validates a tk_live key against the keyring, enforcing revocation and usage limits, and counts one use. Never echoes the raw key back.","operationId":"verify_key_v1_activation_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_activation__router__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/activation/keys/{key_id}":{"get":{"tags":["activation"],"summary":"Public activation-key metadata (no secret)","description":"Returns key metadata (prefix, scopes, usage, issuer). Never the raw key.","operationId":"key_metadata_v1_activation_keys__key_id__get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt-relay/health":{"get":{"tags":["receipt-relay"],"summary":"Receipt Relay discovery — modes, evidence tiers, schema","operationId":"relay_health_v1_receipt_relay_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/receipt-relay/event":{"post":{"tags":["receipt-relay"],"summary":"Sign a self-attested receipt over an arbitrary external event","operationId":"relay_event_v1_receipt_relay_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt-relay/http":{"post":{"tags":["receipt-relay"],"summary":"SSRF-guarded outbound request, signed as relay_observed (or dry_run)","operationId":"relay_http_v1_receipt_relay_http_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt-relay/chain":{"post":{"tags":["receipt-relay"],"summary":"Record a solana_tx/evm_tx receipt (submitted_unverified; optional read-only verify)","operationId":"relay_chain_v1_receipt_relay_chain_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/r3pv/health":{"get":{"tags":["r3pv"],"summary":"R3Pv discovery — version, healing states, vector dimensions, signer","operationId":"r3pv_health_v1_r3pv_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/r3pv/groups":{"post":{"tags":["r3pv"],"summary":"Create a receipt group from inline receipts and/or receipt IDs","operationId":"r3pv_create_group_v1_r3pv_groups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/r3pv/groups/{group_id}":{"get":{"tags":["r3pv"],"summary":"Fetch a stored receipt group","operationId":"r3pv_get_group_v1_r3pv_groups__group_id__get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/r3pv/vector":{"get":{"tags":["r3pv"],"summary":"Compute + sign a proof vector for a stored group","operationId":"r3pv_vector_get_v1_r3pv_vector_get","parameters":[{"name":"group_id","in":"query","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["r3pv"],"summary":"Group + vector in one call from inline receipts/IDs","operationId":"r3pv_vector_post_v1_r3pv_vector_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/protected-flow/health":{"get":{"tags":["protected-flow"],"summary":"Protected Flow discovery — version, decision classes, policy packs, meter, signer","operationId":"protected_flow_health_v1_protected_flow_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/protected-flow/assess":{"post":{"tags":["protected-flow"],"summary":"Assess an R3Pv group and return a signed decision + meter quote","operationId":"protected_flow_assess_v1_protected_flow_assess_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/protected-flow/evidence/{group_id}/export":{"get":{"tags":["protected-flow"],"summary":"Bundle signed R3Pv vector + latest signed assessment + receipts + pubkey","operationId":"protected_flow_evidence_export_v1_protected_flow_evidence__group_id__export_get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/readiness":{"post":{"tags":["audit"],"summary":"Readiness","operationId":"readiness_v1_audit_readiness_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadinessRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/designer/chat":{"post":{"tags":["designer"],"summary":"Designer Chat","description":"Conversational wizard turn.\n\nFree for the first 2 turns per IP per UTC day (subject to global $2 daily\nceiling). After the free quota the route returns 402 with x402 envelope.","operationId":"designer_chat_v1_designer_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignerChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignerChatResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/designer/mint":{"post":{"tags":["designer"],"summary":"Designer Mint","description":"Persist a finalized agent. Spec must be complete.\n\nNOTE: this route is x402-paid ($0.05) via the pricing table. The\npayment-required middleware enforces payment before we reach this\nhandler. EIP-712 signature verification happens here as an\nadditional safety check (publisher must control the wallet they're\nclaiming earnings for).","operationId":"designer_mint_v1_designer_mint_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_designer__routes__MintRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{slug}/chat":{"post":{"tags":["designer"],"summary":"Agent Chat","description":"Live per-slug chat. Loads system_prompt + base_model from store.\n\nThis route is x402-paid at the per-agent price_per_call (default $0.001).\nThe middleware enforces payment via the pricing table; the handler\njust executes the LLM call.","operationId":"agent_chat_v1_agents__slug__chat_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Agent Chat V1 Agents  Slug  Chat Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/designer/quota":{"get":{"tags":["designer"],"summary":"Designer Quota","description":"Public view of today's free-quota state.","operationId":"designer_quota_v1_designer_quota_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Designer Quota V1 Designer Quota Get"}}}}}}},"/v1/designer/agents/{slug}":{"get":{"tags":["designer"],"summary":"Designer Agent Public","operationId":"designer_agent_public_v1_designer_agents__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Designer Agent Public V1 Designer Agents  Slug  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/designer/agents":{"get":{"tags":["designer"],"summary":"Designer Agents Recent","operationId":"designer_agents_recent_v1_designer_agents_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Designer Agents Recent V1 Designer Agents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/designer/admin/recover_mint":{"post":{"tags":["designer"],"summary":"Designer Admin Recover Mint","operationId":"designer_admin_recover_mint_v1_designer_admin_recover_mint_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRecoverMintRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Designer Admin Recover Mint V1 Designer Admin Recover Mint Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vault/visit":{"post":{"tags":["vault-visits"],"summary":"Vault Visit","description":"Record a vault page beacon. One Pushover ping per visitor session.","operationId":"vault_visit_v1_vault_visit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisitEvent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vault/visits/recent":{"get":{"tags":["vault-visits"],"summary":"Visits Recent","description":"Operator-only — read recent visits from the JSONL log.\nNo auth at this stage; the URL is undocumented. Move behind auth before publishing.","operationId":"visits_recent_v1_vault_visits_recent_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vault/visits/by-slug":{"get":{"tags":["vault-visits"],"summary":"Visits By Slug","description":"Per-slug visit history. Returns ALL visits for one slug, newest first,\nplus a classification summary that uses the corrected three-tier\nbot-classification logic (LinkedIn-anonymous-aware).","operationId":"visits_by_slug_v1_vault_visits_by_slug_get","parameters":[{"name":"slug","in":"query","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vault/visits/by-company":{"get":{"tags":["vault-visits"],"summary":"Visits By Company","description":"Aggregate visit summary across ALL tracked slugs. One row per slug.\nUseful for an operator-side dashboard at a glance.","operationId":"visits_by_company_v1_vault_visits_by_company_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vault/visits/health":{"get":{"tags":["vault-visits"],"summary":"Visits Health","operationId":"visits_health_v1_vault_visits_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vault/visits/leaderboard":{"get":{"tags":["vault-visits"],"summary":"Visits Leaderboard","description":"Slugs ranked by engagement intensity = unique_viewers × open_count.\n\nRe-opens count multiplicatively because the second open by the same\nviewer means absorption; a third open from a NEW fingerprint means\nthe vault was forwarded internally — the strongest signal we get.","operationId":"visits_leaderboard_v1_vault_visits_leaderboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vault/visits/forwards":{"get":{"tags":["vault-visits"],"summary":"Visits Forwards","description":"Slugs where the vault has been forwarded to a 2nd+ viewer.\n\nThis is the highest signal in the system — a prospect didn't just\nopen the vault, they sent it to a colleague. Returns one row per\nslug with forwarded=True, with the per-viewer breakdown.","operationId":"visits_forwards_v1_vault_visits_forwards_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/vault/visits/register-label":{"post":{"tags":["vault-visits"],"summary":"Register Label","description":"Attach a human label to a slug at runtime, no deploy required.\nPersists to disk so the label survives restarts. Code-defined\nSLUG_LABELS still take precedence — this is a runtime overlay for\nnew vaults you spin up between deploys.","operationId":"register_label_v1_vault_visits_register_label_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabelRegister"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vault/visits/labels":{"get":{"tags":["vault-visits"],"summary":"List Labels","description":"Show all known slug → label mappings (code + runtime).","operationId":"list_labels_v1_vault_visits_labels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/appkits":{"get":{"tags":["app-kits"],"summary":"Appkits Capabilities","description":"Capability discovery. Compare to Circle App Kits surface.","operationId":"appkits_capabilities_v1_appkits_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appkits Capabilities V1 Appkits Get"}}}}}}},"/v1/appkits/quote":{"post":{"tags":["app-kits"],"summary":"Appkits Quote","operationId":"appkits_quote_v1_appkits_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__appkits_routes__QuoteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appkits Quote V1 Appkits Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/appkits/bridge":{"post":{"tags":["app-kits"],"summary":"Appkits Bridge","operationId":"appkits_bridge_v1_appkits_bridge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appkits Bridge V1 Appkits Bridge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/appkits/send":{"post":{"tags":["app-kits"],"summary":"Appkits Send","operationId":"appkits_send_v1_appkits_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appkits Send V1 Appkits Send Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/appkits/swap":{"post":{"tags":["app-kits"],"summary":"Appkits Swap","operationId":"appkits_swap_v1_appkits_swap_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appkits Swap V1 Appkits Swap Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/appkits/balance/{address}":{"get":{"tags":["app-kits"],"summary":"Appkits Unified Balance","description":"Returns a unified balance across every supported chain.\nv0.1 emits a deterministic empty-skeleton response so clients can wire UI\ntoday; live indexer will populate by_chain in v0.2.","operationId":"appkits_unified_balance_v1_appkits_balance__address__get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","title":"Address"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Appkits Unified Balance V1 Appkits Balance  Address  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prior/issue":{"post":{"tags":["hive-prior"],"summary":"Issue Prior","description":"Stamp a new Patent Priority record.\n\nIssues a dual-signed ML-DSA-65 + Ed25519 CBOR envelope that binds\ncontent_hash + inventor_did + timestamp. Persists to prior_records.jsonl.","operationId":"issue_prior_v1_prior_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriorIssueRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriorIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prior/verify/{prior_id}":{"get":{"tags":["hive-prior"],"summary":"Verify Prior","description":"Return the stored Prior record and a freshly-computed dual-signature verification.\nReturns 404 if the prior_id is unknown.","operationId":"verify_prior_v1_prior_verify__prior_id__get","parameters":[{"name":"prior_id","in":"path","required":true,"schema":{"type":"string","title":"Prior Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prior/by-hash/{content_hash}":{"get":{"tags":["hive-prior"],"summary":"By Hash","description":"Return all Prior records for a content hash.\n\nMultiple inventors can stamp the same content hash. This endpoint proves\nwho stamped first by returning records in chronological order.","operationId":"by_hash_v1_prior_by_hash__content_hash__get","parameters":[{"name":"content_hash","in":"path","required":true,"schema":{"type":"string","title":"Content Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prior/by-inventor/{inventor_did}":{"get":{"tags":["hive-prior"],"summary":"By Inventor","description":"Return paginated list of Prior records for an inventor DID.\nResults are sorted newest-first.","operationId":"by_inventor_v1_prior_by_inventor__inventor_did__get","parameters":[{"name":"inventor_did","in":"path","required":true,"schema":{"type":"string","title":"Inventor Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prior/health":{"get":{"tags":["hive-prior"],"summary":"Health","description":"Endpoint health check + record count + write probe.","operationId":"health_v1_prior_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/prior/leaderboard":{"get":{"tags":["hive-prior"],"summary":"Leaderboard","description":"Top inventor DIDs by Prior receipts issued (default last 30 days).","operationId":"leaderboard_v1_prior_leaderboard_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/guardian/health":{"get":{"tags":["guardian"],"summary":"Health","operationId":"health_v1_guardian_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Guardian Health Get"}}}}}}},"/v1/guardian/scores":{"get":{"tags":["guardian"],"summary":"Scores","description":"Per-axis quality scores from the AIMEW QualityScorer.","operationId":"scores_v1_guardian_scores_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Scores V1 Guardian Scores Get"}}}}}}},"/v1/guardian/weights":{"get":{"tags":["guardian"],"summary":"Weights","description":"Current AIMEW weight vector. Σ w_i = 1.0 across non-excluded axes.","operationId":"weights_v1_guardian_weights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Weights V1 Guardian Weights Get"}}}}}}},"/v1/guardian/anomalies":{"get":{"tags":["guardian"],"summary":"Anomalies","description":"Per-axis anomaly score from the LSTM detector + quarantine list.","operationId":"anomalies_v1_guardian_anomalies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anomalies V1 Guardian Anomalies Get"}}}}}}},"/v1/site/beacon":{"post":{"tags":["site-traffic"],"summary":"Beacon","description":"First-party page-view beacon. 200 always; never blocks the page.","operationId":"beacon_v1_site_beacon_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BeaconPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Beacon V1 Site Beacon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/traffic":{"get":{"tags":["site-traffic"],"summary":"Traffic","description":"Aggregate page views grouped by path / referrer / country / company\n+ a high-signal-leads projection. Now with corporate company tagging\nand UTM attribution. Public read-only telemetry (no token) for the\n/admin/live/ arrivals cockpit.","operationId":"traffic_v1_site_traffic_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h","title":"Window"}},{"name":"humans_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Humans Only"}},{"name":"exclude_smoke","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Exclude Smoke"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Traffic V1 Site Traffic Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/timeseries":{"get":{"tags":["site-traffic"],"summary":"Timeseries","description":"Bucketed time series for sparkline rendering. Returns a list of\n(bucket_start_ts, count) pairs covering the window. Public read-only.","operationId":"timeseries_v1_site_timeseries_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h","title":"Window"}},{"name":"bucket_minutes","in":"query","required":false,"schema":{"type":"integer","default":60,"title":"Bucket Minutes"}},{"name":"humans_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Humans Only"}},{"name":"exclude_smoke","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Exclude Smoke"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Timeseries V1 Site Timeseries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/events":{"get":{"tags":["site-traffic"],"summary":"Events","description":"Recent events tail. Used by dashboard live feed (5s refresh).\nPublic read-only telemetry for the /admin/live/ arrivals cockpit.","operationId":"events_v1_site_events_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"humans_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Humans Only"}},{"name":"exclude_smoke","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Exclude Smoke"}},{"name":"since_ts","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Ts"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Events V1 Site Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/live-brief":{"get":{"tags":["site-traffic"],"summary":"Live Brief","description":"Operator brief: one call that classifies the current/latest visitor\nand summarizes recent telemetry into a copy-paste `brief_text`.\n\nPublic read-only telemetry (no token), same path as the other\n/v1/site/* reads. Built for the /admin/live/ dashboard so an operator\n(or assistant) can instantly tell real inbound vs spam / crawler /\ndatacenter-VPN / prospect without terminal access or screenshots.","operationId":"live_brief_v1_site_live_brief_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"1h","title":"Window"}},{"name":"humans_limit","in":"query","required":false,"schema":{"type":"integer","default":12,"title":"Humans Limit"}},{"name":"bots_limit","in":"query","required":false,"schema":{"type":"integer","default":8,"title":"Bots Limit"}},{"name":"exclude_smoke","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Exclude Smoke"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Live Brief V1 Site Live Brief Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/prospect/{utm}":{"get":{"tags":["site-traffic"],"summary":"Prospect Detail","description":"All hits attributable to a single outreach tag (?u=francisco).\nPublic read-only telemetry for the arrivals cockpit.","operationId":"prospect_detail_v1_site_prospect__utm__get","parameters":[{"name":"utm","in":"path","required":true,"schema":{"type":"string","title":"Utm"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prospect Detail V1 Site Prospect  Utm  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/traffic/redact":{"post":{"tags":["site-traffic"],"summary":"Traffic Redact","description":"Token-gated wipe of records matching filters. Use carefully.\n\nBody: {\"path_contains\": \"deploy-test\"} OR {\"session\": \"<hex>\"} OR\n{\"is_smoke\": true} OR {\"all_smoke\": true}.","operationId":"traffic_redact_v1_site_traffic_redact_post","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Traffic Redact V1 Site Traffic Redact Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/site/traffic/health":{"get":{"tags":["site-traffic"],"summary":"Traffic Health","operationId":"traffic_health_v1_site_traffic_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Traffic Health V1 Site Traffic Health Get"}}}}}}},"/v1/dashboard/gumroad":{"get":{"tags":["dashboard"],"summary":"Dashboard Gumroad","operationId":"dashboard_gumroad_v1_dashboard_gumroad_get","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dashboard Gumroad V1 Dashboard Gumroad Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/receipts":{"get":{"tags":["dashboard"],"summary":"Dashboard Receipts","operationId":"dashboard_receipts_v1_dashboard_receipts_get","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dashboard Receipts V1 Dashboard Receipts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/bazaar":{"get":{"tags":["dashboard"],"summary":"Dashboard Bazaar","description":"Funnel: /bazaar pageviews → buy_click events → external Gumroad clicks.","operationId":"dashboard_bazaar_v1_dashboard_bazaar_get","parameters":[{"name":"window_hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Window Hours"}},{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dashboard Bazaar V1 Dashboard Bazaar Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/outreach":{"get":{"tags":["dashboard"],"summary":"Dashboard Outreach","description":"Standing outreach watch board with last-touch enrichment.","operationId":"dashboard_outreach_v1_dashboard_outreach_get","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dashboard Outreach V1 Dashboard Outreach Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/summary":{"get":{"tags":["dashboard"],"summary":"Dashboard Summary","description":"One-shot rollup — saves the dashboard from spamming 6 endpoints.","operationId":"dashboard_summary_v1_dashboard_summary_get","parameters":[{"name":"x-admin-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dashboard Summary V1 Dashboard Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/stats":{"get":{"tags":["hive-wallet"],"summary":"Wallet Stats","description":"Public counter — total Hive Wallets created.","operationId":"wallet_stats_v1_wallet_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Wallet Stats V1 Wallet Stats Get"}}}}}}},"/v1/wallet/register":{"post":{"tags":["hive-wallet"],"summary":"Wallet Register","description":"Link the authenticated Privy session to a Hive Wallet row.\n\nCalled by the frontend right after Privy creates the embedded wallet,\nso we can attribute referrals and start the XP counter.","operationId":"wallet_register_v1_wallet_register_post","parameters":[{"name":"referrer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Wallet Register V1 Wallet Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/me":{"get":{"tags":["hive-wallet"],"summary":"Wallet Me","description":"Return the authenticated wallet's state.","operationId":"wallet_me_v1_wallet_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Wallet Me V1 Wallet Me Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallet/me/mints":{"get":{"tags":["hive-wallet"],"summary":"Wallet Me Mints","operationId":"wallet_me_mints_v1_wallet_me_mints_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Wallet Me Mints V1 Wallet Me Mints Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pilot/accept":{"post":{"tags":["pilot"],"summary":"Pilot Accept","description":"Countersign a pilot offer. Returns a signed receipt + deposit instructions.","operationId":"pilot_accept_v1_pilot_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PilotAcceptReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pilot/accepts/recent":{"get":{"tags":["pilot"],"summary":"Accepts Recent","description":"Operator-only — read recent pilot accepts from the JSONL log.","operationId":"accepts_recent_v1_pilot_accepts_recent_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pilot/health":{"get":{"tags":["pilot"],"summary":"Pilot Health","operationId":"pilot_health_v1_pilot_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/chat/public":{"post":{"tags":["chat"],"summary":"Chat Public","operationId":"chat_public_v1_chat_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatPublicReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/public/health":{"get":{"tags":["chat"],"summary":"Chat Public Health","operationId":"chat_public_health_v1_chat_public_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stakes-classify":{"post":{"tags":["onboard"],"summary":"Stakes Classify","operationId":"stakes_classify_v1_stakes_classify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakesClassifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakesClassifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stakes-classify/health":{"get":{"tags":["onboard"],"summary":"Health","operationId":"health_v1_stakes_classify_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/attest/passport/issue":{"post":{"tags":["attest"],"summary":"Passport Issue","description":"Issue a Pre-Action Attestation Manifest (C15 — hive-passport).","operationId":"passport_issue_v1_attest_passport_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PassportIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/passport/verify":{"post":{"tags":["attest"],"summary":"Passport Verify","description":"Verify a Pre-Action Attestation Manifest (C15 — hive-passport).","operationId":"passport_verify_v1_attest_passport_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PassportVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/custody/append":{"post":{"tags":["attest"],"summary":"Custody Append","description":"Append a node to a custody chain (C16 — hive-custody).","operationId":"custody_append_v1_attest_custody_append_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustodyAppendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/custody/verify":{"post":{"tags":["attest"],"summary":"Custody Verify","description":"Verify a custody chain (hash linkage + signatures + taint propagation, C16).","operationId":"custody_verify_v1_attest_custody_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustodyVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/custody/{chain_id}/proof/{index}":{"get":{"tags":["attest"],"summary":"Custody Proof","description":"Return a Merkle inclusion proof for node[index] in a chain (C16).","operationId":"custody_proof_v1_attest_custody__chain_id__proof__index__get","parameters":[{"name":"chain_id","in":"path","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"index","in":"path","required":true,"schema":{"type":"integer","title":"Index"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/cargo/register":{"post":{"tags":["attest"],"summary":"Cargo Register","description":"Register a versioned cargo type (C17 — hive-cargo-taxonomy).","operationId":"cargo_register_v1_attest_cargo_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CargoRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/cargo/validate":{"post":{"tags":["attest"],"summary":"Cargo Validate","description":"Validate a payload against a registered cargo type (C17).","operationId":"cargo_validate_v1_attest_cargo_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CargoValidateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/cargo/snapshot":{"get":{"tags":["attest"],"summary":"Cargo Snapshot","description":"Return a registry snapshot with Merkle root (C17).","operationId":"cargo_snapshot_v1_attest_cargo_snapshot_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/attest/warranty/issue":{"post":{"tags":["attest"],"summary":"Warranty Issue","description":"Issue an attestation warranty (C18 — hive-attestation-warranty).","operationId":"warranty_issue_v1_attest_warranty_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarrantyIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/warranty/breach":{"post":{"tags":["attest"],"summary":"Warranty Breach","description":"Report a warranty breach (C18).","operationId":"warranty_breach_v1_attest_warranty_breach_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarrantyBreachRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/warranty/{warranty_id}":{"get":{"tags":["attest"],"summary":"Warranty Get","description":"Retrieve a warranty by ID (C18).","operationId":"warranty_get_v1_attest_warranty__warranty_id__get","parameters":[{"name":"warranty_id","in":"path","required":true,"schema":{"type":"string","title":"Warranty Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/gate/evaluate":{"post":{"tags":["attest"],"summary":"Gate Evaluate","description":"Evaluate whether an agent may proceed through the HiveAttest gate (C19).\n\nEvery response (allow OR deny) includes a signed C18-format receipt of\nthe gate decision.  Decision bytes = JCS({decision, reasons, passport_fingerprint,\nmanifest_fingerprint, timestamp}); signed with hivemorph signing key.","operationId":"gate_evaluate_v1_attest_gate_evaluate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GateEvaluateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/inspect/sample":{"post":{"tags":["attest"],"summary":"Inspect Sample","description":"Perform probabilistic secondary inspection on a sample (C20).","operationId":"inspect_sample_v1_attest_inspect_sample_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspectSampleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/smsh/verify":{"post":{"tags":["attest"],"summary":"Smsh Verify","description":"Verify a SMSH-Stamp v1 receipt (C8/C12 — smsh-stamp-verifier).","operationId":"smsh_verify_v1_attest_smsh_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmshVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/absence/build":{"post":{"tags":["attest"],"summary":"Absence Build","description":"Build a sorted Merkle tree for an audit window (C13 — prov-absence).","operationId":"absence_build_v1_attest_absence_build_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsenceBuildRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/absence/prove":{"post":{"tags":["attest"],"summary":"Absence Prove","description":"Prove that a query event is absent from a built window (C13).","operationId":"absence_prove_v1_attest_absence_prove_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsenceProveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/absence/verify":{"post":{"tags":["attest"],"summary":"Absence Verify","description":"Verify a non-membership proof against an expected root (C13).","operationId":"absence_verify_v1_attest_absence_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsenceVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/sanctions/screen":{"post":{"tags":["attest"],"summary":"Sanctions Screen","description":"C21 — Pre-action sanctions/PEP screening with signed receipt.\n\nREAL RAIL. Proxies OpenSanctions consolidated dataset (OFAC SDN, EU, UK HMT, UN,\nPEPs, debarment). Every decision (clear or flagged) returns a C18-format signed\nreceipt suitable for custody-chain pinning.\n\nNo mock. No simulation. Production OpenSanctions match endpoint.","operationId":"sanctions_screen_v1_attest_sanctions_screen_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SanctionsScreenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/agentkit/lookup":{"post":{"tags":["attest"],"summary":"Agentkit Lookup","description":"C22 — AgentKit / AgentBook lookup with signed receipt.\n\nREAL RAIL. Reads the canonical AgentBook contract on World Chain via JSON-RPC\neth_call (no SDK, no sidecar — direct on-chain read using web3.py-compatible\nraw RPC). Returns whether the agent wallet is human-backed (registered) and\nthe anonymous human identifier if so.\n\nNo mock. No simulation. Direct chain read.","operationId":"agentkit_lookup_v1_attest_agentkit_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentBookLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attest/address/screen":{"post":{"tags":["attest"],"summary":"Address Screen","description":"C23 — On-chain address risk screening with signed receipt.\n\nREAL RAIL. Proxies GoPlus Security public address-security API (the same\nengine MetaMask and Trust Wallet use for wallet-level risk warnings).\nScreens 17+ risk vectors per address. No mock. No simulation. Live upstream.\n\nDecision logic:\n  - FLAG if any boolean risk vector returns \"1\"\n  - CLEAR otherwise","operationId":"address_screen_v1_attest_address_screen_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressRiskScreenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/status":{"get":{"tags":["xcalibur-verify"],"summary":"Verify Status","operationId":"verify_status_v1_verify_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Status V1 Verify Status Get"}}}}}}},"/v1/verify/commitment/build":{"post":{"tags":["xcalibur-verify"],"summary":"Commitment Build","operationId":"commitment_build_v1_verify_commitment_build_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitmentBuildRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Commitment Build V1 Verify Commitment Build Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/commitment/{tenant_id}/current":{"get":{"tags":["xcalibur-verify"],"summary":"Commitment Current","operationId":"commitment_current_v1_verify_commitment__tenant_id__current_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Commitment Current V1 Verify Commitment  Tenant Id  Current Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/proof/generate":{"post":{"tags":["xcalibur-verify"],"summary":"Proof Generate","operationId":"proof_generate_v1_verify_proof_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProofGenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Proof Generate V1 Verify Proof Generate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/proof/verify":{"post":{"tags":["xcalibur-verify"],"summary":"Proof Verify","operationId":"proof_verify_v1_verify_proof_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProofVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Proof Verify V1 Verify Proof Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/dispute":{"post":{"tags":["xcalibur-verify"],"summary":"Dispute","operationId":"dispute_v1_verify_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dispute V1 Verify Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/demo/run":{"post":{"tags":["xcalibur-verify"],"summary":"Demo Run","description":"End-to-end pipeline the landing page calls. Real Merkle tree, real\nsignature, real verify result. Default flow: inject entry-a from the\nseeded demo corpus into a caller prompt and produce the certificate.","operationId":"demo_run_v1_verify_demo_run_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoRunRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Demo Run V1 Verify Demo Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ops/health":{"get":{"tags":["ops"],"summary":"Ops Health","description":"Aggregate health of every registered endpoint prefix.\nUses the OpsMetricsMiddleware ring buffer for p50/p95/error-rate.\nAlso introspects app.routes for route_count per prefix.","operationId":"ops_health_v1_ops_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ops Health V1 Ops Health Get"}}}}}}},"/v1/ops/revenue":{"get":{"tags":["ops"],"summary":"Ops Revenue","description":"Revenue snapshot: Square gross + USDC-Base treasury balance.\nUses Square API if SQUARE_ACCESS_TOKEN is set; otherwise returns cached snapshot.\nBase RPC used for on-chain USDC balance; falls back to cached snapshot on failure.","operationId":"ops_revenue_v1_ops_revenue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ops Revenue V1 Ops Revenue Get"}}}}}}},"/v1/ops/calls":{"get":{"tags":["ops"],"summary":"Ops Calls","description":"Rolling per-endpoint call counts — top 20 by RPM from in-memory ring buffer\n(last 60 seconds).","operationId":"ops_calls_v1_ops_calls_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ops Calls V1 Ops Calls Get"}}}}}}},"/v1/ops/deploys":{"get":{"tags":["ops"],"summary":"Ops Deploys","description":"Last deploy SHA + timestamp per service from /tmp/hive_ops/deploys.json.","operationId":"ops_deploys_v1_ops_deploys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ops Deploys V1 Ops Deploys Get"}}}}}}},"/v1/ops/traffic":{"get":{"tags":["ops"],"summary":"Ops Traffic Public","description":"Public HUD snapshot — lean fields for the homepage tile. Cached 60s.","operationId":"ops_traffic_public_v1_ops_traffic_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ops Traffic Public V1 Ops Traffic Get"}}}}}}},"/v1/ops/full":{"get":{"tags":["ops"],"summary":"Ops Traffic Full","description":"Full operator view — every service, every repo, perimeter detail. Key-gated.","operationId":"ops_traffic_full_v1_ops_full_get","parameters":[{"name":"key","in":"query","required":true,"schema":{"type":"string","description":"ops key","title":"Key"},"description":"ops key"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ops Traffic Full V1 Ops Full Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/kpi":{"get":{"tags":["portal"],"summary":"Portal Kpi","description":"KPI snapshot for a tenant. Deterministic synthetic data seeded by tenant_id.","operationId":"portal_kpi_v1_portal__tenant_id__kpi_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal Kpi V1 Portal  Tenant Id  Kpi Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/balance":{"get":{"tags":["portal"],"summary":"Portal Balance","description":"On-chain balance and billing state for a tenant.","operationId":"portal_balance_v1_portal__tenant_id__balance_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal Balance V1 Portal  Tenant Id  Balance Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/api-key/rotate":{"post":{"tags":["portal"],"summary":"Portal Rotate Key","description":"Rotate the API key for a tenant.\nThe new key is returned; the previous key keeps working for 60 seconds\n(grace window) to allow in-flight requests to complete.","operationId":"portal_rotate_key_v1_portal__tenant_id__api_key_rotate_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal Rotate Key V1 Portal  Tenant Id  Api Key Rotate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/api-key/revoke":{"post":{"tags":["portal"],"summary":"Portal Revoke Key","description":"Revoke all active API keys for a tenant immediately.\nPass { \"key\": \"tk_live_...\" } to revoke a specific key; omit to revoke all.","operationId":"portal_revoke_key_v1_portal__tenant_id__api_key_revoke_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal Revoke Key V1 Portal  Tenant Id  Api Key Revoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/v2/signup":{"post":{"tags":["portal-v2","portal-v2"],"summary":"Portal V2 Signup","description":"Create a new tenant record. Infers vertical from domain using the lookup table,\nthen Grok if no match, then falls back to universal.\nReturns tenant identity and brand hints.","operationId":"portal_v2_signup_v1_portal_v2_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/v2/{tenant_id}/profile":{"get":{"tags":["portal-v2","portal-v2"],"summary":"Portal V2 Profile","description":"Return tenant profile.\nIf tenant doesn't exist, returns a deterministic synthetic profile based on tenant_id hash\nso demo tenants always work.","operationId":"portal_v2_profile_v1_portal_v2__tenant_id__profile_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/v2/{tenant_id}/tile-prefs":{"post":{"tags":["portal-v2","portal-v2"],"summary":"Portal V2 Tile Prefs","description":"Update a single tile preference. Returns the full updated tile_prefs object.","operationId":"portal_v2_tile_prefs_v1_portal_v2__tenant_id__tile_prefs_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TilePrefRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal V2 Tile Prefs V1 Portal V2  Tenant Id  Tile Prefs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/v2/{tenant_id}/wisdom":{"get":{"tags":["portal-v2","portal-v2"],"summary":"Portal V2 Wisdom","description":"Return AI wisdom recommendations for a tenant.\nCalls Grok via xAI API if XAI_API_KEY is set; caches 24hr.\nFalls back to curated vertical-specific recommendations.","operationId":"portal_v2_wisdom_v1_portal_v2__tenant_id__wisdom_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portal V2 Wisdom V1 Portal V2  Tenant Id  Wisdom Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/v2/{tenant_id}/features/activate":{"post":{"tags":["portal-v2","portal-v2"],"summary":"Portal V2 Activate Feature","description":"Activate a feature for a tenant. Appends to features_enabled and queues for\nbilling on next renewal. Returns activation confirmation with pricing.","operationId":"portal_v2_activate_feature_v1_portal_v2__tenant_id__features_activate_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateFeatureRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateFeatureResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/spin/start":{"post":{"tags":["portal-spin"],"summary":"Spin Start","description":"Anonymous spin session start. No signup required.\nReturns a spin_session_id, vertical config, and pre-generated sample receipts.","operationId":"spin_start_v1_portal_spin_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpinStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpinStartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/spin/emit-receipt":{"post":{"tags":["portal-spin"],"summary":"Spin Emit Receipt","description":"Emit an additional sample receipt into the spin session. Creates a new\ndual-signed (Ed25519 + ML-DSA-65) receipt envelope and appends it to the session.","operationId":"spin_emit_receipt_v1_portal_spin_emit_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmitReceiptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmitReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/spin/promote":{"post":{"tags":["portal-spin"],"summary":"Spin Promote","description":"Promote a spin session into a real tenant. Called when user clicks\n'Show me my dashboard'. Carries over receipts and vertical.","operationId":"spin_promote_v1_portal_spin_promote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromoteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromoteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/lattice":{"get":{"tags":["portal-spin"],"summary":"Tenant Lattice","description":"Return receipts formatted for the wave-lattice visualization.\nEach node carries x/y/radius/color/label/hash/settlement_status.","operationId":"tenant_lattice_v1_portal__tenant_id__lattice_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Tenant Lattice V1 Portal  Tenant Id  Lattice Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/ledger":{"get":{"tags":["portal-spin"],"summary":"Tenant Ledger","description":"Full accounting ledger. Every charge and settlement with USDC tx hashes\nclickable to Basescan. Transparent, machine-verifiable.","operationId":"tenant_ledger_v1_portal__tenant_id__ledger_get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Tenant Ledger V1 Portal  Tenant Id  Ledger Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/reports/pull":{"post":{"tags":["portal-spin"],"summary":"Reports Pull","description":"Generate a report on demand. Returns structured report data.","operationId":"reports_pull_v1_portal__tenant_id__reports_pull_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PullReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reports Pull V1 Portal  Tenant Id  Reports Pull Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/reports/schedule":{"post":{"tags":["portal-spin"],"summary":"Reports Schedule","description":"Schedule a daily or weekly email report for the tenant.","operationId":"reports_schedule_v1_portal__tenant_id__reports_schedule_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reports Schedule V1 Portal  Tenant Id  Reports Schedule Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/portal/{tenant_id}/reports/reminders":{"post":{"tags":["portal-spin"],"summary":"Reports Reminders","description":"Set a custom alert/reminder. Condition format: metric>threshold e.g. volume>1000, error_rate>5.","operationId":"reports_reminders_v1_portal__tenant_id__reports_reminders_post","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reports Reminders V1 Portal  Tenant Id  Reports Reminders Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kimi/health":{"get":{"tags":["kimi","kimi"],"summary":"Kimi Health","description":"GET /v1/kimi/health — Returns model id, configured/not, last-call status, cumulative spend.\nAlways returns 200. configured=false until OPENROUTER_API_KEY is set on Render.","operationId":"kimi_health_v1_kimi_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/kimi/wisdom":{"post":{"tags":["kimi","kimi"],"summary":"Kimi Wisdom","description":"POST /v1/kimi/wisdom — Wisdom panel powered by Kimi K2.6.\nBuild #45 replaces the Grok call with Kimi K2.6 routing.\nFalls back to curated recommendations if OPENROUTER_API_KEY is not set.","operationId":"kimi_wisdom_v1_kimi_wisdom_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WisdomRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WisdomResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kimi/orchestrate":{"post":{"tags":["kimi","kimi"],"summary":"Kimi Orchestrate","description":"POST /v1/kimi/orchestrate — Multi-agent orchestration.\nTakes a goal + tool list, returns step-by-step plan with tool calls.\nRoutes to Kimi K2.6 (agent_orchestration=True). Fallback: curated plan.","operationId":"kimi_orchestrate_v1_kimi_orchestrate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kimi/long-horizon":{"post":{"tags":["kimi","kimi"],"summary":"Kimi Long Horizon","description":"POST /v1/kimi/long-horizon — 200+ step deep-reasoning task.\nRuns Kimi's deep-thinking mode; returns final result + reasoning trace.","operationId":"kimi_long_horizon_v1_kimi_long_horizon_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LongHorizonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LongHorizonResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/kimi/code":{"post":{"tags":["kimi","kimi"],"summary":"Kimi Code","description":"POST /v1/kimi/code — Code generation surface.\nGenerates ship reports, smoke tests, and integration glue via Kimi K2.6.","operationId":"kimi_code_v1_kimi_code_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/checkout":{"post":{"tags":["billing"],"summary":"Billing Checkout","description":"Create a Square payment link for the given tier.\nIf Square is unreachable or SQUARE_ACCESS_TOKEN is absent, return a\npre-seeded fallback URL so the frontend always gets a clickable link.","operationId":"billing_checkout_v1_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Checkout V1 Billing Checkout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/usdc/intent":{"post":{"tags":["billing"],"summary":"Billing Usdc Intent","description":"Generate a USDC-on-Base payment intent.\nReturns treasury address, USDC contract, amount, and expiry.\nPersists intent to /tmp/hive_billing/intents.ndjson.","operationId":"billing_usdc_intent_v1_billing_usdc_intent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/USDCIntentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Usdc Intent V1 Billing Usdc Intent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/square/webhook":{"post":{"tags":["billing"],"summary":"Billing Square Webhook","description":"Square webhook receiver.\nOn payment.updated / invoice.payment_made, flips tenant active in tenants.json.\nHMAC-verifies against SQUARE_WEBHOOK_SIGNATURE_KEY if set; otherwise accepts\nand logs a warning.","operationId":"billing_square_webhook_v1_billing_square_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Square Webhook V1 Billing Square Webhook Post"}}}}}}},"/v1/billing/tenant/{tenant_id}":{"get":{"tags":["billing"],"summary":"Billing Tenant","description":"Return billing state for a tenant.","operationId":"billing_tenant_v1_billing_tenant__tenant_id__get","parameters":[{"name":"tenant_id","in":"path","required":true,"schema":{"type":"string","title":"Tenant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Billing Tenant V1 Billing Tenant  Tenant Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/meter/health":{"get":{"tags":["billing-meter"],"summary":"Meter Health","description":"Public — describes the meter schema, prices, and supported chains.","operationId":"meter_health_v1_billing_meter_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Meter Health V1 Billing Meter Health Get"}}}}}}},"/v1/billing/activate":{"post":{"tags":["billing-meter"],"summary":"Meter Activate","description":"Bind an activation key (and optionally a wallet) to a metered account.\nIdempotent — activating the same key twice returns the same account.","operationId":"meter_activate_v1_billing_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Meter Activate V1 Billing Activate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/usage/{account_id}":{"get":{"tags":["billing-meter"],"summary":"Meter Usage","description":"Signed usage snapshot for an account. Verify via /v1/receipt/verify.","operationId":"meter_usage_v1_billing_usage__account_id__get","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Meter Usage V1 Billing Usage  Account Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/topup/intent":{"post":{"tags":["billing-meter"],"summary":"Meter Topup Intent","description":"Create a USDC top-up intent. Returns treasury address + amount + memo.","operationId":"meter_topup_intent_v1_billing_topup_intent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopupIntentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Meter Topup Intent V1 Billing Topup Intent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/topup/{intent_id}":{"get":{"tags":["billing-meter"],"summary":"Meter Topup Status","description":"Check settlement status of a topup intent.","operationId":"meter_topup_status_v1_billing_topup__intent_id__get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Meter Topup Status V1 Billing Topup  Intent Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/whoami":{"get":{"tags":["billing-meter"],"summary":"Whoami","description":"Resolve activation key → account_id. Useful for the /billing/ dashboard.","operationId":"whoami_v1_billing_whoami_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Whoami V1 Billing Whoami Get"}}}}}}},"/v1/qvac/provider/register":{"post":{"tags":["qvac"],"summary":"Register Provider","operationId":"register_provider_v1_qvac_provider_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterProviderBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Provider V1 Qvac Provider Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/list":{"get":{"tags":["qvac"],"summary":"List Providers","operationId":"list_providers_v1_qvac_provider_list_get","parameters":[{"name":"listed_only","in":"query","required":false,"schema":{"type":"boolean","description":"If true, only return providers cleared by 3-gate.","default":false,"title":"Listed Only"},"description":"If true, only return providers cleared by 3-gate."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Providers V1 Qvac Provider List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/{provider_id}":{"get":{"tags":["qvac"],"summary":"Get Provider","operationId":"get_provider_v1_qvac_provider__provider_id__get","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Provider V1 Qvac Provider  Provider Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/provider/{provider_id}/unregister":{"post":{"tags":["qvac"],"summary":"Unregister Provider","operationId":"unregister_provider_v1_qvac_provider__provider_id__unregister_post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unregister Provider V1 Qvac Provider  Provider Id  Unregister Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/inference/request":{"post":{"tags":["qvac"],"summary":"Inference Request","operationId":"inference_request_v1_qvac_inference_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Inference Request V1 Qvac Inference Request Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/inference/request/public":{"post":{"tags":["qvac"],"summary":"Inference Request Public","description":"Public x402-gated variant of /v1/qvac/inference/request.\n\nWithout X-Payment: returns HTTP 402 + x402 challenge body\nWith valid X-Payment: returns the inference receipt\nWith invalid X-Payment: returns HTTP 402 + INVALID_PAYMENT_PROOF","operationId":"inference_request_public_v1_qvac_inference_request_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/leaderboard":{"get":{"tags":["qvac"],"summary":"Leaderboard","operationId":"leaderboard_v1_qvac_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard V1 Qvac Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/agent_c/spread":{"get":{"tags":["qvac"],"summary":"Agent C Spread","operationId":"agent_c_spread_v1_qvac_agent_c_spread_get","parameters":[{"name":"notional_usd","in":"query","required":false,"schema":{"type":"number","minimum":0,"default":0.001,"title":"Notional Usd"}},{"name":"listed_only","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Listed Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent C Spread V1 Qvac Agent C Spread Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/qvac/models":{"get":{"tags":["qvac"],"summary":"Models Catalog","operationId":"models_catalog_v1_qvac_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Models Catalog V1 Qvac Models Get"}}}}}}},"/v1/qvac/stats":{"get":{"tags":["qvac"],"summary":"Stats","operationId":"stats_v1_qvac_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Qvac Stats Get"}}}}}}},"/v1/qvac/economics":{"get":{"tags":["qvac"],"summary":"Economics","description":"Cumulative HiveCompute 3% spread take + forward projection at varying\ninference volumes. Mock pricing: avg $0.0008 per inference (geometric mean\nacross LLM, embedding, TTS at typical token counts).","operationId":"economics_v1_qvac_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Qvac Economics Get"}}}}}}},"/v1/desci/qvac/scan":{"post":{"tags":["desci-qvac"],"summary":"Trigger Scan","description":"Run one scan pass. If no analyst exists, a default one is created\n(`QVAC-RA-Prime`). On first call, seeds 5 mock findings unless\n`seed_if_empty=False`.","operationId":"trigger_scan_v1_desci_qvac_scan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanRequest","default":{"seed_if_empty":true}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Trigger Scan V1 Desci Qvac Scan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings":{"get":{"tags":["desci-qvac"],"summary":"List Findings","operationId":"list_findings_v1_desci_qvac_findings_get","parameters":[{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by tier_1|tier_2|tier_3","title":"Severity"},"description":"Filter by tier_1|tier_2|tier_3"},{"name":"qvac_module","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qvac Module"}},{"name":"discovered_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovered By"}},{"name":"include_purchased","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Purchased"}},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Findings V1 Desci Qvac Findings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings/{node_id}":{"get":{"tags":["desci-qvac"],"summary":"Get Finding","operationId":"get_finding_v1_desci_qvac_findings__node_id__get","parameters":[{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Finding V1 Desci Qvac Findings  Node Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/findings/{node_id}/purchase":{"post":{"tags":["desci-qvac"],"summary":"Purchase Finding","operationId":"purchase_finding_v1_desci_qvac_findings__node_id__purchase_post","parameters":[{"name":"node_id","in":"path","required":true,"schema":{"type":"string","title":"Node Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Purchase Finding V1 Desci Qvac Findings  Node Id  Purchase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/leaderboard":{"get":{"tags":["desci-qvac"],"summary":"Leaderboard","operationId":"leaderboard_v1_desci_qvac_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard V1 Desci Qvac Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/desci/qvac/analysts":{"get":{"tags":["desci-qvac"],"summary":"List Analysts","operationId":"list_analysts_v1_desci_qvac_analysts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Analysts V1 Desci Qvac Analysts Get"}}}}}}},"/v1/desci/qvac/stats":{"get":{"tags":["desci-qvac"],"summary":"Stats","operationId":"stats_v1_desci_qvac_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V1 Desci Qvac Stats Get"}}}}}}},"/v1/perp/basis/open":{"post":{"tags":["basis-perp"],"summary":"Open Position","operationId":"open_position_v1_perp_basis_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Open Position V1 Perp Basis Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/close":{"post":{"tags":["basis-perp"],"summary":"Close Position Endpoint","operationId":"close_position_endpoint_v1_perp_basis_close_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Close Position Endpoint V1 Perp Basis Close Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/increase":{"post":{"tags":["basis-perp"],"summary":"Increase Position Endpoint","operationId":"increase_position_endpoint_v1_perp_basis_increase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncreaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Increase Position Endpoint V1 Perp Basis Increase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/decrease":{"post":{"tags":["basis-perp"],"summary":"Decrease Position Endpoint","operationId":"decrease_position_endpoint_v1_perp_basis_decrease_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecreaseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Decrease Position Endpoint V1 Perp Basis Decrease Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/liquidate":{"post":{"tags":["basis-perp"],"summary":"Liquidate Endpoint","operationId":"liquidate_endpoint_v1_perp_basis_liquidate_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiquidateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Liquidate Endpoint V1 Perp Basis Liquidate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/funding/tick":{"post":{"tags":["basis-perp"],"summary":"Funding Tick Endpoint","operationId":"funding_tick_endpoint_v1_perp_basis_funding_tick_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Funding Tick Endpoint V1 Perp Basis Funding Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/positions":{"get":{"tags":["basis-perp"],"summary":"List Positions Endpoint","operationId":"list_positions_endpoint_v1_perp_basis_positions_get","parameters":[{"name":"owner_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Did"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Positions Endpoint V1 Perp Basis Positions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/position/{position_id}":{"get":{"tags":["basis-perp"],"summary":"Get Position Endpoint","operationId":"get_position_endpoint_v1_perp_basis_position__position_id__get","parameters":[{"name":"position_id","in":"path","required":true,"schema":{"type":"string","title":"Position Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Position Endpoint V1 Perp Basis Position  Position Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/market":{"get":{"tags":["basis-perp"],"summary":"Market State Endpoint","operationId":"market_state_endpoint_v1_perp_basis_market_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Market State Endpoint V1 Perp Basis Market Get"}}}}}}},"/v1/perp/basis/leaderboard":{"get":{"tags":["basis-perp"],"summary":"Leaderboard Endpoint","operationId":"leaderboard_endpoint_v1_perp_basis_leaderboard_get","parameters":[{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard Endpoint V1 Perp Basis Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/perp/basis/gates":{"get":{"tags":["basis-perp"],"summary":"Gates Endpoint","operationId":"gates_endpoint_v1_perp_basis_gates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Gates Endpoint V1 Perp Basis Gates Get"}}}}}}},"/v1/perp/basis/health":{"get":{"tags":["basis-perp"],"summary":"Health Endpoint","operationId":"health_endpoint_v1_perp_basis_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Endpoint V1 Perp Basis Health Get"}}}}}}},"/v1/forge/agent/qvac_provider/list":{"post":{"tags":["forge"],"summary":"List Qvac Provider","operationId":"list_qvac_provider_v1_forge_agent_qvac_provider_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Qvac Provider V1 Forge Agent Qvac Provider List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agents":{"get":{"tags":["forge"],"summary":"Get Agents","operationId":"get_agents_v1_forge_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Forge Agents Get"}}}}}}},"/v1/forge/agent/qvac_provider":{"get":{"tags":["forge"],"summary":"Get Qvac Provider","operationId":"get_qvac_provider_v1_forge_agent_qvac_provider_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Qvac Provider V1 Forge Agent Qvac Provider Get"}}}}}}},"/v1/forge/agent/qvac_provider/invoke":{"post":{"tags":["forge"],"summary":"Invoke Qvac Provider","operationId":"invoke_qvac_provider_v1_forge_agent_qvac_provider_invoke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvokeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Invoke Qvac Provider V1 Forge Agent Qvac Provider Invoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agent/qvac_provider/invoke/public":{"post":{"tags":["forge"],"summary":"Invoke Qvac Provider Public","description":"Public x402-gated forge invoke.\n\nWithout X-Payment: HTTP 402 + x402 challenge body\nWith valid X-Payment: runs three-gate + qvac inference and returns\n                      the same response shape as the non-/public route\nWith invalid X-Payment: HTTP 402 + INVALID_PAYMENT_PROOF","operationId":"invoke_qvac_provider_public_v1_forge_agent_qvac_provider_invoke_public_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvokeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forge/agent/qvac_provider/economics":{"get":{"tags":["forge"],"summary":"Economics Qvac Provider","operationId":"economics_qvac_provider_v1_forge_agent_qvac_provider_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics Qvac Provider V1 Forge Agent Qvac Provider Economics Get"}}}}}}},"/v1/law/freight/template/list":{"post":{"tags":["law"],"summary":"List Freight Arbitration","operationId":"list_freight_arbitration_v1_law_freight_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Freight Arbitration V1 Law Freight Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/agents":{"get":{"tags":["law"],"summary":"Get Agents","operationId":"get_agents_v1_law_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Law Agents Get"}}}}}}},"/v1/law/freight/template":{"get":{"tags":["law"],"summary":"Get Freight Template","operationId":"get_freight_template_v1_law_freight_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Freight Template V1 Law Freight Template Get"}}}}}}},"/v1/law/freight/contract":{"post":{"tags":["law"],"summary":"Post Freight Contract","operationId":"post_freight_contract_v1_law_freight_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Contract V1 Law Freight Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/contract/{contract_id}":{"get":{"tags":["law"],"summary":"Get Freight Contract","operationId":"get_freight_contract_v1_law_freight_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Freight Contract V1 Law Freight Contract  Contract Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/dispute":{"post":{"tags":["law"],"summary":"Post Freight Dispute","operationId":"post_freight_dispute_v1_law_freight_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Dispute V1 Law Freight Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/webhook":{"post":{"tags":["law"],"summary":"Post Freight Webhook","description":"Public webhook for SMB-broker freight exception events. Accepts the\ncanonical exception-event shape (suitable for posting from webhook.site,\nZapier, n8n, an in-house ERP, or any generic HTTP poster). Vendor-shaped\npayloads matching the project44 / C.H. Robinson / Hwy Haul schemas are\nalso accepted as schema-compatible test targets — those vendors are NOT\nintegration partners (R3 council: enterprise platforms are closed\nsystems). Translates the payload into a HiveLaw dispute filing and\nresolves it inline.","operationId":"post_freight_webhook_v1_law_freight_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Freight Webhook V1 Law Freight Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/dispute/{dispute_id}":{"get":{"tags":["law"],"summary":"Get Freight Dispute","operationId":"get_freight_dispute_v1_law_freight_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Freight Dispute V1 Law Freight Dispute  Dispute Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/freight/economics":{"get":{"tags":["law"],"summary":"Freight Economics","operationId":"freight_economics_v1_law_freight_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Freight Economics V1 Law Freight Economics Get"}}}}}}},"/v1/law/insurance/template/list":{"post":{"tags":["law","insurance"],"summary":"List Insurance Arbitration","operationId":"list_insurance_arbitration_v1_law_insurance_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Insurance Arbitration V1 Law Insurance Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/agents":{"get":{"tags":["law","insurance"],"summary":"Get Agents","operationId":"get_agents_v1_law_insurance_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Law Insurance Agents Get"}}}}}}},"/v1/law/insurance/template":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Template","operationId":"get_insurance_template_v1_law_insurance_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Insurance Template V1 Law Insurance Template Get"}}}}}}},"/v1/law/insurance/contract":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Contract","operationId":"post_insurance_contract_v1_law_insurance_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__insurance_routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Contract V1 Law Insurance Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/contract/{contract_id}":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Contract Detail","operationId":"get_insurance_contract_detail_v1_law_insurance_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Insurance Contract Detail V1 Law Insurance Contract  Contract Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/dispute":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Dispute","operationId":"post_insurance_dispute_v1_law_insurance_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_law__insurance_routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Dispute V1 Law Insurance Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/webhook":{"post":{"tags":["law","insurance"],"summary":"Post Insurance Webhook","description":"Public webhook for MGA / non-admitted-carrier insurance exception\nevents. Accepts the canonical exception-event shape (see\ninsurance_webhook.py). Cytora Autopilot and CoverGo Claims payload\nshapes are accepted as schema-compatible test targets — those\nvendors are NOT integration partners (R3 council). Translates the\npayload into a HiveLaw insurance dispute filing and resolves it\ninline. Every outcome carries `requires_human_review` per Florida\nHB 527 / NAIC Model Bulletin / EU AI Act high-risk requirements.","operationId":"post_insurance_webhook_v1_law_insurance_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Insurance Webhook V1 Law Insurance Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/dispute/{dispute_id}":{"get":{"tags":["law","insurance"],"summary":"Get Insurance Dispute","operationId":"get_insurance_dispute_v1_law_insurance_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Insurance Dispute V1 Law Insurance Dispute  Dispute Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/law/insurance/economics":{"get":{"tags":["law","insurance"],"summary":"Insurance Economics","operationId":"insurance_economics_v1_law_insurance_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Insurance Economics V1 Law Insurance Economics Get"}}}}}}},"/v1/exchange/agent_asset/list":{"post":{"tags":["aris-agent-asset"],"summary":"List Agent Asset","operationId":"list_agent_asset_v1_exchange_agent_asset_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAssetListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Agent Asset V1 Exchange Agent Asset List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/open":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Open","operationId":"perp_open_v1_exchange_agent_asset_perp_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpOpenBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Perp Open V1 Exchange Agent Asset Perp Open Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/close":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Close","operationId":"perp_close_v1_exchange_agent_asset_perp_close_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpCloseBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Perp Close V1 Exchange Agent Asset Perp Close Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/funding/tick":{"post":{"tags":["aris-agent-asset"],"summary":"Perp Funding Tick","operationId":"perp_funding_tick_v1_exchange_agent_asset_perp_funding_tick_post","parameters":[{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}},{"name":"X-Hive-Trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingTickBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Funding Tick V1 Exchange Agent Asset Perp Funding Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/market":{"get":{"tags":["aris-agent-asset"],"summary":"Perp Market","operationId":"perp_market_v1_exchange_agent_asset_perp_market_get","parameters":[{"name":"underlying_key","in":"query","required":true,"schema":{"type":"string","title":"Underlying Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Market V1 Exchange Agent Asset Perp Market Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchange/agent_asset/perp/position/{position_id}":{"get":{"tags":["aris-agent-asset"],"summary":"Perp Position","operationId":"perp_position_v1_exchange_agent_asset_perp_position__position_id__get","parameters":[{"name":"position_id","in":"path","required":true,"schema":{"type":"string","title":"Position Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Perp Position V1 Exchange Agent Asset Perp Position  Position Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings":{"get":{"tags":["hive-agent-listings"],"summary":"List Listings","operationId":"list_listings_v1_agent_listings_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"provider_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Listings V1 Agent Listings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings/{agent_id}":{"get":{"tags":["hive-agent-listings"],"summary":"Get Listing","operationId":"get_listing_v1_agent_listings__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Listing V1 Agent Listings  Agent Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/listings/depin":{"post":{"tags":["hive-agent-listings"],"summary":"List Depin Provider","operationId":"list_depin_provider_v1_agent_listings_depin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepinListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Depin Provider V1 Agent Listings Depin Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent-card.json":{"get":{"tags":["a2a"],"summary":"A2A v0.2 top-level Agent Card catalog","description":"Returns all 5 published Hive Agent Cards in a single A2A v0.2 catalog payload. This is the well-known discovery URL crawled by Azure AI Foundry, AWS Bedrock Agents, Google Cloud, and Agentverse-style A2A registries.","operationId":"well_known_catalog__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agents/{agent_id}/card.json":{"get":{"tags":["a2a"],"summary":"A2A v0.2 per-agent card","description":"Per-agent A2A v0.2 Agent Card by agent_id. Returns 404 if the agent_id is not registered in Hive's A2A directory.","operationId":"well_known_agent_card__well_known_agents__agent_id__card_json_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/a2a/cards":{"get":{"tags":["a2a"],"summary":"List published A2A Agent Cards","description":"Convenience endpoint mirroring /.well-known/agent-card.json. Always free (discovery).","operationId":"list_cards_v1_a2a_cards_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/a2a/cards/{agent_id}":{"get":{"tags":["a2a"],"summary":"Get a single A2A Agent Card","description":"Convenience alias for /.well-known/agents/{agent_id}/card.json.","operationId":"get_card_v1_a2a_cards__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/a2a/harness:run-loop":{"post":{"tags":["a2a"],"summary":"Run HARNESS internal agent loop","description":"Executes the full internal agent loop: discovery → quote → emit → verify → stats. All steps use x-hive-source: HARNESS so traffic is counted under harness_calls, not calls_paid. Revenue counters are never touched by harness traffic. Returns a combined 5-step report.","operationId":"harness_run_loop_v1_a2a_harness_run_loop_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/a2a/agents":{"get":{"tags":["a2a"],"summary":"List published A2A Agent Cards (agents alias)","description":"Alias for /v1/a2a/cards. Returns the same payload. Resolves the /v1/a2a/agents path that agents expect.","operationId":"list_agents_v1_a2a_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/a2a/agents/{agent_id}":{"get":{"tags":["a2a"],"summary":"Get a single A2A Agent Card (agents alias)","description":"Alias for /v1/a2a/cards/{agent_id}.","operationId":"get_agent_v1_a2a_agents__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/a2a/handshake":{"get":{"tags":["a2a","a2a"],"summary":"A2A v0.2 handshake — GET returns schema, POST executes","description":"Free schema hint endpoint. POST the same path to execute a real handshake.\nSee https://hivemorph.onrender.com/.well-known/agent-card.json for the full agent card.","operationId":"a2a_handshake_schema_v1_a2a_handshake_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response A2A Handshake Schema V1 A2A Handshake Get"}}}}}},"post":{"tags":["a2a"],"summary":"Initiate an A2A handshake with Hive Civilization","description":"Establishes an A2A v0.2 session. Returns the agreed protocol version, supported transports, the canonical Agent Card URL, x402 payment posture, and a session_id. No persistent state is created — the session_id is a 128-bit nonce the caller can include in subsequent JSON-RPC calls for correlation. Always free (discovery-class endpoint).","operationId":"a2a_handshake_v1_a2a_handshake_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HandshakeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/attestation/status":{"get":{"tags":["a2a"],"summary":"Hive attestation system status","description":"Returns a single-read summary of the attestation surface: key material present, attestation routers loaded, family availability (passport / custody / cargo / warranty / sanctions), and current pricing tier. Always free (health-class endpoint).","operationId":"attestation_status_v1_attestation_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/manifest":{"get":{"tags":["r2-discovery"],"summary":"Hivemorph plugin manifest (ChatGPT/MCP-style)","description":"OpenAI-plugin-shaped manifest with discovery pointers, the OpenAPI URL, the A2A transport endpoint, the MCP descriptor, and the R1 receipt-profile schema.","operationId":"get_manifest_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/a2a":{"get":{"tags":["r2-discovery"],"summary":"A2A v0.2 transport descriptor","description":"Lists the supported JSON-RPC 2.0 methods, the protocol version, the transport endpoint, and pointers to the catalog + manifest. POST JSON-RPC payloads to this same path.","operationId":"get_a2a_descriptor_a2a_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["r2-discovery"],"summary":"A2A v0.2 JSON-RPC 2.0 transport","description":"JSON-RPC 2.0 endpoint. Supports single requests and batch arrays. Methods: agent.discover, agent.card, receipt.emit, receipt.verify, pricing.read, rubric.select. Settlement actions return delegation envelopes pointing at the canonical REST endpoints — peers complete settlement themselves.","operationId":"post_a2a_a2a_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/a2a.json":{"get":{"tags":["r2-discovery"],"summary":"A2A v0.2 transport descriptor (well-known alias)","description":"Spec-mandated well-known alias for /a2a (locked spec section 1a). Returns the same A2A v0.2 transport descriptor so crawlers that discover by /.well-known/* convention reach the JSON-RPC surface on the first read. Always free.","operationId":"well_known_a2a__well_known_a2a_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status":{"get":{"tags":["r2-discovery"],"summary":"Public status surface","description":"Live status of hivemorph: deploy commit, process uptime, discovery URLs, and per-layer status (R1-R12) with strict LIVE / PILOT / ROADMAP discipline.","operationId":"get_status_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/a2a/status":{"get":{"tags":["r2-discovery"],"summary":"Public status surface (A2A path alias)","description":"Alias for /status. Provided so the A2A surface listing and any cross-ecosystem manifest that resolves agent status under /v1/a2a/* can hit the same payload.","operationId":"get_status_a2a_alias_v1_a2a_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/transaction-harness":{"get":{"tags":["r2-discovery"],"summary":"Machine-readable 14-stage transaction harness","description":"JSON companion to the public /transaction-harness HTML walkthrough. Every stage carries a strict label (LIVE / SAMPLE / PILOT / ROADMAP / SYNTHETIC), the canonical live endpoints involved, and the path to the signed sample artifact. No stage is labelled LIVE unless the underlying surface responds with signed bytes today.","operationId":"get_transaction_harness_v1_transaction_harness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/delegation/issue":{"post":{"tags":["r3-delegation"],"summary":"Soft-issue a delegation envelope (Hive operator signer)","description":"Pilot path — Hive's soft-operator signer (`did:hive:operator-default`) signs the envelope on behalf of the caller and the issuer signer counter-stamps. Production operators should use `/v1/delegation/operator-sign` with their own keypair.","operationId":"issue_v1_delegation_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/delegation/operator-sign":{"post":{"tags":["r3-delegation"],"summary":"Counter-stamp an operator-signed envelope","description":"Caller submits an envelope already signed with their operator Ed25519 keypair. Hive verifies the operator signature, counter-stamps with the delegation-issuer signer, persists the envelope, and returns the fully-stamped result.","operationId":"operator_sign_v1_delegation_operator_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorSignReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/delegation/verify":{"post":{"tags":["r3-delegation"],"summary":"Verify a delegation envelope","description":"Verifies operator + issuer signatures, expiry, and revocation. Returns a structured DelegationVerifyResult. Free.","operationId":"verify_v1_delegation_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_r3__routes__VerifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/delegation/revoke/{jti}":{"post":{"tags":["r3-delegation"],"summary":"Revoke a delegation by jti","description":"Marks the delegation as revoked. Verification will return verified:false and reasons:['revoked', ...]. Free.","operationId":"revoke_v1_delegation_revoke__jti__post","parameters":[{"name":"jti","in":"path","required":true,"schema":{"type":"string","minLength":16,"maxLength":64,"pattern":"^[0-9a-f]{16,64}$","title":"Jti"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/delegation/pubkey":{"get":{"tags":["r3-delegation"],"summary":"Issuer + soft-operator public keys","operationId":"pubkey_v1_delegation_pubkey_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/delegation/{jti}":{"get":{"tags":["r3-delegation"],"summary":"Fetch a stored delegation by jti","operationId":"get_one_v1_delegation__jti__get","parameters":[{"name":"jti","in":"path","required":true,"schema":{"type":"string","minLength":16,"maxLength":64,"pattern":"^[0-9a-f]{16,64}$","title":"Jti"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/evaluate":{"post":{"tags":["r3-delegation"],"summary":"R4 preview — evaluate a request against a delegation envelope","description":"Pure decision contract. Returns one of: allow, block, sandbox, require_shod_cosign, require_hive_pq, require_human_approval. R4 enforcement on every mediated tool call lands in a follow-up ship; this endpoint is the public surface partners can program against today.","operationId":"firewall_eval_v1_firewall_evaluate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirewallEvalReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/delegation/check":{"post":{"tags":["r3-delegation"],"summary":"Single-call envelope verification + firewall decision + next-best-actions","description":"Combines /v1/delegation/verify and /v1/firewall/evaluate into one round trip. Caller supplies a stored envelope jti (or an inline envelope) plus a request context; response carries (a) the verification result, (b) the firewall decision, and (c) next-best-actions pointing to the right remediation surface (re-issue, raise cap, upgrade to Hive-PQ, request co-sign, request human approval).\n\nThis is the surface agents call before every gated action. Free.","operationId":"delegation_check_v1_delegation_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegationCheckReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/policy":{"get":{"tags":["r4-firewall"],"summary":"Firewall enforcement policy contract","description":"Machine-readable description of how the Hive Tool Firewall behaves. Partners program against this contract and the /v1/firewall/evaluate decision shape (R3) so their delegation envelopes produce predictable enforcement.","operationId":"policy_v1_firewall_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/firewall/enforce/preview":{"post":{"tags":["r4-firewall"],"summary":"Dry-run firewall enforcement against any envelope","description":"Same as /v1/firewall/evaluate but returns the full enforcement envelope including the HTTP status the live middleware would emit and any side-effect ticket ids that would be issued. No ticket is actually persisted — this is purely a preview path.","operationId":"enforce_preview_v1_firewall_enforce_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnforcePreviewReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/sandbox/run":{"post":{"tags":["r4-firewall"],"summary":"Run a request in sandbox (no settlement)","description":"Echo-back sandbox path. Confirms the envelope authorizes the request in sandbox mode, returns a synthetic result, and records nothing on any settlement layer. Real handlers integrate sandbox via `request.state.firewall_sandbox` from the firewall middleware.","operationId":"sandbox_run_v1_firewall_sandbox_run_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SandboxRunReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/cosign/challenge":{"post":{"tags":["r4-firewall"],"summary":"Create a Threshold-SHOD cosign challenge","operationId":"cosign_create_v1_firewall_cosign_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CosignChallengeReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/cosign/challenge/{challenge_id}":{"get":{"tags":["r4-firewall"],"summary":"Fetch a cosign challenge","operationId":"cosign_get_v1_firewall_cosign_challenge__challenge_id__get","parameters":[{"name":"challenge_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"title":"Challenge Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/cosign/challenge/{challenge_id}/sign":{"post":{"tags":["r4-firewall"],"summary":"Record a cosignature against a challenge","description":"Records a cosignature from one of the required signers. Once the threshold is reached, the challenge is consumed and the agent may retry the original request with X-Hive-Cosign: <challenge_id>. R11 (Threshold SHOD-PQ) ships full multi-party verification; today the signature is recorded as a placeholder for the bind.","operationId":"cosign_sign_v1_firewall_cosign_challenge__challenge_id__sign_post","parameters":[{"name":"challenge_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"title":"Challenge Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CosignSignReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/approval/request":{"post":{"tags":["r4-firewall"],"summary":"Create a human-approval ticket","operationId":"approval_request_v1_firewall_approval_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/approval/{ticket_id}":{"get":{"tags":["r4-firewall"],"summary":"Fetch an approval ticket","operationId":"approval_get_v1_firewall_approval__ticket_id__get","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"title":"Ticket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/firewall/approval/{ticket_id}/decide":{"post":{"tags":["r4-firewall"],"summary":"Approve or deny a ticket","operationId":"approval_decide_v1_firewall_approval__ticket_id__decide_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecideReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/rep/policy":{"get":{"tags":["r5-hktn-reputation"],"summary":"Rep Policy","operationId":"rep_policy_v1_hktn_rep_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/hktn/rep/leaderboard":{"get":{"tags":["r5-hktn-reputation"],"summary":"Rep Leaderboard","operationId":"rep_leaderboard_v1_hktn_rep_leaderboard_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/rep/event":{"post":{"tags":["r5-hktn-reputation"],"summary":"Rep Event","operationId":"rep_event_v1_hktn_rep_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepEventReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/rep/preview":{"post":{"tags":["r5-hktn-reputation"],"summary":"Rep Preview","operationId":"rep_preview_v1_hktn_rep_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepPreviewReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hktn/rep/{agent_did}":{"get":{"tags":["r5-hktn-reputation"],"summary":"Rep Get","operationId":"rep_get_v1_hktn_rep__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","title":"Agent Did"}},{"name":"history","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":25,"title":"History"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/policy":{"get":{"tags":["r6-hivememory"],"summary":"Memory Policy","operationId":"memory_policy_v1_memory_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/memory/write":{"post":{"tags":["r6-hivememory"],"summary":"Memory Write","operationId":"memory_write_v1_memory_write_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_r6__routes__WriteReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/list":{"get":{"tags":["r6-hivememory"],"summary":"Memory List","operationId":"memory_list_v1_memory_list_get","parameters":[{"name":"agent_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Agent Did"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Kind"}},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Scope"}},{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Revoked"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/revoke/{mid}":{"post":{"tags":["r6-hivememory"],"summary":"Memory Revoke","operationId":"memory_revoke_v1_memory_revoke__mid__post","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/export/{agent_did}":{"get":{"tags":["r6-hivememory"],"summary":"Memory Export","operationId":"memory_export_v1_memory_export__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":200,"title":"Agent Did"}},{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Revoked"}},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/memory/{mid}":{"get":{"tags":["r6-hivememory"],"summary":"Memory Get","operationId":"memory_get_v1_memory__mid__get","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spectral/policy":{"get":{"tags":["r7-spectral"],"summary":"Spectral Policy","operationId":"spectral_policy_v1_spectral_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/spectral/stats":{"get":{"tags":["r7-spectral"],"summary":"Spectral Stats","operationId":"spectral_stats_v1_spectral_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/spectral/observe":{"post":{"tags":["r7-spectral"],"summary":"Spectral Observe","operationId":"spectral_observe_v1_spectral_observe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObserveReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spectral/evaluate":{"post":{"tags":["r7-spectral"],"summary":"Spectral Evaluate","operationId":"spectral_evaluate_v1_spectral_evaluate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluateReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spectral/{agent_did}/observations":{"get":{"tags":["r7-spectral"],"summary":"Spectral Observations","operationId":"spectral_observations_v1_spectral__agent_did__observations_get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":200,"title":"Agent Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spectral/{agent_did}/alerts":{"get":{"tags":["r7-spectral"],"summary":"Spectral Alerts","operationId":"spectral_alerts_v1_spectral__agent_did__alerts_get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":200,"title":"Agent Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/spectral/{agent_did}":{"get":{"tags":["r7-spectral"],"summary":"Spectral Fingerprint","operationId":"spectral_fingerprint_v1_spectral__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":200,"title":"Agent Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/policy":{"get":{"tags":["r8-checkpoints"],"summary":"Checkpoint Policy","operationId":"checkpoint_policy_v1_checkpoint_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/checkpoint/write":{"post":{"tags":["r8-checkpoints"],"summary":"Checkpoint Write","operationId":"checkpoint_write_v1_checkpoint_write_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_r8__routes__WriteReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/list":{"get":{"tags":["r8-checkpoints"],"summary":"Checkpoint List","operationId":"checkpoint_list_v1_checkpoint_list_get","parameters":[{"name":"wid","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Wid"}},{"name":"agent_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Agent Did"}},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Phase"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/workflow/{wid}":{"get":{"tags":["r8-checkpoints"],"summary":"Checkpoint Workflow","operationId":"checkpoint_workflow_v1_checkpoint_workflow__wid__get","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/archive/{wid}":{"post":{"tags":["r8-checkpoints"],"summary":"Checkpoint Archive","operationId":"checkpoint_archive_v1_checkpoint_archive__wid__post","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/replay/{wid}":{"get":{"tags":["r8-checkpoints"],"summary":"Checkpoint Replay","operationId":"checkpoint_replay_v1_checkpoint_replay__wid__get","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/checkpoint/{cid}":{"get":{"tags":["r8-checkpoints"],"summary":"Checkpoint Get","operationId":"checkpoint_get_v1_checkpoint__cid__get","parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Cid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/policy":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Policy","operationId":"accumulator_policy_v1_accumulator_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/accumulator/anchor":{"post":{"tags":["r9-accumulators"],"summary":"Accumulator Anchor","operationId":"accumulator_anchor_v1_accumulator_anchor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnchorReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/{domain}/root":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Root","operationId":"accumulator_root_v1_accumulator__domain__root_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/{domain}/leaves":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Leaves","operationId":"accumulator_leaves_v1_accumulator__domain__leaves_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Domain"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/{domain}/replay":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Replay","operationId":"accumulator_replay_v1_accumulator__domain__replay_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/{domain}/inclusion":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Inclusion","operationId":"accumulator_inclusion_v1_accumulator__domain__inclusion_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Domain"}},{"name":"key","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/{domain}/non-membership":{"get":{"tags":["r9-accumulators"],"summary":"Accumulator Non Membership","operationId":"accumulator_non_membership_v1_accumulator__domain__non_membership_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Domain"}},{"name":"key","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accumulator/verify":{"post":{"tags":["r9-accumulators"],"summary":"Accumulator Verify","operationId":"accumulator_verify_v1_accumulator_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_r9__routes__VerifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/policy":{"get":{"tags":["r10-rvc"],"summary":"Rvc Policy","operationId":"rvc_policy_v1_rvc_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/rvc/srs":{"get":{"tags":["r10-rvc"],"summary":"Rvc Srs","operationId":"rvc_srs_v1_rvc_srs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/rvc/commit":{"post":{"tags":["r10-rvc"],"summary":"Rvc Commit","operationId":"rvc_commit_v1_rvc_commit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/open":{"post":{"tags":["r10-rvc"],"summary":"Rvc Open","operationId":"rvc_open_v1_rvc_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/batch-open":{"post":{"tags":["r10-rvc"],"summary":"Rvc Batch Open","description":"v0.1: produces N independent Merkle openings in one call. The §11\npatent claim allows v0.2 to compress these into a single 48-byte\naggregate KZG proof. Wire shape today returns a list of openings.","operationId":"rvc_batch_open_v1_rvc_batch_open_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchOpenReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/verify":{"post":{"tags":["r10-rvc"],"summary":"Rvc Verify","description":"Stateless verifier. Returns 200 with valid:true|false except where\nthe request itself is malformed:\n  - unknown commitment_id → 404\n  - rubric_root mismatch  → 409 (cross-rubric replay attempt)","operationId":"rvc_verify_v1_rvc_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_r10__routes__VerifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/{commitment_id}":{"get":{"tags":["r10-rvc"],"summary":"Rvc Get","operationId":"rvc_get_v1_rvc__commitment_id__get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","minLength":4,"maxLength":64,"title":"Commitment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rvc/{commitment_id}/openings":{"get":{"tags":["r10-rvc"],"summary":"Rvc Openings","operationId":"rvc_openings_v1_rvc__commitment_id__openings_get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","minLength":4,"maxLength":64,"title":"Commitment Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/identity/zozo":{"get":{"tags":["zozo-identity"],"summary":"Zozo Identity","operationId":"zozo_identity_v1_identity_zozo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/status":{"get":{"tags":["evaluator"],"summary":"ERC-8183 evaluator listener state","operationId":"get_status_v1_evaluator_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/abi":{"get":{"tags":["evaluator"],"summary":"ERC-8183 evaluator ABI summary","operationId":"get_abi_v1_evaluator_abi_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/recent_jobs":{"get":{"tags":["evaluator"],"summary":"Recently evaluated jobs","operationId":"get_recent_jobs_v1_evaluator_recent_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/economics":{"get":{"tags":["evaluator"],"summary":"Evaluator fee + x402 rail wiring","operationId":"get_economics_v1_evaluator_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/manual_evaluate":{"post":{"tags":["evaluator"],"summary":"Synthesize a JobSubmitted event and evaluate","operationId":"manual_evaluate_v1_evaluator_manual_evaluate_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualEvaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/start":{"post":{"tags":["evaluator"],"summary":"Start the background listener (dev-trust only)","operationId":"start_listener_route_v1_evaluator_start_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/stop":{"post":{"tags":["evaluator"],"summary":"Stop the background listener (dev-trust only)","operationId":"stop_listener_route_v1_evaluator_stop_post","parameters":[{"name":"x-hive-trust","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Trust"}},{"name":"X-Admin-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/fees":{"get":{"tags":["evaluator"],"summary":"Public ERC-8183 evaluator fee schedule","description":"Public fee schedule (basis points per complexity tier).","operationId":"get_fees_v1_evaluator_fees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/evaluator/jobs":{"post":{"tags":["evaluator"],"summary":"Submit an ERC-8183 job for evaluation","description":"Client posts a job. Hive computes the fee, stores SUBMITTED state,\nand returns the canonical settlement recipient locked to Hive Safe Treasury.","operationId":"submit_job_route_v1_evaluator_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSubmitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/jobs/{job_id}":{"get":{"tags":["evaluator"],"summary":"ERC-8183 job status (six-state lifecycle)","operationId":"get_job_route_v1_evaluator_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/evaluator/jobs/{job_id}/attest":{"post":{"tags":["evaluator"],"summary":"Provider posts attestation; Hive scores","description":"Provider posts the deliverable attestation. Hive runs HiveTrust verdict,\ntransitions through ACCEPTED → IN_PROGRESS → ATTESTED → EVALUATED → SETTLED|REJECTED,\nand locks settlement to the Hive Safe Treasury.","operationId":"attest_job_route_v1_evaluator_jobs__job_id__attest_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_evaluator__routes__AttestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/template/list":{"post":{"tags":["tradefinance"],"summary":"List Tradefinance","operationId":"list_tradefinance_v1_tradefinance_template_list_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Tradefinance V1 Tradefinance Template List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/agents":{"get":{"tags":["tradefinance"],"summary":"Get Agents","operationId":"get_agents_v1_tradefinance_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agents V1 Tradefinance Agents Get"}}}}}}},"/v1/tradefinance/template":{"get":{"tags":["tradefinance"],"summary":"Get Template","operationId":"get_template_v1_tradefinance_template_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Template V1 Tradefinance Template Get"}}}}}}},"/v1/tradefinance/contract":{"post":{"tags":["tradefinance"],"summary":"Post Contract","operationId":"post_contract_v1_tradefinance_contract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_tradefinance__routes__ContractBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Contract V1 Tradefinance Contract Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/contract/{contract_id}":{"get":{"tags":["tradefinance"],"summary":"Get Contract Detail","operationId":"get_contract_detail_v1_tradefinance_contract__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Contract Detail V1 Tradefinance Contract  Contract Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/fund":{"post":{"tags":["tradefinance"],"summary":"Post Fund","operationId":"post_fund_v1_tradefinance_fund_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Fund V1 Tradefinance Fund Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/milestone-tick":{"post":{"tags":["tradefinance"],"summary":"Post Milestone","operationId":"post_milestone_v1_tradefinance_milestone_tick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilestoneBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Milestone V1 Tradefinance Milestone Tick Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/escrow/{contract_id}":{"get":{"tags":["tradefinance"],"summary":"Get Escrow Detail","operationId":"get_escrow_detail_v1_tradefinance_escrow__contract_id__get","parameters":[{"name":"contract_id","in":"path","required":true,"schema":{"type":"string","title":"Contract Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Escrow Detail V1 Tradefinance Escrow  Contract Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/dispute":{"post":{"tags":["tradefinance"],"summary":"Post Dispute","operationId":"post_dispute_v1_tradefinance_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_tradefinance__routes__DisputeBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Dispute V1 Tradefinance Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/webhook":{"post":{"tags":["tradefinance"],"summary":"Post Webhook","description":"Public tracking-event webhook. Accepts the canonical event shape\n(suitable for posting from webhook.site, Zapier, n8n, in-house ERP,\nor a freight forwarder TMS). FreightWaves SONAR / MarineTraffic AIS /\nGS1 EPCIS-shaped payloads are accepted as schema-compatible test\ntargets — they are NOT integration partners.\n\nRoutes:\n  MILESTONE event  → fire milestone on the escrow (and auto-settle if\n                     milestone == DELIVERED)\n  EXCEPTION event  → file dispute and resolve inline","operationId":"post_webhook_v1_tradefinance_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Webhook V1 Tradefinance Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/dispute/{dispute_id}":{"get":{"tags":["tradefinance"],"summary":"Get Dispute Detail","operationId":"get_dispute_detail_v1_tradefinance_dispute__dispute_id__get","parameters":[{"name":"dispute_id","in":"path","required":true,"schema":{"type":"string","title":"Dispute Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Dispute Detail V1 Tradefinance Dispute  Dispute Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradefinance/economics":{"get":{"tags":["tradefinance"],"summary":"Economics","operationId":"economics_v1_tradefinance_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Economics V1 Tradefinance Economics Get"}}}}}}},"/v1/trade/invoice":{"post":{"tags":["trade-finance"],"summary":"Post Invoice","description":"Create a new SMB cross-border invoice.\n\nThe buyer (US/EU SMB) gets a payable address (canonical Safe Treasury)\nand a deterministic platform fee.","operationId":"post_invoice_v1_trade_invoice_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Invoice V1 Trade Invoice Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/invoice/{invoice_id}":{"get":{"tags":["trade-finance"],"summary":"Get Invoice Route","operationId":"get_invoice_route_v1_trade_invoice__invoice_id__get","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Invoice Route V1 Trade Invoice  Invoice Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/invoice/{invoice_id}/dispute":{"post":{"tags":["trade-finance"],"summary":"Post Invoice Dispute","description":"Open a dispute on an invoice.\n\nIf `hivemorph.hive_law` is wired with a freight/insurance arbitration\ntemplate, route there. Otherwise record a stub dispute on the invoice\nrecord and return the freight/insurance pattern reference for follow-up.\n\nThis avoids a fake on-chain arbitration receipt — it's either real\nHiveLaw routing or a documented stub (RAILS_RULES.md spirit, applied to\narbitration: no mocks).","operationId":"post_invoice_dispute_v1_trade_invoice__invoice_id__dispute_post","parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_trade_finance__routes__DisputeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Invoice Dispute V1 Trade Invoice  Invoice Id  Dispute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trade/fees":{"get":{"tags":["trade-finance"],"summary":"Get Fees","description":"Public fee schedule. Used by SMB CFOs comparing to their wire fee.","operationId":"get_fees_v1_trade_fees_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Fees V1 Trade Fees Get"}}}}}}},"/v1/trade/listing":{"get":{"tags":["trade-finance"],"summary":"Get Listing","description":"Returns the HiveAgent listing record. Idempotent re-list.","operationId":"get_listing_v1_trade_listing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Listing V1 Trade Listing Get"}}}}}}},"/v1/trade/invoices":{"get":{"tags":["trade-finance"],"summary":"Get Invoices","description":"List all invoices in the registry (debug / ops surface).","operationId":"get_invoices_v1_trade_invoices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Invoices V1 Trade Invoices Get"}}}}}}},"/v1/compute-grid/verify":{"post":{"tags":["compute-grid"],"summary":"Verify","description":"Verify a zk-proof and return a signed receipt. Spec §3.1 Agent #3.\n\nPricing: $0.001/proof recorded inside the receipt body.\nSigning: Evaluator wallet (real EIP-191 sign via eth_account).","operationId":"verify_v1_compute_grid_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_compute_grid__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify V1 Compute Grid Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/capacity":{"get":{"tags":["compute-grid"],"summary":"Capacity","operationId":"capacity_v1_compute_grid_capacity_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":32,"title":"N"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Capacity V1 Compute Grid Capacity Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/agents":{"get":{"tags":["compute-grid"],"summary":"Agents","description":"Compute Grid agent registry — 6 operational types, 15 instances.","operationId":"agents_v1_compute_grid_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents V1 Compute Grid Agents Get"}}}}}}},"/v1/compute-grid/providers":{"get":{"tags":["compute-grid"],"summary":"Providers","description":"List enabled adapters and their upstream health. Real probes — no mocks.","operationId":"providers_v1_compute_grid_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Providers V1 Compute Grid Providers Get"}}}}}}},"/v1/compute-grid/quote":{"post":{"tags":["compute-grid"],"summary":"Quote","description":"Gather quotes across enabled providers WITHOUT running the auction\n(no proof, no ledger write). Useful for price discovery.","operationId":"quote_v1_compute_grid_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quote V1 Compute Grid Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/solve":{"post":{"tags":["compute-grid"],"summary":"Solve Endpoint","description":"Run the cross-pool auction and return the chosen provider, Groth16-shaped\nselection proof, signed receipt, and settlement path.\n\nSet persist=false to skip ledger write (probe mode).","operationId":"solve_endpoint_v1_compute_grid_solve_post","parameters":[{"name":"persist","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Persist"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkloadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Solve Endpoint V1 Compute Grid Solve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/book":{"post":{"tags":["compute-grid"],"summary":"Book","description":"Reserve compute with the chosen provider. Real adapters; reservation paths\nare gated behind provider keys. If the upstream key is not configured we\nreturn 503 with the missing-key error rather than faking a booking.","operationId":"book_v1_compute_grid_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_compute_grid__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Book V1 Compute Grid Book Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/status":{"get":{"tags":["compute-grid"],"summary":"Status Endpoint","description":"Poll a booking by id. Returns 503 until book() is fully wired.","operationId":"status_endpoint_v1_compute_grid_status_get","parameters":[{"name":"booking_id","in":"query","required":true,"schema":{"type":"string","title":"Booking Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Status Endpoint V1 Compute Grid Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/release":{"post":{"tags":["compute-grid"],"summary":"Release Endpoint","operationId":"release_endpoint_v1_compute_grid_release_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Release Endpoint V1 Compute Grid Release Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/audit":{"get":{"tags":["compute-grid"],"summary":"Audit","description":"Read auction history from the canonical receipt ledger.\n\nReturns the most recent compute_grid_auction entries with their cost_usdc\ntelemetry. No proof envelopes (those live in the auction-result body and\nare returned by /solve).","operationId":"audit_v1_compute_grid_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit V1 Compute Grid Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compute-grid/verify-selection":{"post":{"tags":["compute-grid"],"summary":"Verify Selection","description":"Independent verifier of a selection proof. Validates envelope structure\n+ signs a verification receipt. Reuses /verify under the hood — distinct\nendpoint so callers don't need to construct a claim manually.","operationId":"verify_selection_v1_compute_grid_verify_selection_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySelectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify Selection V1 Compute Grid Verify Selection Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insurance/products":{"get":{"tags":["insurance-broker"],"summary":"Get Products","description":"Full third-party coverage catalog. Includes provider, type,\ncapacity, and current cost-of-coverage where the upstream exposes it.","operationId":"get_products_v1_insurance_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Products V1 Insurance Products Get"}}}}}}},"/v1/insurance/quote":{"post":{"tags":["insurance-broker"],"summary":"Post Quote","description":"Route a quote request to one or all underwriters.\n\nHive forwards the request to the underwriter's own quote endpoint and\nreturns the response verbatim. Hive does not compute premiums, bind\ncoverage, accept payment, or take custody.","operationId":"post_quote_v1_insurance_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_insurance__routes__QuoteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Quote V1 Insurance Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insurance/today":{"get":{"tags":["insurance-broker"],"summary":"Get Today","description":"24h rollup — listing count + top providers by capacity.","operationId":"get_today_v1_insurance_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Today V1 Insurance Today Get"}}}}}}},"/v1/earn/catalog":{"get":{"tags":["earn"],"summary":"Earn Catalog","operationId":"earn_catalog_v1_earn_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/earn/surfaces/{surface_id}":{"get":{"tags":["earn"],"summary":"Earn Surface Detail","operationId":"earn_surface_detail_v1_earn_surfaces__surface_id__get","parameters":[{"name":"surface_id","in":"path","required":true,"schema":{"type":"string","title":"Surface Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/register":{"post":{"tags":["earn"],"summary":"Earn Register","description":"Apply NEED + YIELD + CLEAN-MONEY checks, then upsert the earner.\n\nThe x402 middleware has already enforced the $0.05 fee at this point.\nIdempotency: re-registration returns the same earner with\nalready_registered=true (the x402 layer treats subsequent calls as\npaid passes — the middleware nonce/access-token machinery prevents\ndouble-charging within an x402 session, and re-registration is\nrare-by-design at the application layer).","operationId":"earn_register_v1_earn_register_post","parameters":[{"name":"X-Hive-Request-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Request-Id"}},{"name":"X-Hive-Attribution","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Hive-Attribution"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_earn__routes__RegisterBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/leaderboard":{"get":{"tags":["earn"],"summary":"Earn Leaderboard","operationId":"earn_leaderboard_v1_earn_leaderboard_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","description":"7d | 30d | lifetime","default":"lifetime","title":"Window"},"description":"7d | 30d | lifetime"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/payout-schedule":{"get":{"tags":["earn"],"summary":"Earn Payout Schedule","operationId":"earn_payout_schedule_v1_earn_payout_schedule_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/earn/proof/{tx_hash}":{"get":{"tags":["earn"],"summary":"Earn Proof","operationId":"earn_proof_v1_earn_proof__tx_hash__get","parameters":[{"name":"tx_hash","in":"path","required":true,"schema":{"type":"string","title":"Tx Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/me":{"get":{"tags":["earn"],"summary":"Earn Me","operationId":"earn_me_v1_earn_me_get","parameters":[{"name":"agent_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Did"}},{"name":"X-Earner-DID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Earner-Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earn/payout/sweep":{"post":{"tags":["earn"],"summary":"Earn Payout Sweep","operationId":"earn_payout_sweep_v1_earn_payout_sweep_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SweepBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/call":{"post":{"tags":["amplify"],"summary":"Call","operationId":"call_v1_amplify_call_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Call V1 Amplify Call Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/corpus/append":{"post":{"tags":["amplify"],"summary":"Corpus Append","operationId":"corpus_append_v1_amplify_corpus_append_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppendBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Corpus Append V1 Amplify Corpus Append Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/corpus/retrieve":{"get":{"tags":["amplify"],"summary":"Corpus Retrieve","operationId":"corpus_retrieve_v1_amplify_corpus_retrieve_get","parameters":[{"name":"tenant_did","in":"query","required":true,"schema":{"type":"string","title":"Tenant Did"}},{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"k","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"K"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Corpus Retrieve V1 Amplify Corpus Retrieve Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/corpus/stats":{"get":{"tags":["amplify"],"summary":"Corpus Stats","operationId":"corpus_stats_v1_amplify_corpus_stats_get","parameters":[{"name":"tenant_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Corpus Stats V1 Amplify Corpus Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/sign":{"post":{"tags":["amplify"],"summary":"Amplify Sign","description":"Split mode. Customer ran the LLM on their side.\nWe receive (tenant_did, prompt, response), COMPILE + COMPRESS + AMPLIFY + CERT.\n\nThe widget transmits only the response + the raw prompt (we re-hash and\nre-compress server-side so customers see the exact token savings they would\nget if they re-issued the LLM call against the compressed prompt).\n\nCustomer's LLM API key never leaves their network. We bind everything into\none ML-DSA-65 certificate.","operationId":"amplify_sign_v1_amplify_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Amplify Sign V1 Amplify Sign Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/verify":{"post":{"tags":["amplify"],"summary":"Amplify Verify","description":"Public verification. Anyone with the certificate can confirm:\n  (a) signature is valid under our pubkey\n  (b) response_sha256 + prompt_hash bind to the supplied prompt/response","operationId":"amplify_verify_v1_amplify_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Amplify Verify V1 Amplify Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/wrap-receipt":{"post":{"tags":["amplify"],"summary":"Wrap Receipt","description":"Upgrade any existing vertical receipt into a CCACW signed cert.\n\nAdditive: the caller's original receipt is returned unchanged; the new\n`ccacw_receipt` field is appended. No vertical needs to change its\nroute shape — they call this once and re-emit the result.","operationId":"wrap_receipt_v1_amplify_wrap_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WrapReceiptBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Wrap Receipt V1 Amplify Wrap Receipt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/amplify/selftest":{"get":{"tags":["amplify"],"summary":"Selftest","description":"No LLM call. Verifies COMPILE → COMPRESS → SIGN locally.","operationId":"selftest_v1_amplify_selftest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Selftest V1 Amplify Selftest Get"}}}}}}},"/v1/amplify/bench":{"get":{"tags":["amplify"],"summary":"Bench","description":"Side-by-side: raw hivecompute call vs full AMPLIFY loop.\nReturns hard numbers: token reduction, latency delta, cost delta.","operationId":"bench_v1_amplify_bench_get","parameters":[{"name":"prompt","in":"query","required":false,"schema":{"type":"string","default":"Summarize the key indemnity considerations for a SaaS vendor master agreement covering data breach, IP infringement, third-party services, and limitation of liability.","title":"Prompt"}},{"name":"tenant_did","in":"query","required":false,"schema":{"type":"string","default":"did:hive:bench","title":"Tenant Did"}},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"gpt-4o-mini","title":"Model"}},{"name":"max_tokens","in":"query","required":false,"schema":{"type":"integer","default":256,"title":"Max Tokens"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Bench V1 Amplify Bench Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/echo/compress":{"post":{"tags":["xcalibur-echo"],"summary":"Compress a prompt with ECHO v1","description":"Compress a prompt using XCALIBUR ECHO v1 output-conditioned compression.\n\nAlgorithm:\n1. Generate K=8 candidate compressions at increasing aggressiveness.\n2. Score each candidate using a deterministic TF-IDF surrogate\n   (tfidf-deterministic-v1) that estimates content preservation.\n3. Select the best-scoring candidate that meets the target_ratio floor.\n4. Run one round of gradient-free sentence-drop mutation, keeping drops\n   that keep the score at or above min_preservation.\n5. Return the compressed prompt and a signed Ed25519 receipt.","operationId":"compress_prompt_v1_xcalibur_echo_compress_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__echo_routes__CompressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/echo/verify":{"post":{"tags":["xcalibur-echo"],"summary":"Verify an ECHO receipt","description":"Verify the integrity and signature of an ECHO receipt.\n\nChecks performed:\n- **signature**: Ed25519 signature over canonical JSON of all receipt fields\n  (except the signature field itself) verifies correctly.\n- **token_math**: original_tokens / compressed_tokens matches compression_ratio.\n- **compressed_hash_match**: if compressed_prompt is provided, sha3_256 of it\n  matches receipt.compressed_hash. This catches any tampering with the\n  compressed text.\n- **kind_check**: receipt.kind is \"xcalibur.echo.v1\".","operationId":"verify_receipt_v1_xcalibur_echo_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__echo_routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__echo_routes__VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/echo/health":{"get":{"tags":["xcalibur-echo"],"summary":"ECHO health check","description":"Liveness probe for the XCALIBUR ECHO primitive.","operationId":"echo_health_v1_xcalibur_echo_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Echo Health V1 Xcalibur Echo Health Get"}}}}}}},"/v1/xcalibur/membrane/health":{"get":{"tags":["xcalibur-membrane"],"summary":"Health","description":"Liveness probe for the MEMBRANE primitive.","operationId":"health_v1_xcalibur_membrane_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Xcalibur Membrane Health Get"}}}}}}},"/v1/xcalibur/membrane/score":{"post":{"tags":["xcalibur-membrane"],"summary":"Score","description":"Score an LLM output against sensitivity-labelled prompt spans.\n\nReturns the decision (BLOCK / WARN / PASS), IFS, and a signed receipt.","operationId":"score_v1_xcalibur_membrane_score_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Score V1 Xcalibur Membrane Score Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/membrane/verify":{"post":{"tags":["xcalibur-membrane"],"summary":"Verify","description":"Verify a MEMBRANE receipt.\n\nChecks:\n- signature_ok: Ed25519 signature is valid against receipt body\n- math_ok: recorded decision is consistent with IFS and thresholds","operationId":"verify_v1_xcalibur_membrane_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__membrane_routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify V1 Xcalibur Membrane Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/membrane/enforce":{"post":{"tags":["xcalibur-membrane"],"summary":"Enforce","description":"Gate endpoint: runs scoring and either blocks or passes the output.\n\n- BLOCK → HTTP 403 with receipt\n- WARN / PASS → HTTP 200 with {\"output\": ..., \"receipt\": ...}","operationId":"enforce_v1_xcalibur_membrane_enforce_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnforceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/membrane/canary-eval":{"get":{"tags":["xcalibur-membrane"],"summary":"Canary Eval","description":"Run the built-in adversarial canary test corpus.\n\nReturns sensitivity (leak detection rate), specificity (clean pass rate),\nand per-case results.  This is the seed of the MEMBRANE-EVAL-500 benchmark.","operationId":"canary_eval_v1_xcalibur_membrane_canary_eval_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Canary Eval V1 Xcalibur Membrane Canary Eval Get"}}}}}}},"/v1/xcalibur/quorum/complete":{"post":{"tags":["xcalibur-quorum"],"summary":"Quorum Complete","description":"Run M-of-N LLM consensus.\n\nDispatches the prompt to N models in parallel, clusters responses using\ndeterministic TF-IDF cosine similarity, then applies M-of-N decision.\nReturns the decision, canonical response, dissent receipts, and a signed receipt.","operationId":"quorum_complete_v1_xcalibur_quorum_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuorumCompleteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum Complete V1 Xcalibur Quorum Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/quorum/verify":{"post":{"tags":["xcalibur-quorum"],"summary":"Quorum Verify","description":"Verify the ed25519 signature on a QUORUM receipt.\n\nReturns {\"valid\": bool, \"signature_ok\": bool}.\nNote: signature verification uses the in-process signing key.\nIn production, the public key is available at GET /v1/xcalibur/quorum/health.","operationId":"quorum_verify_v1_xcalibur_quorum_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuorumVerifyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum Verify V1 Xcalibur Quorum Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/quorum/health":{"get":{"tags":["xcalibur-quorum"],"summary":"Quorum Health","description":"Liveness check. Returns available model IDs and primitive version.","operationId":"quorum_health_v1_xcalibur_quorum_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum Health V1 Xcalibur Quorum Health Get"}}}}}}},"/v1/xcalibur/quorum/registry":{"get":{"tags":["xcalibur-quorum"],"summary":"Quorum Registry","description":"Return the full model registry.\n\nExposes which models can participate in quorum votes,\ntheir provider model names, families, and eras.","operationId":"quorum_registry_v1_xcalibur_quorum_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum Registry V1 Xcalibur Quorum Registry Get"}}}}}}},"/v1/xcalibur/echo/v2/compress":{"post":{"tags":["xcalibur","echo","v2"],"summary":"Compress","operationId":"compress_v1_xcalibur_echo_v2_compress_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompressV2Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compress V1 Xcalibur Echo V2 Compress Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/echo/v2/health":{"get":{"tags":["xcalibur","echo","v2"],"summary":"Health","operationId":"health_v1_xcalibur_echo_v2_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Xcalibur Echo V2 Health Get"}}}}}}},"/v1/xcalibur/quorum/v2/reason":{"post":{"tags":["xcalibur-quorum-v2"],"summary":"Quorum V2 Reason","description":"Run QUORUM v2 ensemble reasoning.\n\nDispatches the prompt through up to 4 strategies:\n1. SELF-CONSISTENCY (Wang et al. 2022) — single model, k=5, majority vote\n2. QUORUM-WEIGHTED — k=5 across diverse models/temperatures\n3. CHAIN-VERIFY — zero-shot CoT + verification pass\n4. SOLVE-AND-EXPLAIN — structured step-by-step with double-check\n\nAn oracle picks the strategy with highest internal answer agreement.\nReturns signed receipt with per-strategy answers and confidence scores.","operationId":"quorum_v2_reason_v1_xcalibur_quorum_v2_reason_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuorumV2ReasonBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum V2 Reason V1 Xcalibur Quorum V2 Reason Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/quorum/v2/health":{"get":{"tags":["xcalibur-quorum-v2"],"summary":"Quorum V2 Health","description":"Liveness check. Returns primitive version and signing pubkey.","operationId":"quorum_v2_health_v1_xcalibur_quorum_v2_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Quorum V2 Health V1 Xcalibur Quorum V2 Health Get"}}}}}}},"/v1/xcalibur/membrane/v2/classify":{"post":{"tags":["xcalibur","membrane","v2"],"summary":"Classify","description":"Classify a text as SAFE or UNSAFE using the MEMBRANE v2 ensemble.\n\nReturns a signed receipt with:\n- verdict: SAFE | UNSAFE\n- candidate_scores: per-model score\n- final_score: weighted ensemble score\n- receipt_id, timestamp, input_hash, signature","operationId":"classify_v1_xcalibur_membrane_v2_classify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__membrane_v2_routes__ClassifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Classify V1 Xcalibur Membrane V2 Classify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/membrane/v2/health":{"get":{"tags":["xcalibur","membrane","v2"],"summary":"Health","description":"Health check — does not load models.","operationId":"health_v1_xcalibur_membrane_v2_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Xcalibur Membrane V2 Health Get"}}}}}}},"/v1/xcalibur/verify/v2/attest":{"post":{"tags":["xcalibur","verify","v2"],"summary":"Attest","description":"Corpus-attestation ensemble endpoint.\n\nValidates Merkle membership + external PQ signature + runs cross-family\nensemble (ML-DSA-65 reference, ML-DSA-65 deterministic, SLH-DSA-SHA2-128s,\nEd25519). Returns signed XCALIBUR VERIFY v2 receipt.\n\nVerdict PASS requires unanimity across all ensemble candidates.","operationId":"attest_v1_xcalibur_verify_v2_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__xcalibur__verify_v2_routes__AttestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Attest V1 Xcalibur Verify V2 Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/xcalibur/verify/v2/health":{"get":{"tags":["xcalibur","verify","v2"],"summary":"Health","description":"Health check — does not load heavy PQ libraries.","operationId":"health_v1_xcalibur_verify_v2_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Xcalibur Verify V2 Health Get"}}}}}}},"/v1/trust/health":{"get":{"tags":["trust"],"summary":"Health","description":"Liveness check + record count.","operationId":"health_v1_trust_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Trust Health Get"}}}}}}},"/v1/trust/benchmarks":{"get":{"tags":["trust"],"summary":"Benchmarks","description":"List benchmark records. Default: latest per key, all primitives, all statuses.","operationId":"benchmarks_v1_trust_benchmarks_get","parameters":[{"name":"primitive","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by primitive name","title":"Primitive"},"description":"Filter by primitive name"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by result_status: smoke|preliminary|publishable","title":"Status"},"description":"Filter by result_status: smoke|preliminary|publishable"},{"name":"latest","in":"query","required":false,"schema":{"type":"boolean","description":"Return only latest per (primitive, adversary, dataset, task)","default":true,"title":"Latest"},"description":"Return only latest per (primitive, adversary, dataset, task)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Benchmarks V1 Trust Benchmarks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trust/benchmarks/{record_id}":{"get":{"tags":["trust"],"summary":"Benchmark","description":"Fetch a single signed record by id.","operationId":"benchmark_v1_trust_benchmarks__record_id__get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Benchmark V1 Trust Benchmarks  Record Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trust/agents":{"get":{"tags":["trust"],"summary":"Agents","description":"Public agent trust directory — composite score (PDR/MDR/ASS/DLQ), sorted by trust score.","operationId":"agents_v1_trust_agents_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by category: infrastructure|legal|payments|compliance","title":"Category"},"description":"Filter by category: infrastructure|legal|payments|compliance"},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","description":"Minimum composite trust score","default":0.0,"title":"Min Score"},"description":"Minimum composite trust score"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agents V1 Trust Agents Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/scan":{"get":{"tags":["mining"],"summary":"Mining Scan","description":"Tier 0: list MDK workers and Hive auction offers (no fee).","operationId":"mining_scan_v1_mining_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/route":{"post":{"tags":["mining"],"summary":"Mining Route","description":"Tier 0: rank destinations for a fleet. 2% fee taken at /book, not here.","operationId":"mining_route_v1_mining_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__routes__RouteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/book":{"post":{"tags":["mining"],"summary":"Mining Book","description":"$0.05 USDC: book hashrate. Three-gated. 2% routing fee. Real EIP-191 receipt.","operationId":"mining_book_v1_mining_book_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__routes__BookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/pnl":{"get":{"tags":["mining"],"summary":"Mining Pnl","operationId":"mining_pnl_v1_mining_pnl_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/fee-intel":{"get":{"tags":["mining"],"summary":"Mining Fee Intel","description":"$0.02 USDC: Bortlesboat fee landscape + nextblock combined.","operationId":"mining_fee_intel_v1_mining_fee_intel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/next-block-advice":{"get":{"tags":["mining"],"summary":"Mining Next Block Advice","description":"$0.03 USDC: combine our auction state with Satoshi /ai/fees/advice.","operationId":"mining_next_block_advice_v1_mining_next_block_advice_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/economics":{"get":{"tags":["mining"],"summary":"Mining Economics","description":"Tier 0: daily revenue + Satoshi spend. Internal monitoring.","operationId":"mining_economics_v1_mining_economics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/payout":{"post":{"tags":["mining"],"summary":"Mining Payout","description":"Boltz reverse swap BTC → USDC on Base. 40bps Hive spread fee.\n\nTier 0 endpoint — fee is captured in the swap math, not at the gate.\nReal swap or HTTP 503. We never custody BTC.","operationId":"mining_payout_v1_mining_payout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/featured":{"get":{"tags":["discovery"],"summary":"Top-gradient Hive endpoints","description":"Returns the top-N priced endpoints sorted by capability gradient (marginal $-yield per call × category multiplier). Each entry includes a copy-pasteable sample curl. Tier 0 — free.","operationId":"discovery_featured_v1_discovery_featured_get","parameters":[{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":8,"title":"N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/stranded":{"get":{"tags":["discovery"],"summary":"Stranded paid surfaces (zero 24h consumes)","description":"Returns paid endpoints that received zero consumes in the past 24h, sorted by potential daily yield. Used by external agents to find under-utilized Hive surfaces to integrate.","operationId":"discovery_stranded_v1_discovery_stranded_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/orchestrate/health":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Health","description":"Tier 0 — free. Capabilities & version of the MOS orchestration layer.","operationId":"orchestrate_health_v1_mining_orchestrate_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mining/orchestrate/register":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Register","description":"Tier 3 $0.05 — operator registers their MOS instance.\n\nIdempotent on operator_did. Upserts on re-registration.\nThree gates:\n  NEED:        Valid operator_did + EVM wallet_addr + reachable mos_endpoint scheme.\n  YIELD:       Registration creates earning potential (immediately on /sites/sync).\n  CLEAN-MONEY: wallet_addr must pass EVM checksum.","operationId":"orchestrate_register_v1_mining_orchestrate_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mining__orchestrate__RegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/sites/sync":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Sites Sync","description":"Tier 3 $0.05 — operator pushes site/worker telemetry batch.\n\nIdempotent on (operator_did, site_id, batch_ts). Re-posting the same\nbatch returns {\"idempotent\": True} without error.","operationId":"orchestrate_sites_sync_v1_mining_orchestrate_sites_sync_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteSyncRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/sites":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Sites","description":"Tier 1 $0.001 — list operator's registered sites and latest telemetry.","operationId":"orchestrate_sites_v1_mining_orchestrate_sites_get","parameters":[{"name":"operator_did","in":"query","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/payouts":{"get":{"tags":["mining-orchestrate"],"summary":"Orchestrate Payouts","description":"Tier 1 $0.001 — operator's pending USDC payout balance from earn rails ledger.","operationId":"orchestrate_payouts_v1_mining_orchestrate_payouts_get","parameters":[{"name":"operator_did","in":"query","required":true,"schema":{"type":"string","title":"Operator Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mining/orchestrate/payouts/withdraw":{"post":{"tags":["mining-orchestrate"],"summary":"Orchestrate Payouts Withdraw","description":"Tier 3 $0.05 — construct BTC→USDC payout via Boltz + earn rails sweep.\n\nConstructed-only by default (EARN_SWEEP_AUTODISPATCH=false per Rule 9).\nSet EARN_SWEEP_AUTODISPATCH=true to enable real Boltz broadcast.","operationId":"orchestrate_payouts_withdraw_v1_mining_orchestrate_payouts_withdraw_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/register":{"post":{"tags":["distribution"],"summary":"Register capabilities for a shim","operationId":"discovery_register_v1_discovery_register_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"List registered capabilities (public)","operationId":"discovery_list_v1_discovery_register_get","parameters":[{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single shim.","title":"Shim"},"description":"Filter to a single shim."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/gate/register":{"post":{"tags":["distribution"],"summary":"Register a per-ecosystem gate manifest","operationId":"gate_register_v1_gate_register_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GateRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"List gate manifests grouped by ecosystem (public)","operationId":"gate_list_v1_gate_register_get","parameters":[{"name":"ecosystem","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single ecosystem.","title":"Ecosystem"},"description":"Filter to a single ecosystem."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/marketplace/list":{"post":{"tags":["distribution"],"summary":"List tools in the agent marketplace","operationId":"marketplace_list_tools_v1_marketplace_list_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["distribution"],"summary":"Marketplace listings (public)","operationId":"marketplace_get_v1_marketplace_list_get","parameters":[{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a single shim.","title":"Shim"},"description":"Filter to a single shim."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pulse/event":{"post":{"tags":["distribution"],"summary":"Append a pulse event to the ring buffer","operationId":"pulse_event_v1_pulse_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PulseEventRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pulse/events":{"get":{"tags":["distribution"],"summary":"Read recent pulse events (public)","operationId":"pulse_events_v1_pulse_events_get","parameters":[{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by event name.","title":"Event"},"description":"Filter by event name."},{"name":"shim","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by shim.","title":"Shim"},"description":"Filter by shim."},{"name":"since_minutes","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Only events within the last N minutes.","title":"Since Minutes"},"description":"Only events within the last N minutes."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max events to return (cap 500).","default":100,"title":"Limit"},"description":"Max events to return (cap 500)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/register":{"post":{"tags":["mos-intel"],"summary":"Mos Register","description":"Register a mining site DID.\n\nAuthenticates via X-Hive-Site-DID + X-Hive-Nonce + X-Hive-Sig (Ed25519).\nReturns a site_id and the assigned pricing tier on first registration.\nIdempotent: re-registering the same site_did returns the existing record.\n\nPricing tier: mos_intel_subscription — $10 / machine / month.\nSubscription billing is recorded in v0.1 and enforced in v0.2.\n\nThree gates:\n    NEED:        Valid Ed25519 signed nonce proves DID ownership.\n    YIELD:       Registration creates earning potential (telemetry + recommendations).\n    CLEAN-MONEY: DID is the billing identity; no anonymous registrations.","operationId":"mos_register_v1_mos_intel_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__mos__intel__RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/telemetry":{"post":{"tags":["mos-intel"],"summary":"Mos Telemetry","description":"Accept a signed telemetry push from a registered site.\n\nAppends an entry to the site's append-only NDJSON log at\n/tmp/hivemorph_data/mos_telemetry/{site_did_hash}.ndjson.\nEach entry includes the original site_did and the submission timestamp\nso the log is auditable without additional metadata.\n\nPayload fields (all optional):\n    hashrate_ths  — total site hashrate in TH/s\n    health        — freeform health string (e.g. \"ok\", \"degraded\")\n    temp_c        — average worker temperature in Celsius\n    energy_kwh    — energy consumption in kWh\n    workers       — list of per-worker objects\n\nThree gates:\n    NEED:        Site must be registered. Ed25519 nonce required.\n    YIELD:       Each push updates the recommendation baseline.\n    CLEAN-MONEY: Payload is stored as-is and signed by the site DID.\n                 No MOS SDK calls are made (503 if called; RAILS_RULES Rule 1).","operationId":"mos_telemetry_v1_mos_intel_telemetry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/recommendations/{site_did}":{"get":{"tags":["mos-intel"],"summary":"Mos Recommendations","description":"Return optimization recommendations for a registered site.\n\nRead-only. No commands are executed. The operator reviews and applies\nsuggestions manually.\n\nRecommendation types:\n    throttle_suggestions  — per-worker hashrate throttle guidance\n    pool_routing          — pool routing suggestions (v0.1: stub)\n    predictive_alerts     — shutdown / maintenance alerts\n\nAuth: same Ed25519 signed-nonce flow as other endpoints.\nThe site_did in the URL path must match the X-Hive-Site-DID header.\n\nThree gates:\n    NEED:        Site must be registered and authenticated.\n    YIELD:       Drives recurring subscription value ($10/machine/month).\n    CLEAN-MONEY: Read-only; no mutations.","operationId":"mos_recommendations_v1_mos_intel_recommendations__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/intel/sites":{"get":{"tags":["mos-intel"],"summary":"Mos Sites","description":"Admin: list all registered sites.\n\nGated by HIVE_INTERNAL_DRIVER_KEY via X-Hive-Internal header.\nThis endpoint is not accessible to site operators.\n\nThree gates:\n    NEED:        Admin key required (HIVE_INTERNAL_DRIVER_KEY).\n    YIELD:       Operational visibility for billing and capacity planning.\n    CLEAN-MONEY: Read-only; no mutations.","operationId":"mos_sites_v1_mos_intel_sites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mos/intel/attest/{site_did}":{"get":{"tags":["mos-intel"],"summary":"Mos Attest","description":"ZK attestation stub.\n\nReturns HTTP 501 Not Implemented.  CLOAzK proof generation is not wired\nin v0.1.  Per RAILS_RULES Rule 1: no mock proofs, no fake attestations.\nThis endpoint exists to reserve the URL and communicate the roadmap\naccurately to callers.\n\nWhen CLOAzK is integrated in a future version, this endpoint will return\na verifiable ZK proof attesting to the site's production history.","operationId":"mos_attest_v1_mos_intel_attest__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/utility-price":{"post":{"tags":["mos-energy-arb"],"summary":"Push Utility Price","description":"GATE — NEED: site must supply a positive $/kWh rate and kWh/hour figure.\n\nThe site operator (or an automated agent acting on their behalf) pushes\nthe current electricity tariff for their facility. Records are appended\nto {site_did}/utility_prices.ndjson and used by the recommendation engine.\n\nv0.1 accepts manual pushes only. Authentication is via DID + signed nonce;\nsignature verification is stubbed — the hook is in place for v0.2 when\nCLOAzK proofs are wired.","operationId":"push_utility_price_v1_mos_energy_arb_utility_price_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityPriceBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/recommendations/{site_did}":{"get":{"tags":["mos-energy-arb"],"summary":"Get Recommendations","description":"GATE — YIELD: returns mine / throttle / sell-forward decision JSON.\n\nDecision logic (deterministic — see _compute_recommendation docstring):\n  - revenue / cost < 1.0  → throttle (target_hashrate_pct returned)\n  - revenue / cost > 1.5 AND spike projected in next 6h → front-load\n  - otherwise → mine\n\nAlso returns:\n  - demonstrated_savings_projection: estimated 30-day savings if recommendations\n    are followed at current energy prices\n  - savings_30d_actual: rolling 30-day actual savings (if telemetry history exists\n    from Surface 1 /v1/mos/intel/telemetry)\n\nExternal API failures are surfaced as degraded_mode=true with a conservative\n\"mine\" recommendation rather than exposing an error response. This prevents\ntransient network issues from disrupting operations.","operationId":"get_recommendations_v1_mos_energy_arb_recommendations__site_did__get","parameters":[{"name":"site_did","in":"path","required":true,"schema":{"type":"string","title":"Site Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mos/energy-arb/billing/cycle":{"post":{"tags":["mos-energy-arb"],"summary":"Billing Cycle","description":"GATE — CLEAN-MONEY: admin-only (HIVE_INTERNAL_DRIVER_KEY). Monthly trigger.\n\nComputes 20%-of-savings invoices for every site that has utility-price\nrecords. Records each invoice to {site_did}/invoices.ndjson.\n\nv0.1 behaviour: records invoices; does NOT charge. Billing rail execution\nis deferred to v0.2. The invoice record is the audit trail for when the\nrail is wired.\n\nFee formula:\n    savings_usd  = baseline_cost - actual_cost (using telemetry; see _compute_savings)\n    hive_fee_usd = savings_usd * 0.20\n\nReturns a summary of computed invoices. In dry_run mode, returns projections\nwithout writing to disk.","operationId":"billing_cycle_v1_mos_energy_arb_billing_cycle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingCycleBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/event":{"post":{"tags":["tax"],"summary":"Post Tax Event","description":"Classify a single transaction. Real on-chain reads. Inputs only — no advice.","operationId":"post_tax_event_v1_tax_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxEventBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Tax Event V1 Tax Event Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/bulk":{"post":{"tags":["tax"],"summary":"Post Tax Bulk","description":"Classify an array of transactions in a single call (max 50).","operationId":"post_tax_bulk_v1_tax_bulk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxBulkBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Tax Bulk V1 Tax Bulk Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tax/today":{"get":{"tags":["tax"],"summary":"Get Tax Today","description":"Count of taxable-classified events seen in the last 24h, by event type.","operationId":"get_tax_today_v1_tax_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Tax Today V1 Tax Today Get"}}}}}}},"/v1/tax/health":{"get":{"tags":["tax"],"summary":"Get Tax Health","operationId":"get_tax_health_v1_tax_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Tax Health V1 Tax Health Get"}}}}}}},"/v1/dispute/check":{"post":{"tags":["dispute-observer"],"summary":"Post Check","description":"Given counterparty address + chain, return dispute history,\nactive arbitration cases, and on-chain reversal flags from public\nsources. Observational only.","operationId":"post_check_v1_dispute_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Check V1 Dispute Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dispute/providers":{"get":{"tags":["dispute-observer"],"summary":"Get Providers","description":"List available arbitration protocols (Kleros, UMA, Reality.eth)\nwith current case load and intake URLs.","operationId":"get_providers_v1_dispute_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Providers V1 Dispute Providers Get"}}}}}}},"/v1/dispute/route":{"post":{"tags":["dispute-observer"],"summary":"Post Route","description":"Rank arbitration provider options for a case. NO automatic filing.\nHive returns options + intake URLs only — the disputing party files\ndirectly with the chosen provider.","operationId":"post_route_v1_dispute_route_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Post Route V1 Dispute Route Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dispute/today":{"get":{"tags":["dispute-observer"],"summary":"Get Today","description":"24h rollup: flagged-counterparty count + top arbitration providers\nby active case load.","operationId":"get_today_v1_dispute_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Today V1 Dispute Today Get"}}}}}}},"/v1/dispute/health":{"get":{"tags":["dispute-observer"],"summary":"Get Health","operationId":"get_health_v1_dispute_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Health V1 Dispute Health Get"}}}}}}},"/v1/receipt/mcp":{"get":{"summary":"Receipt Mcp Meta","operationId":"receipt_mcp_meta_v1_receipt_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Receipt Mcp","operationId":"receipt_mcp_v1_receipt_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/receipt/health":{"get":{"tags":["swarm-receipts"],"summary":"Health","operationId":"health_v1_receipt_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Receipt Health Get"}}}}}}},"/v1/receipt/free":{"post":{"tags":["swarm-receipts"],"summary":"Issue Free Receipt","description":"Free PQ-signed receipt. Rate-limited to 100/IP/day.\n\nNo login required. Accepts any string payload (PR diff, contract clause,\nAPI log line, tx hash). Returns full ML-DSA-65 + classical signature\nenvelope with verify URL. After 100/day the IP must sign up.","operationId":"issue_free_receipt_v1_receipt_free_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeIssueRequestBody"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Issue Free Receipt V1 Receipt Free Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/pricing":{"get":{"tags":["swarm-receipts"],"summary":"Pricing","operationId":"pricing_v1_receipt_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Receipt Pricing Get"}}}}}}},"/v1/receipt/issue":{"post":{"tags":["swarm-receipts"],"summary":"Issue Receipt","operationId":"issue_receipt_v1_receipt_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueRequestBody"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Issue Receipt V1 Receipt Issue Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/{receipt_id}":{"get":{"tags":["swarm-receipts"],"summary":"Get Receipt","operationId":"get_receipt_v1_receipt__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Receipt V1 Receipt  Receipt Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/settle":{"post":{"tags":["swarm-receipts"],"summary":"Settle Receipt","operationId":"settle_receipt_v1_receipt_settle_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettleRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Settle Receipt V1 Receipt Settle Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/health":{"get":{"tags":["github-app"],"summary":"Health","operationId":"health_v1_github_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Github Health Get"}}}}}}},"/v1/github/sign-diff":{"post":{"tags":["github-app"],"summary":"Sign Diff Route","description":"Manual signing API — no GitHub App install needed.\n\nUseful for CI pipelines that want to PQ-sign the PR diff and post the\nreceipt URL into their own checks/status. Rate-limited on the underlying\n/v1/receipt/free path semantics already.","operationId":"sign_diff_route_v1_github_sign_diff_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignDiffRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sign Diff Route V1 Github Sign Diff Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/github/webhook":{"post":{"tags":["github-app"],"summary":"Github Webhook","description":"GitHub App webhook receiver.\n\nCurrently handles `pull_request` events with action in {opened, synchronize,\nreopened}. We verify the X-Hub-Signature-256 header, extract the PR diff\nURL, sign the diff via the swarm receipt issuer, and (in v0.1) return the\ncomment payload. v0.2 will POST the comment to the PR via the GitHub API\nusing an installation access token.","operationId":"github_webhook_v1_github_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Github Webhook V1 Github Webhook Post"}}}}}}},"/v1/subscription/plans":{"get":{"tags":["subscription"],"summary":"List Plans","description":"Public plan catalog. Returns price, features, payment rails.","operationId":"list_plans_v1_subscription_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/subscription/intent":{"post":{"tags":["subscription"],"summary":"Create Intent","description":"Step 1: client picks a plan, gets payment instructions + sub_id memo.","operationId":"create_intent_v1_subscription_intent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subscription/claim":{"post":{"tags":["subscription"],"summary":"Claim Subscription","description":"Step 2: client submits tx_hash. v0.1 accepts any well-formed hash and provisions\nimmediately. v0.2 will verify on-chain via Base RPC.","operationId":"claim_subscription_v1_subscription_claim_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subscription/status/{sub_id}":{"get":{"tags":["subscription"],"summary":"Subscription Status","description":"Public status check by sub_id (api_key never returned here).","operationId":"subscription_status_v1_subscription_status__sub_id__get","parameters":[{"name":"sub_id","in":"path","required":true,"schema":{"type":"string","title":"Sub Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subscription/health":{"get":{"tags":["subscription"],"summary":"Health","operationId":"health_v1_subscription_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/bounty/program":{"get":{"tags":["bounty"],"summary":"Program","operationId":"program_v1_bounty_program_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Program V1 Bounty Program Get"}}}}}}},"/v1/bounty/register":{"post":{"tags":["bounty"],"summary":"Register","operationId":"register_v1_bounty_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_bounty__routes__RegisterBody"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register V1 Bounty Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/leaderboard":{"get":{"tags":["bounty"],"summary":"Leaderboard","operationId":"leaderboard_v1_bounty_leaderboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Leaderboard V1 Bounty Leaderboard Get"}}}}}}},"/v1/bounty/status/{code}":{"get":{"tags":["bounty"],"summary":"Status","operationId":"status_v1_bounty_status__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Status V1 Bounty Status  Code  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/admin/confirm":{"post":{"tags":["bounty"],"summary":"Admin Confirm","operationId":"admin_confirm_v1_bounty_admin_confirm_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Confirm V1 Bounty Admin Confirm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/admin/attribute":{"post":{"tags":["bounty"],"summary":"Admin Attribute","operationId":"admin_attribute_v1_bounty_admin_attribute_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributeBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Attribute V1 Bounty Admin Attribute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/admin/payout":{"post":{"tags":["bounty"],"summary":"Admin Payout","operationId":"admin_payout_v1_bounty_admin_payout_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Payout V1 Bounty Admin Payout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/health":{"get":{"tags":["bounty"],"summary":"Health","operationId":"health_v1_bounty_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Bounty Health Get"}}}}}}},"/v1/bounty/":{"get":{"tags":["bounty"],"summary":"Bounty Root","description":"Bare /v1/bounty answers with a useful map instead of 404.","operationId":"bounty_root_v1_bounty__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bounty Root V1 Bounty  Get"}}}}}}},"/v1/bounty":{"get":{"tags":["bounty"],"summary":"Bounty Root","description":"Bare /v1/bounty answers with a useful map instead of 404.","operationId":"bounty_root_v1_bounty_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bounty Root V1 Bounty Get"}}}}}}},"/v1/bounty/status/":{"get":{"tags":["bounty"],"summary":"Status Root","description":"Catch the common mistake of GET /v1/bounty/status with no code.","operationId":"status_root_v1_bounty_status__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Status Root V1 Bounty Status  Get"}}}}}}},"/v1/bounty/status":{"get":{"tags":["bounty"],"summary":"Status Root","description":"Catch the common mistake of GET /v1/bounty/status with no code.","operationId":"status_root_v1_bounty_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Status Root V1 Bounty Status Get"}}}}}}},"/v1/bounty/admin/queue":{"get":{"tags":["bounty"],"summary":"Admin Queue","operationId":"admin_queue_v1_bounty_admin_queue_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Queue V1 Bounty Admin Queue Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bounty/lookup":{"post":{"tags":["bounty"],"summary":"Lookup","description":"Public recovery: if a submitter lost their code, return it by repo_url.","operationId":"lookup_v1_bounty_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Lookup V1 Bounty Lookup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/mpp/health":{"get":{"tags":["mpp"],"summary":"Mpp Health","description":"Healthcheck — safe to call publicly. Reveals config state.","operationId":"mpp_health_v1_receipt_mpp_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mpp Health V1 Receipt Mpp Health Get"}}}}}}},"/v1/receipt/mpp":{"post":{"tags":["mpp"],"summary":"Mint Via Mpp","description":"Mint a Hive PQ receipt, gated by MPP HTTP 402 over Stripe.\n\nReturns 402 + WWW-Authenticate on first call (no credential).\nReturns 200 + receipt body + Payment-Receipt header on success.\nReturns 503 if MPP is not yet configured (gracefully directs to x402).","operationId":"mint_via_mpp_v1_receipt_mpp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptMintBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/receipt/mpp/spt":{"post":{"tags":["mpp"],"summary":"Create Spt","description":"Stripe Shared Payment Token proxy.\n\nThe pympp client calls this with a payment method ID and challenge details.\nWe hit Stripe's test-helper SPT endpoint using our server-side secret key.\nIn production replace `test_helpers/shared_payment/granted_tokens` with\nthe real SPT endpoint once Stripe lifts the test-helper gate.","operationId":"create_spt_v1_receipt_mpp_spt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SPTBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/mpp.json":{"get":{"tags":["mpp"],"summary":"Mpp Discovery","description":"Serve the MPP service discovery manifest.\n\nFormat: matches https://mpp.tempo.xyz/schemas/discovery.schema.json (v1).\nLets MPPScan + any compliant aggregator auto-discover Hive without a PR.","operationId":"mpp_discovery__well_known_mpp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mpp Discovery  Well Known Mpp Json Get"}}}}}}},"/v1/traffic/stats":{"get":{"tags":["traffic"],"summary":"Multi-window traffic stats (1h, 6h, 24h, 7d)","operationId":"traffic_stats_multi_v1_traffic_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Traffic Stats Multi V1 Traffic Stats Get"}}}}}}},"/v1/traffic/stats/{hours}":{"get":{"tags":["traffic"],"summary":"Traffic stats for a single window","operationId":"traffic_stats_single_v1_traffic_stats__hours__get","parameters":[{"name":"hours","in":"path","required":true,"schema":{"type":"number","title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Traffic Stats Single V1 Traffic Stats  Hours  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/traffic/recent":{"get":{"tags":["traffic"],"summary":"Recently-seen paths (last 1h)","operationId":"traffic_recent_v1_traffic_recent_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Traffic Recent V1 Traffic Recent Get"}}}}}}},"/v1/traffic/campaign":{"get":{"tags":["traffic"],"summary":"Campaign-relevant traffic slice","description":"Return per-prefix request counts for the surfaces we're actively driving\ntraffic to. Useful for measuring tweet/post conversion.","operationId":"traffic_campaign_v1_traffic_campaign_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Traffic Campaign V1 Traffic Campaign Get"}}}}}}},"/v1/mark/attest":{"post":{"tags":["hive-mark"],"summary":"Attest Mark","description":"Record a first-use trademark attestation.\n\nWraps the /v1/receipt/issue endpoint (ML-DSA-65 + Ed25519 dual-signed CBOR\nenvelope). Persists to mark_attestations.jsonl. Returns the full receipt\nenvelope plus mark-specific fields.","operationId":"attest_mark_v1_mark_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_mark__routes__AttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Attest Mark V1 Mark Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mark/by-text/{mark_text}":{"get":{"tags":["hive-mark"],"summary":"Attestations By Text","description":"Return all attestations for an exact mark string (case-insensitive, URL-decoded).\n\nResults are chronological — earliest first. The first result is the\npriority-proving attestation.","operationId":"attestations_by_text_v1_mark_by_text__mark_text__get","parameters":[{"name":"mark_text","in":"path","required":true,"schema":{"type":"string","title":"Mark Text"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Attestations By Text V1 Mark By Text  Mark Text  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mark/by-owner/{did}":{"get":{"tags":["hive-mark"],"summary":"Attestations By Owner","description":"Return all marks attested by an owner DID.","operationId":"attestations_by_owner_v1_mark_by_owner__did__get","parameters":[{"name":"did","in":"path","required":true,"schema":{"type":"string","title":"Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Attestations By Owner V1 Mark By Owner  Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mark/monitor":{"post":{"tags":["hive-mark"],"summary":"Create Monitor","description":"Create a brand monitoring record at the $50/month tier.\n\nPersists to mark_monitors.jsonl. Returns monitor_id + watched_marks count.","operationId":"create_monitor_v1_mark_monitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Monitor V1 Mark Monitor Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mark/health":{"get":{"tags":["hive-mark"],"summary":"Mark Health","description":"Health check with counts.","operationId":"mark_health_v1_mark_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mark Health V1 Mark Health Get"}}}}}}},"/v1/origin/create":{"post":{"tags":["hive-origin"],"summary":"Create Origin","description":"Stamp a work hash with a dual-signed receipt envelope (ML-DSA-65 + Ed25519).\n\nPersists to origin_records.jsonl. The earliest record for a given\nwork_hash is the proven copyright holder.","operationId":"create_origin_v1_origin_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Origin V1 Origin Create Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/origin/by-hash/{work_hash}":{"get":{"tags":["hive-origin"],"summary":"Origins By Hash","description":"Return all creators who have stamped this work hash.\n\nResults are chronological — earliest is the proven creator.","operationId":"origins_by_hash_v1_origin_by_hash__work_hash__get","parameters":[{"name":"work_hash","in":"path","required":true,"schema":{"type":"string","title":"Work Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Origins By Hash V1 Origin By Hash  Work Hash  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/origin/by-creator/{did}":{"get":{"tags":["hive-origin"],"summary":"Origins By Creator","description":"Paginated list of works by a creator DID (default 50 per page).","operationId":"origins_by_creator_v1_origin_by_creator__did__get","parameters":[{"name":"did","in":"path","required":true,"schema":{"type":"string","title":"Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Origins By Creator V1 Origin By Creator  Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/origin/git-integration":{"post":{"tags":["hive-origin"],"summary":"Git Integration","description":"Auto-receipt every git commit at the $50/month integration tier.\n\nStamps each commit SHA as a copyright creation event. Persists to\norigin_git.jsonl. Returns origin_id + receipt envelope for the commit.","operationId":"git_integration_v1_origin_git_integration_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitIntegrationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Git Integration V1 Origin Git Integration Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/origin/health":{"get":{"tags":["hive-origin"],"summary":"Origin Health","description":"Health check with counts.","operationId":"origin_health_v1_origin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Origin Health V1 Origin Health Get"}}}}}}},"/v1/media-origin/health":{"get":{"tags":["media-origin"],"summary":"Media Origin Health","operationId":"media_origin_health_v1_media_origin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Media Origin Health V1 Media Origin Health Get"}}}}}}},"/v1/media-origin/receipt":{"post":{"tags":["media-origin"],"summary":"Media Origin Receipt","operationId":"media_origin_receipt_v1_media_origin_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Media Origin Receipt V1 Media Origin Receipt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/media-origin/verify":{"post":{"tags":["media-origin"],"summary":"Media Origin Verify","operationId":"media_origin_verify_v1_media_origin_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_media_origin__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Media Origin Verify V1 Media Origin Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/media-origin/examples":{"get":{"tags":["media-origin"],"summary":"Media Origin Examples","operationId":"media_origin_examples_v1_media_origin_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Media Origin Examples V1 Media Origin Examples Get"}}}}}}},"/v1/mor/health":{"get":{"tags":["media-origin"],"summary":"Mor Health","operationId":"mor_health_v1_mor_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mor Health V1 Mor Health Get"}}}}}}},"/v1/mor/issue":{"post":{"tags":["media-origin"],"summary":"Mor Issue","operationId":"mor_issue_v1_mor_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mor Issue V1 Mor Issue Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mor/verify":{"post":{"tags":["media-origin"],"summary":"Mor Verify","operationId":"mor_verify_v1_mor_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_media_origin__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mor Verify V1 Mor Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mor/examples":{"get":{"tags":["media-origin"],"summary":"Mor Examples","operationId":"mor_examples_v1_mor_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mor Examples V1 Mor Examples Get"}}}}}}},"/v1/morso/health":{"get":{"tags":["morso"],"summary":"Morso Health","operationId":"morso_health_v1_morso_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Health V1 Morso Health Get"}}}}}}},"/v1/morso/issue":{"post":{"tags":["morso"],"summary":"Morso Issue","operationId":"morso_issue_v1_morso_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Issue V1 Morso Issue Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morso/receipt":{"post":{"tags":["morso"],"summary":"Morso Receipt","operationId":"morso_receipt_v1_morso_receipt_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Receipt V1 Morso Receipt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morso/verify":{"post":{"tags":["morso"],"summary":"Morso Verify","operationId":"morso_verify_v1_morso_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_morso__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Verify V1 Morso Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morso/classify":{"post":{"tags":["morso"],"summary":"Morso Classify","description":"Classify an excerpt without issuing a signed receipt (preview only).","operationId":"morso_classify_v1_morso_classify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_morso__routes__ClassifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Classify V1 Morso Classify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morso/examples":{"get":{"tags":["morso"],"summary":"Morso Examples","operationId":"morso_examples_v1_morso_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Morso Examples V1 Morso Examples Get"}}}}}}},"/v1/afir-stream/health":{"get":{"tags":["afir-stream"],"summary":"Afir Stream Health","operationId":"afir_stream_health_v1_afir_stream_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Stream Health V1 Afir Stream Health Get"}}}}}}},"/v1/afir-stream/segment":{"post":{"tags":["afir-stream"],"summary":"Afir Stream Segment","operationId":"afir_stream_segment_v1_afir_stream_segment_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SegmentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Stream Segment V1 Afir Stream Segment Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir-stream/seal":{"post":{"tags":["afir-stream"],"summary":"Afir Stream Seal","operationId":"afir_stream_seal_v1_afir_stream_seal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SealRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Stream Seal V1 Afir Stream Seal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir-stream/verify":{"post":{"tags":["afir-stream"],"summary":"Afir Stream Verify","operationId":"afir_stream_verify_v1_afir_stream_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_afir_stream__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Stream Verify V1 Afir Stream Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir-stream/examples":{"get":{"tags":["afir-stream"],"summary":"Afir Stream Examples","operationId":"afir_stream_examples_v1_afir_stream_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Stream Examples V1 Afir Stream Examples Get"}}}}}}},"/v1/afir/health":{"get":{"tags":["afir-stream"],"summary":"Afir Health","operationId":"afir_health_v1_afir_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Health V1 Afir Health Get"}}}}}}},"/v1/afir/segment":{"post":{"tags":["afir-stream"],"summary":"Afir Segment","operationId":"afir_segment_v1_afir_segment_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SegmentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Segment V1 Afir Segment Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir/seal":{"post":{"tags":["afir-stream"],"summary":"Afir Seal","operationId":"afir_seal_v1_afir_seal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SealRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Seal V1 Afir Seal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir/verify":{"post":{"tags":["afir-stream"],"summary":"Afir Verify","operationId":"afir_verify_v1_afir_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_afir_stream__routes__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Verify V1 Afir Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/afir/examples":{"get":{"tags":["afir-stream"],"summary":"Afir Examples","operationId":"afir_examples_v1_afir_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Afir Examples V1 Afir Examples Get"}}}}}}},"/v1/prior/mcp":{"get":{"summary":"Prior Mcp Meta","operationId":"prior_mcp_meta_v1_prior_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Prior Mcp","operationId":"prior_mcp_v1_prior_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mark/mcp":{"get":{"summary":"Mark Mcp Meta","operationId":"mark_mcp_meta_v1_mark_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Mark Mcp","operationId":"mark_mcp_v1_mark_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/origin/mcp":{"get":{"summary":"Origin Mcp Meta","operationId":"origin_mcp_meta_v1_origin_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Origin Mcp","operationId":"origin_mcp_v1_origin_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/tradeguard/health":{"get":{"tags":["tradeguard"],"summary":"Health","operationId":"health_v1_tradeguard_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Tradeguard Health Get"}}}}}}},"/v1/tradeguard/pricing":{"get":{"tags":["tradeguard"],"summary":"Pricing","operationId":"pricing_v1_tradeguard_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Tradeguard Pricing Get"}}}}}}},"/v1/tradeguard/attest":{"post":{"tags":["tradeguard"],"summary":"Attest Trade","operationId":"attest_trade_v1_tradeguard_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/verify/{attestation_id}":{"get":{"tags":["tradeguard"],"summary":"Verify Attestation","operationId":"verify_attestation_v1_tradeguard_verify__attestation_id__get","parameters":[{"name":"attestation_id","in":"path","required":true,"schema":{"type":"string","title":"Attestation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_tradeguard__models__VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/by-event-hash/{order_event_hash}":{"get":{"tags":["tradeguard"],"summary":"By Event Hash","operationId":"by_event_hash_v1_tradeguard_by_event_hash__order_event_hash__get","parameters":[{"name":"order_event_hash","in":"path","required":true,"schema":{"type":"string","title":"Order Event Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Event Hash V1 Tradeguard By Event Hash  Order Event Hash  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/by-trader/{trader_did}":{"get":{"tags":["tradeguard"],"summary":"By Trader","operationId":"by_trader_v1_tradeguard_by_trader__trader_did__get","parameters":[{"name":"trader_did","in":"path","required":true,"schema":{"type":"string","title":"Trader Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Trader V1 Tradeguard By Trader  Trader Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/by-firm/{firm_did}":{"get":{"tags":["tradeguard"],"summary":"By Firm","operationId":"by_firm_v1_tradeguard_by_firm__firm_did__get","parameters":[{"name":"firm_did","in":"path","required":true,"schema":{"type":"string","title":"Firm Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Firm V1 Tradeguard By Firm  Firm Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/by-algo/{firm_did}/{algo_id}":{"get":{"tags":["tradeguard"],"summary":"By Algo","operationId":"by_algo_v1_tradeguard_by_algo__firm_did___algo_id__get","parameters":[{"name":"firm_did","in":"path","required":true,"schema":{"type":"string","title":"Firm Did"}},{"name":"algo_id","in":"path","required":true,"schema":{"type":"string","title":"Algo Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Algo V1 Tradeguard By Algo  Firm Did   Algo Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/leaderboard":{"get":{"tags":["tradeguard"],"summary":"Leaderboard","operationId":"leaderboard_v1_tradeguard_leaderboard_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Leaderboard V1 Tradeguard Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tradeguard/mcp":{"get":{"summary":"Tradeguard Mcp Meta","operationId":"tradeguard_mcp_meta_v1_tradeguard_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Tradeguard Mcp","operationId":"tradeguard_mcp_v1_tradeguard_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/edi/wrap":{"post":{"tags":["edi"],"summary":"Wrap Endpoint","operationId":"wrap_endpoint_v1_edi_wrap_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EDIWrapRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EDIWrapResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/edi/parse":{"post":{"tags":["edi"],"summary":"Parse Endpoint","operationId":"parse_endpoint_v1_edi_parse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EDIParseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EDIParseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/edi/formats":{"get":{"tags":["edi"],"summary":"Formats Endpoint","operationId":"formats_endpoint_v1_edi_formats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Formats Endpoint V1 Edi Formats Get"}}}}}}},"/v1/edi/pricing":{"get":{"tags":["edi"],"summary":"Pricing Endpoint","operationId":"pricing_endpoint_v1_edi_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing Endpoint V1 Edi Pricing Get"}}}}}}},"/v1/edi/health":{"get":{"tags":["edi"],"summary":"Health Endpoint","operationId":"health_endpoint_v1_edi_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Endpoint V1 Edi Health Get"}}}}}}},"/v1/edi/mcp":{"get":{"summary":"Edi Mcp Meta","operationId":"edi_mcp_meta_v1_edi_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Edi Mcp","operationId":"edi_mcp_v1_edi_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/procurelock/health":{"get":{"tags":["procurelock"],"summary":"Health","operationId":"health_v1_procurelock_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Procurelock Health Get"}}}}}}},"/v1/procurelock/pricing":{"get":{"tags":["procurelock"],"summary":"Pricing","operationId":"pricing_v1_procurelock_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Procurelock Pricing Get"}}}}}}},"/v1/procurelock/po_attest":{"post":{"tags":["procurelock"],"summary":"Po Attest","operationId":"po_attest_v1_procurelock_po_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/POAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/POAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/po_get/{attestation_id}":{"get":{"tags":["procurelock"],"summary":"Po Get","operationId":"po_get_v1_procurelock_po_get__attestation_id__get","parameters":[{"name":"attestation_id","in":"path","required":true,"schema":{"type":"string","title":"Attestation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Po Get V1 Procurelock Po Get  Attestation Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/po_verify/{attestation_id}":{"get":{"tags":["procurelock"],"summary":"Po Verify","operationId":"po_verify_v1_procurelock_po_verify__attestation_id__get","parameters":[{"name":"attestation_id","in":"path","required":true,"schema":{"type":"string","title":"Attestation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/POVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/delivery_attest":{"post":{"tags":["procurelock"],"summary":"Delivery Attest","operationId":"delivery_attest_v1_procurelock_delivery_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/match_verify":{"post":{"tags":["procurelock"],"summary":"Match Verify","operationId":"match_verify_v1_procurelock_match_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/by-buyer/{buyer_did}":{"get":{"tags":["procurelock"],"summary":"By Buyer","operationId":"by_buyer_v1_procurelock_by_buyer__buyer_did__get","parameters":[{"name":"buyer_did","in":"path","required":true,"schema":{"type":"string","title":"Buyer Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Buyer V1 Procurelock By Buyer  Buyer Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/by-supplier/{supplier_did}":{"get":{"tags":["procurelock"],"summary":"By Supplier","operationId":"by_supplier_v1_procurelock_by_supplier__supplier_did__get","parameters":[{"name":"supplier_did","in":"path","required":true,"schema":{"type":"string","title":"Supplier Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Supplier V1 Procurelock By Supplier  Supplier Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/by-po/{po_number}":{"get":{"tags":["procurelock"],"summary":"By Po","operationId":"by_po_v1_procurelock_by_po__po_number__get","parameters":[{"name":"po_number","in":"path","required":true,"schema":{"type":"string","title":"Po Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Po V1 Procurelock By Po  Po Number  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/procurelock/mcp":{"get":{"summary":"Procurelock Mcp Meta","operationId":"procurelock_mcp_meta_v1_procurelock_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Procurelock Mcp","operationId":"procurelock_mcp_v1_procurelock_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/deedlock/health":{"get":{"tags":["deedlock"],"summary":"Health","operationId":"health_v1_deedlock_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Deedlock Health Get"}}}}}}},"/v1/deedlock/pricing":{"get":{"tags":["deedlock"],"summary":"Pricing","operationId":"pricing_v1_deedlock_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Deedlock Pricing Get"}}}}}}},"/v1/deedlock/deed_attest":{"post":{"tags":["deedlock"],"summary":"Deed Attest","operationId":"deed_attest_v1_deedlock_deed_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeedAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeedAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/notary_session":{"post":{"tags":["deedlock"],"summary":"Notary Session","operationId":"notary_session_v1_deedlock_notary_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotarySessionRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotarySessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/recording_attest":{"post":{"tags":["deedlock"],"summary":"Recording Attest","operationId":"recording_attest_v1_deedlock_recording_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordingAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordingAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/deed_get/{attestation_id}":{"get":{"tags":["deedlock"],"summary":"Deed Get","operationId":"deed_get_v1_deedlock_deed_get__attestation_id__get","parameters":[{"name":"attestation_id","in":"path","required":true,"schema":{"type":"string","title":"Attestation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Deed Get V1 Deedlock Deed Get  Attestation Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/deed_verify/{attestation_id}":{"get":{"tags":["deedlock"],"summary":"Deed Verify","operationId":"deed_verify_v1_deedlock_deed_verify__attestation_id__get","parameters":[{"name":"attestation_id","in":"path","required":true,"schema":{"type":"string","title":"Attestation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeedVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/chain_verify":{"post":{"tags":["deedlock"],"summary":"Chain Verify","operationId":"chain_verify_v1_deedlock_chain_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_deedlock__models__ChainVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/by-property/{property_id}":{"get":{"tags":["deedlock"],"summary":"By Property","operationId":"by_property_v1_deedlock_by_property__property_id__get","parameters":[{"name":"property_id","in":"path","required":true,"schema":{"type":"string","title":"Property Id"}},{"name":"buyer_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Did"}},{"name":"seller_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller Did"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Property V1 Deedlock By Property  Property Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/by-buyer/{buyer_did}":{"get":{"tags":["deedlock"],"summary":"By Buyer","operationId":"by_buyer_v1_deedlock_by_buyer__buyer_did__get","parameters":[{"name":"buyer_did","in":"path","required":true,"schema":{"type":"string","title":"Buyer Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Buyer V1 Deedlock By Buyer  Buyer Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/by-seller/{seller_did}":{"get":{"tags":["deedlock"],"summary":"By Seller","operationId":"by_seller_v1_deedlock_by_seller__seller_did__get","parameters":[{"name":"seller_did","in":"path","required":true,"schema":{"type":"string","title":"Seller Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Seller V1 Deedlock By Seller  Seller Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/by-notary/{notary_did}":{"get":{"tags":["deedlock"],"summary":"By Notary","operationId":"by_notary_v1_deedlock_by_notary__notary_did__get","parameters":[{"name":"notary_did","in":"path","required":true,"schema":{"type":"string","title":"Notary Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Notary V1 Deedlock By Notary  Notary Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/deedlock/mcp":{"get":{"summary":"Deedlock Mcp Meta","operationId":"deedlock_mcp_meta_v1_deedlock_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Deedlock Mcp","operationId":"deedlock_mcp_v1_deedlock_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/provebirth/health":{"get":{"tags":["provebirth"],"summary":"Health","operationId":"health_v1_provebirth_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Provebirth Health Get"}}}}}}},"/v1/provebirth/pricing":{"get":{"tags":["provebirth"],"summary":"Pricing","operationId":"pricing_v1_provebirth_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Provebirth Pricing Get"}}}}}}},"/v1/provebirth/cert/issue":{"post":{"tags":["provebirth"],"summary":"Cert Issue","operationId":"cert_issue_v1_provebirth_cert_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthCertIssueRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthCertIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/cert/{cert_id}":{"get":{"tags":["provebirth"],"summary":"Cert Get","operationId":"cert_get_v1_provebirth_cert__cert_id__get","parameters":[{"name":"cert_id","in":"path","required":true,"schema":{"type":"string","title":"Cert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cert Get V1 Provebirth Cert  Cert Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/cert/verify":{"post":{"tags":["provebirth"],"summary":"Cert Verify","operationId":"cert_verify_v1_provebirth_cert_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthCertVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthCertVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/action/attest":{"post":{"tags":["provebirth"],"summary":"Action Attest","operationId":"action_attest_v1_provebirth_action_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionAttestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/lineage/verify":{"post":{"tags":["provebirth"],"summary":"Lineage Verify","operationId":"lineage_verify_v1_provebirth_lineage_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LineageVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LineageVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/by-agent/{agent_did}":{"get":{"tags":["provebirth"],"summary":"By Agent","operationId":"by_agent_v1_provebirth_by_agent__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","title":"Agent Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Agent V1 Provebirth By Agent  Agent Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/by-controller/{controller_did}":{"get":{"tags":["provebirth"],"summary":"By Controller","operationId":"by_controller_v1_provebirth_by_controller__controller_did__get","parameters":[{"name":"controller_did","in":"path","required":true,"schema":{"type":"string","title":"Controller Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Controller V1 Provebirth By Controller  Controller Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/provebirth/by-model/{model_pin}":{"get":{"tags":["provebirth"],"summary":"By Model","operationId":"by_model_v1_provebirth_by_model__model_pin__get","parameters":[{"name":"model_pin","in":"path","required":true,"schema":{"type":"string","title":"Model Pin"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Model V1 Provebirth By Model  Model Pin  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/provebirth":{"get":{"summary":"Provebirth Mcp Meta","operationId":"provebirth_mcp_meta_v1_mcp_provebirth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Provebirth Mcp","operationId":"provebirth_mcp_v1_mcp_provebirth_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/purity/health":{"get":{"tags":["purity"],"summary":"Health","operationId":"health_v1_purity_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Purity Health Get"}}}}}}},"/v1/purity/cert/issue":{"post":{"tags":["purity"],"summary":"Cert Issue","operationId":"cert_issue_v1_purity_cert_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurityCertIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurityCertIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/purity/cert/{cert_id}":{"get":{"tags":["purity"],"summary":"Cert Get","operationId":"cert_get_v1_purity_cert__cert_id__get","parameters":[{"name":"cert_id","in":"path","required":true,"schema":{"type":"string","title":"Cert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cert Get V1 Purity Cert  Cert Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/aegis/health":{"get":{"tags":["aegis"],"summary":"Health","operationId":"health_v1_aegis_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Aegis Health Get"}}}}}}},"/v1/aegis/control/audit":{"post":{"tags":["aegis"],"summary":"Control Audit","operationId":"control_audit_v1_aegis_control_audit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlAuditRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Control Audit V1 Aegis Control Audit Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/aegis/scan":{"post":{"tags":["aegis"],"summary":"Full Scan","operationId":"full_scan_v1_aegis_scan_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Full Scan V1 Aegis Scan Post"}}}}}}},"/v1/aegis/score":{"get":{"tags":["aegis"],"summary":"Score","operationId":"score_v1_aegis_score_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/aegis/control/{control_id}":{"get":{"tags":["aegis"],"summary":"Control Get","operationId":"control_get_v1_aegis_control__control_id__get","parameters":[{"name":"control_id","in":"path","required":true,"schema":{"type":"string","title":"Control Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Control Get V1 Aegis Control  Control Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/aegis/matrix":{"get":{"tags":["aegis"],"summary":"Matrix","operationId":"matrix_v1_aegis_matrix_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Matrix V1 Aegis Matrix Get"}}}}}}},"/v1/cns/health":{"get":{"tags":["cns"],"summary":"Health","operationId":"health_v1_cns_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Cns Health Get"}}}}}}},"/v1/cns/transfer":{"post":{"tags":["cns"],"summary":"Transfer","operationId":"transfer_v1_cns_transfer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cns/transfer/{transfer_id}":{"get":{"tags":["cns"],"summary":"Transfer Get","operationId":"transfer_get_v1_cns_transfer__transfer_id__get","parameters":[{"name":"transfer_id","in":"path","required":true,"schema":{"type":"string","title":"Transfer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Transfer Get V1 Cns Transfer  Transfer Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cns/benchmark":{"get":{"tags":["cns"],"summary":"Benchmark","operationId":"benchmark_v1_cns_benchmark_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Benchmark V1 Cns Benchmark Get"}}}}}}},"/v1/cre/health":{"get":{"tags":["cre"],"summary":"Health","operationId":"health_v1_cre_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Cre Health Get"}}}}}}},"/v1/cre/issue":{"post":{"tags":["cre"],"summary":"Issue","operationId":"issue_v1_cre_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CREIssueRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CREIssueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cre/envelope/{cre_id}":{"get":{"tags":["cre"],"summary":"Envelope Get","operationId":"envelope_get_v1_cre_envelope__cre_id__get","parameters":[{"name":"cre_id","in":"path","required":true,"schema":{"type":"string","title":"Cre Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Envelope Get V1 Cre Envelope  Cre Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cre/verify":{"post":{"tags":["cre"],"summary":"Verify","description":"Verify a CRE envelope.\n\nThe envelope can be passed in directly OR referenced by cre_id.","operationId":"verify_v1_cre_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Envelope"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CREVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cre/coverage":{"get":{"tags":["cre"],"summary":"Coverage","description":"Per-framework coverage across all CRE envelopes ever issued.\n\nFor each framework, returns the % of catalog controls that have been\nattested by AT LEAST ONE issued envelope. This is the live answer to\n'are you SOC 2 / HIPAA / etc. compliant' — measured continuously\nfrom real transactions, not from an annual audit.","operationId":"coverage_v1_cre_coverage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Coverage V1 Cre Coverage Get"}}}}}}},"/v1/cre/tbr/manifest":{"get":{"tags":["cre"],"summary":"Tbr Manifest","description":"Disclosure of the TBR cryptographic stack actually deployed.\n\nHonest perf, no overclaims, explicit list of NOT-USED constructions\n(organoid entropy, 2-of-3 thresholds, single-zkSNARK-replaces-frameworks).","operationId":"tbr_manifest_v1_cre_tbr_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tbr Manifest V1 Cre Tbr Manifest Get"}}}}}}},"/v1/cre/tbr/perf":{"get":{"tags":["cre"],"summary":"Tbr Perf","description":"Honest measured performance of the TBR primitives.\n\nNumbers are gathered live by exercising each primitive a small number\nof times.  This is operational telemetry, not a benchmark publication.","operationId":"tbr_perf_v1_cre_tbr_perf_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tbr Perf V1 Cre Tbr Perf Get"}}}}}}},"/v1/cre/tbr/kem/generate":{"post":{"tags":["cre"],"summary":"Tbr Kem Generate","description":"Generate a one-shot hybrid-KEM keypair (ephemeral, server-side).\n\nReturns ONLY the public key material; the corresponding secret key\nis held in process memory under the returned `kem_id` and discarded\nafter a single decap or 5 minutes, whichever comes first.","operationId":"tbr_kem_generate_v1_cre_tbr_kem_generate_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tbr Kem Generate V1 Cre Tbr Kem Generate Post"}}}}}}},"/v1/cre/tbr/kem/selftest":{"get":{"tags":["cre"],"summary":"Tbr Kem Selftest","description":"Self-test of the hybrid-KEM combiner.\n\nGenerates a keypair, encapsulates, decapsulates, asserts the two\nderived shared secrets match, and reports honest timing.  Does not\npersist any keys.","operationId":"tbr_kem_selftest_v1_cre_tbr_kem_selftest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tbr Kem Selftest V1 Cre Tbr Kem Selftest Get"}}}}}}},"/v1/cre/tbr/entropy/health":{"get":{"tags":["cre"],"summary":"Tbr Entropy Health","description":"Operational entropy health telemetry (NOT a FIPS 140-3 claim).","operationId":"tbr_entropy_health_v1_cre_tbr_entropy_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Tbr Entropy Health V1 Cre Tbr Entropy Health Get"}}}}}}},"/v1/cre/manifesto":{"get":{"tags":["cre"],"summary":"Manifesto","operationId":"manifesto_v1_cre_manifesto_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CREManifesto"}}}}}}},"/v1/hivecomply/health":{"get":{"tags":["hivecomply","hivecomply"],"summary":"Health","operationId":"health_v1_hivecomply_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Hivecomply Health Get"}}}}}}},"/v1/hivecomply/pricing":{"get":{"tags":["hivecomply","hivecomply"],"summary":"Pricing","operationId":"pricing_v1_hivecomply_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Hivecomply Pricing Get"}}}}}}},"/v1/hivecomply/framework/map":{"get":{"tags":["hivecomply","hivecomply"],"summary":"Framework Map","description":"Return all 11 framework profiles with their controls.","operationId":"framework_map_v1_hivecomply_framework_map_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Framework Map V1 Hivecomply Framework Map Get"}}}}}}},"/v1/hivecomply/control/status":{"get":{"tags":["hivecomply","hivecomply"],"summary":"Control Status Endpoint","description":"Return event counts and last_event_at for a specific control.","operationId":"control_status_endpoint_v1_hivecomply_control_status_get","parameters":[{"name":"framework","in":"query","required":true,"schema":{"type":"string","description":"Framework code, e.g. SOC2","title":"Framework"},"description":"Framework code, e.g. SOC2"},{"name":"control","in":"query","required":true,"schema":{"type":"string","description":"Control code, e.g. CC6.1","title":"Control"},"description":"Control code, e.g. CC6.1"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Control Status Endpoint V1 Hivecomply Control Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hivecomply/event/ingest":{"post":{"tags":["hivecomply","hivecomply"],"summary":"Event Ingest","description":"Ingest a compliance event and return a dual-signed receipt.","operationId":"event_ingest_v1_hivecomply_event_ingest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceEventIngestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Event Ingest V1 Hivecomply Event Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hivecomply/evidence/query":{"post":{"tags":["hivecomply","hivecomply"],"summary":"Evidence Query","description":"Query compliance events by framework, control, and time period.","operationId":"evidence_query_v1_hivecomply_evidence_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceQueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Evidence Query V1 Hivecomply Evidence Query Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hivecomply/bundle/export":{"post":{"tags":["hivecomply","hivecomply"],"summary":"Bundle Export","description":"Export a canonical evidence bundle with bundle_hash + dual signatures.","operationId":"bundle_export_v1_hivecomply_bundle_export_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceBundleExportRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bundle Export V1 Hivecomply Bundle Export Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hivecomply/bundle/verify":{"post":{"tags":["hivecomply","hivecomply"],"summary":"Bundle Verify","description":"Verify a canonical evidence bundle offline.","operationId":"bundle_verify_v1_hivecomply_bundle_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bundle Verify V1 Hivecomply Bundle Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/hivecomply":{"get":{"tags":["hivecomply-mcp"],"summary":"Hivecomply Mcp Meta","operationId":"hivecomply_mcp_meta_v1_mcp_hivecomply_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["hivecomply-mcp"],"summary":"Hivecomply Mcp","operationId":"hivecomply_mcp_v1_mcp_hivecomply_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/clear/health":{"get":{"tags":["clear","clear"],"summary":"Health","operationId":"health_v1_clear_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Clear Health Get"}}}}}}},"/v1/clear/pricing":{"get":{"tags":["clear","clear"],"summary":"Pricing","operationId":"pricing_v1_clear_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Clear Pricing Get"}}}}}}},"/v1/clear/pa/submit":{"post":{"tags":["clear","clear"],"summary":"Pa Submit","description":"Submit a Prior Authorization and return a dual-signed receipt.","operationId":"pa_submit_v1_clear_pa_submit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PASubmitRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pa Submit V1 Clear Pa Submit Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/pa/{pa_id}":{"get":{"tags":["clear","clear"],"summary":"Pa Get","description":"Retrieve a stored PA by id.","operationId":"pa_get_v1_clear_pa__pa_id__get","parameters":[{"name":"pa_id","in":"path","required":true,"schema":{"type":"string","title":"Pa Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pa Get V1 Clear Pa  Pa Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/pa/verify":{"post":{"tags":["clear","clear"],"summary":"Pa Verify","description":"Verify a stored PA's dual-signed receipt.","operationId":"pa_verify_v1_clear_pa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PAVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pa Verify V1 Clear Pa Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/decision/attest":{"post":{"tags":["clear","clear"],"summary":"Decision Attest","description":"Attest a payer decision (approve/deny/pend) with chain pointer to PA.","operationId":"decision_attest_v1_clear_decision_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Decision Attest V1 Clear Decision Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/p2p/attest":{"post":{"tags":["clear","clear"],"summary":"P2P Attest","description":"Attest a peer-to-peer review with chain pointer to the decision.","operationId":"p2p_attest_v1_clear_p2p_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/P2PAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response P2P Attest V1 Clear P2P Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/appeal/attest":{"post":{"tags":["clear","clear"],"summary":"Appeal Attest","description":"Attest an appeal with chain pointer to the denial decision.","operationId":"appeal_attest_v1_clear_appeal_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppealAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Appeal Attest V1 Clear Appeal Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/chain/verify":{"post":{"tags":["clear","clear"],"summary":"Chain Verify","description":"Verify the full lifecycle chain for a PA.","operationId":"chain_verify_v1_clear_chain_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_clear__models__ChainVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Chain Verify V1 Clear Chain Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/by-payer/{payer_did}":{"get":{"tags":["clear","clear"],"summary":"By Payer","description":"Paginated PA submission history by payer DID.","operationId":"by_payer_v1_clear_by_payer__payer_did__get","parameters":[{"name":"payer_did","in":"path","required":true,"schema":{"type":"string","title":"Payer Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Payer V1 Clear By Payer  Payer Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clear/by-provider/{provider_did}":{"get":{"tags":["clear","clear"],"summary":"By Provider","description":"Paginated PA submission history by provider DID.","operationId":"by_provider_v1_clear_by_provider__provider_did__get","parameters":[{"name":"provider_did","in":"path","required":true,"schema":{"type":"string","title":"Provider Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Provider V1 Clear By Provider  Provider Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/clear":{"get":{"tags":["clear-mcp"],"summary":"Clear Mcp Meta","operationId":"clear_mcp_meta_v1_mcp_clear_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["clear-mcp"],"summary":"Clear Mcp","operationId":"clear_mcp_v1_mcp_clear_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/newsshield/health":{"get":{"tags":["newsshield","newsshield"],"summary":"Health","operationId":"health_v1_newsshield_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Newsshield Health Get"}}}}}}},"/v1/newsshield/pricing":{"get":{"tags":["newsshield","newsshield"],"summary":"Pricing","operationId":"pricing_v1_newsshield_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Newsshield Pricing Get"}}}}}}},"/v1/newsshield/capture/attest":{"post":{"tags":["newsshield","newsshield"],"summary":"Capture Attest","description":"Attest a capture event (camera/mic) and return a dual-signed receipt.","operationId":"capture_attest_v1_newsshield_capture_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Capture Attest V1 Newsshield Capture Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/edit/attest":{"post":{"tags":["newsshield","newsshield"],"summary":"Edit Attest","description":"Attest an edit step with chain pointer.","operationId":"edit_attest_v1_newsshield_edit_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Edit Attest V1 Newsshield Edit Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/publish/attest":{"post":{"tags":["newsshield","newsshield"],"summary":"Publish Attest","description":"Attest a publish event with chain pointer.","operationId":"publish_attest_v1_newsshield_publish_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Publish Attest V1 Newsshield Publish Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/syndicate/attest":{"post":{"tags":["newsshield","newsshield"],"summary":"Syndicate Attest","description":"Attest a syndication with chain pointer to publish.","operationId":"syndicate_attest_v1_newsshield_syndicate_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyndicateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Syndicate Attest V1 Newsshield Syndicate Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/takedown/attest":{"post":{"tags":["newsshield","newsshield"],"summary":"Takedown Attest","description":"Attest a takedown with chain pointer to publish.","operationId":"takedown_attest_v1_newsshield_takedown_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakedownRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Takedown Attest V1 Newsshield Takedown Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/asset/{asset_id}":{"get":{"tags":["newsshield","newsshield"],"summary":"Asset Get","description":"Retrieve all stored envelopes for an asset_id (full lifecycle).","operationId":"asset_get_v1_newsshield_asset__asset_id__get","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Asset Get V1 Newsshield Asset  Asset Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/asset/verify":{"post":{"tags":["newsshield","newsshield"],"summary":"Asset Verify","description":"Verify a stored asset envelope's dual-signed receipt.","operationId":"asset_verify_v1_newsshield_asset_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Asset Verify V1 Newsshield Asset Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/chain/verify":{"post":{"tags":["newsshield","newsshield"],"summary":"Chain Verify","description":"Verify the full lifecycle chain for an asset.","operationId":"chain_verify_v1_newsshield_chain_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_newsshield__models__ChainVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Chain Verify V1 Newsshield Chain Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/newsshield/by-publisher/{publisher_did}":{"get":{"tags":["newsshield","newsshield"],"summary":"By Publisher","description":"Paginated publish history by publisher DID.","operationId":"by_publisher_v1_newsshield_by_publisher__publisher_did__get","parameters":[{"name":"publisher_did","in":"path","required":true,"schema":{"type":"string","title":"Publisher Did"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response By Publisher V1 Newsshield By Publisher  Publisher Did  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/newsshield":{"get":{"tags":["newsshield-mcp"],"summary":"Newsshield Mcp Meta","operationId":"newsshield_mcp_meta_v1_mcp_newsshield_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["newsshield-mcp"],"summary":"Newsshield Mcp","operationId":"newsshield_mcp_v1_mcp_newsshield_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/lex-contract/health":{"get":{"tags":["lex-contract","lex-contract"],"summary":"Health","operationId":"health_v1_lex_contract_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Lex Contract Health Get"}}}}}}},"/v1/lex-contract/pricing":{"get":{"tags":["lex-contract","lex-contract"],"summary":"Pricing","operationId":"pricing_v1_lex_contract_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Lex Contract Pricing Get"}}}}}}},"/v1/lex-contract/draft_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Draft Attest","description":"Record a contract draft creation event.","operationId":"draft_attest_v1_lex_contract_draft_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Draft Attest V1 Lex Contract Draft Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/redline_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Redline Attest","description":"Record a redline/markup event on a contract.","operationId":"redline_attest_v1_lex_contract_redline_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedlineAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Redline Attest V1 Lex Contract Redline Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/signature_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Signature Attest","description":"Record a single-party signature event.","operationId":"signature_attest_v1_lex_contract_signature_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignatureAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Signature Attest V1 Lex Contract Signature Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/execute_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Execute Attest","description":"Record full execution — all parties signed.","operationId":"execute_attest_v1_lex_contract_execute_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Execute Attest V1 Lex Contract Execute Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/amendment_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Amendment Attest","description":"Record a contract amendment.","operationId":"amendment_attest_v1_lex_contract_amendment_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmendmentAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Amendment Attest V1 Lex Contract Amendment Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/notice_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Notice Attest","description":"Record a formal notice (breach, termination intent, renewal opt-in/out).","operationId":"notice_attest_v1_lex_contract_notice_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoticeAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notice Attest V1 Lex Contract Notice Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/termination_attest":{"post":{"tags":["lex-contract","lex-contract"],"summary":"Termination Attest","description":"Record contract termination.","operationId":"termination_attest_v1_lex_contract_termination_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminationAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Termination Attest V1 Lex Contract Termination Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/chain_verify":{"get":{"tags":["lex-contract","lex-contract"],"summary":"Chain Verify Endpoint","description":"Return ordered receipt chain + chain_valid bool + per-receipt sig validity.","operationId":"chain_verify_endpoint_v1_lex_contract_chain_verify_get","parameters":[{"name":"contract_id","in":"query","required":true,"schema":{"type":"string","description":"Contract ID to verify chain for","title":"Contract Id"},"description":"Contract ID to verify chain for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Chain Verify Endpoint V1 Lex Contract Chain Verify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/lex-contract/contract_get":{"get":{"tags":["lex-contract","lex-contract"],"summary":"Contract Get","description":"Return full contract object with all lifecycle events.","operationId":"contract_get_v1_lex_contract_contract_get_get","parameters":[{"name":"contract_id","in":"query","required":true,"schema":{"type":"string","description":"Contract ID to retrieve","title":"Contract Id"},"description":"Contract ID to retrieve"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Contract Get V1 Lex Contract Contract Get Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/lex-contract":{"get":{"summary":"Lex Contract Mcp Meta","operationId":"lex_contract_mcp_meta_v1_mcp_lex_contract_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Lex Contract Mcp","operationId":"lex_contract_mcp_v1_mcp_lex_contract_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/alcoa-agentguard/health":{"get":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Health","operationId":"health_v1_alcoa_agentguard_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Alcoa Agentguard Health Get"}}}}}}},"/v1/alcoa-agentguard/pricing":{"get":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Pricing","operationId":"pricing_v1_alcoa_agentguard_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Alcoa Agentguard Pricing Get"}}}}}}},"/v1/alcoa-agentguard/protocol_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Protocol Attest","description":"Record a protocol or amendment event.","operationId":"protocol_attest_v1_alcoa_agentguard_protocol_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Protocol Attest V1 Alcoa Agentguard Protocol Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/consent_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Consent Attest","description":"Record a patient consent event (with IRB version hash).","operationId":"consent_attest_v1_alcoa_agentguard_consent_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Consent Attest V1 Alcoa Agentguard Consent Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/enrollment_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Enrollment Attest","description":"Record an enrollment event.","operationId":"enrollment_attest_v1_alcoa_agentguard_enrollment_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollmentAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Enrollment Attest V1 Alcoa Agentguard Enrollment Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/dosing_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Dosing Attest","description":"Record a dosing event.","operationId":"dosing_attest_v1_alcoa_agentguard_dosing_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DosingAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dosing Attest V1 Alcoa Agentguard Dosing Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/adverse_event_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Adverse Event Attest","description":"Record an adverse event, SAE, or SUSAR.","operationId":"adverse_event_attest_v1_alcoa_agentguard_adverse_event_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdverseEventAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Adverse Event Attest V1 Alcoa Agentguard Adverse Event Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/data_transfer_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Data Transfer Attest","description":"Record a CRO data handoff / transfer event.","operationId":"data_transfer_attest_v1_alcoa_agentguard_data_transfer_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataTransferAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Data Transfer Attest V1 Alcoa Agentguard Data Transfer Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/database_lock_attest":{"post":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Database Lock Attest","description":"Record a database lock event.","operationId":"database_lock_attest_v1_alcoa_agentguard_database_lock_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseLockAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Database Lock Attest V1 Alcoa Agentguard Database Lock Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/chain_verify":{"get":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Chain Verify Endpoint","description":"Return ordered receipt chain + chain_valid bool + per-receipt sig validity.","operationId":"chain_verify_endpoint_v1_alcoa_agentguard_chain_verify_get","parameters":[{"name":"trial_id","in":"query","required":true,"schema":{"type":"string","description":"Trial ID to verify chain for","title":"Trial Id"},"description":"Trial ID to verify chain for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Chain Verify Endpoint V1 Alcoa Agentguard Chain Verify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alcoa-agentguard/alcoa_audit":{"get":{"tags":["alcoa-agentguard","alcoa-agentguard"],"summary":"Alcoa Audit Endpoint","description":"Return ALCOA+ completeness report — 9 attributes scored 0/1 per receipt + trial-level summary.","operationId":"alcoa_audit_endpoint_v1_alcoa_agentguard_alcoa_audit_get","parameters":[{"name":"trial_id","in":"query","required":true,"schema":{"type":"string","description":"Trial ID to audit ALCOA+ completeness for","title":"Trial Id"},"description":"Trial ID to audit ALCOA+ completeness for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Alcoa Audit Endpoint V1 Alcoa Agentguard Alcoa Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/alcoa-agentguard":{"get":{"summary":"Alcoa Agentguard Mcp Meta","operationId":"alcoa_agentguard_mcp_meta_v1_mcp_alcoa_agentguard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Alcoa Agentguard Mcp","operationId":"alcoa_agentguard_mcp_v1_mcp_alcoa_agentguard_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/hipaa-hive/health":{"get":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Health","operationId":"health_v1_hipaa_hive_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Hipaa Hive Health Get"}}}}}}},"/v1/hipaa-hive/pricing":{"get":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Pricing","operationId":"pricing_v1_hipaa_hive_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Hipaa Hive Pricing Get"}}}}}}},"/v1/hipaa-hive/baa_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Baa Attest","description":"Record a Business Associate Agreement scope attestation.","operationId":"baa_attest_v1_hipaa_hive_baa_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaaAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Baa Attest V1 Hipaa Hive Baa Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/phi_access_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Phi Access Attest","description":"Record a PHI access event.","operationId":"phi_access_attest_v1_hipaa_hive_phi_access_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhiAccessAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Phi Access Attest V1 Hipaa Hive Phi Access Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/phi_disclose_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Phi Disclose Attest","description":"Record a PHI disclosure event.","operationId":"phi_disclose_attest_v1_hipaa_hive_phi_disclose_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhiDiscloseAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Phi Disclose Attest V1 Hipaa Hive Phi Disclose Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/minimum_necessary_check":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Minimum Necessary Check","description":"Run and record a minimum-necessary determination.","operationId":"minimum_necessary_check_v1_hipaa_hive_minimum_necessary_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinimumNecessaryCheckRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Minimum Necessary Check V1 Hipaa Hive Minimum Necessary Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/ai_inference_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Ai Inference Attest","description":"Record an AI agent inference event touching PHI categories.","operationId":"ai_inference_attest_v1_hipaa_hive_ai_inference_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiInferenceAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ai Inference Attest V1 Hipaa Hive Ai Inference Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/patient_access_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Patient Access Attest","description":"Record a 21st Century Cures / USCDI patient-directed access event.","operationId":"patient_access_attest_v1_hipaa_hive_patient_access_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatientAccessAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Patient Access Attest V1 Hipaa Hive Patient Access Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/breach_assessment_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Breach Assessment Attest","description":"Record a 4-factor HIPAA breach risk analysis.","operationId":"breach_assessment_attest_v1_hipaa_hive_breach_assessment_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BreachAssessmentAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Breach Assessment Attest V1 Hipaa Hive Breach Assessment Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/breach_notice_attest":{"post":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Breach Notice Attest","description":"Record a 60-day HIPAA breach notification event.","operationId":"breach_notice_attest_v1_hipaa_hive_breach_notice_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BreachNoticeAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Breach Notice Attest V1 Hipaa Hive Breach Notice Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hipaa-hive/chain_verify":{"get":{"tags":["hipaa-hive","hipaa-hive"],"summary":"Chain Verify Endpoint","description":"Return ordered receipt chain + chain_valid bool + per-receipt sig validity.","operationId":"chain_verify_endpoint_v1_hipaa_hive_chain_verify_get","parameters":[{"name":"covered_entity_did","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Covered entity DID to verify chain for","title":"Covered Entity Did"},"description":"Covered entity DID to verify chain for"},{"name":"patient_did_reference","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pseudonymous patient DID reference to verify chain for","title":"Patient Did Reference"},"description":"Pseudonymous patient DID reference to verify chain for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Chain Verify Endpoint V1 Hipaa Hive Chain Verify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/hipaa-hive":{"get":{"summary":"Hipaa Hive Mcp Meta","operationId":"hipaa_hive_mcp_meta_v1_mcp_hipaa_hive_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Hipaa Hive Mcp","operationId":"hipaa_hive_mcp_v1_mcp_hipaa_hive_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stormlock/health":{"get":{"tags":["stormlock","stormlock"],"summary":"Health","operationId":"health_v1_stormlock_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Stormlock Health Get"}}}}}}},"/v1/stormlock/pricing":{"get":{"tags":["stormlock","stormlock"],"summary":"Pricing","operationId":"pricing_v1_stormlock_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Stormlock Pricing Get"}}}}}}},"/v1/stormlock/bind_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Bind Attest","description":"Record a policy bind event.","operationId":"bind_attest_v1_stormlock_bind_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bind Attest V1 Stormlock Bind Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/oracle_subscribe":{"post":{"tags":["stormlock","stormlock"],"summary":"Oracle Subscribe","description":"Register an oracle for a policy.","operationId":"oracle_subscribe_v1_stormlock_oracle_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OracleSubscribeRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Oracle Subscribe V1 Stormlock Oracle Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/oracle_reading_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Oracle Reading Attest","description":"Record a single oracle reading.","operationId":"oracle_reading_attest_v1_stormlock_oracle_reading_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OracleReadingAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Oracle Reading Attest V1 Stormlock Oracle Reading Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/trigger_eval_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Trigger Eval Attest","description":"Evaluate threshold against oracle reading and record result.","operationId":"trigger_eval_attest_v1_stormlock_trigger_eval_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerEvalAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Trigger Eval Attest V1 Stormlock Trigger Eval Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/loss_calc_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Loss Calc Attest","description":"Record loss calculation and payout amount.","operationId":"loss_calc_attest_v1_stormlock_loss_calc_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LossCalcAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Loss Calc Attest V1 Stormlock Loss Calc Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/payout_auth_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Payout Auth Attest","description":"Record payout authorization (treasury sub-account).","operationId":"payout_auth_attest_v1_stormlock_payout_auth_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAuthAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Payout Auth Attest V1 Stormlock Payout Auth Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/reinsurance_settle_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Reinsurance Settle Attest","description":"Record reinsurance settle leg.","operationId":"reinsurance_settle_attest_v1_stormlock_reinsurance_settle_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReinsuranceSettleAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reinsurance Settle Attest V1 Stormlock Reinsurance Settle Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/dispute_attest":{"post":{"tags":["stormlock","stormlock"],"summary":"Dispute Attest","description":"Record a dispute opened.","operationId":"dispute_attest_v1_stormlock_dispute_attest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeAttestRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dispute Attest V1 Stormlock Dispute Attest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stormlock/chain_verify":{"get":{"tags":["stormlock","stormlock"],"summary":"Chain Verify Endpoint","description":"Return ordered receipt chain + chain_valid bool + per-receipt sig validity.","operationId":"chain_verify_endpoint_v1_stormlock_chain_verify_get","parameters":[{"name":"policy_did","in":"query","required":true,"schema":{"type":"string","description":"Policy DID to verify chain for","title":"Policy Did"},"description":"Policy DID to verify chain for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Chain Verify Endpoint V1 Stormlock Chain Verify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mcp/stormlock":{"get":{"summary":"Stormlock Mcp Meta","operationId":"stormlock_mcp_meta_v1_mcp_stormlock_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Stormlock Mcp","operationId":"stormlock_mcp_v1_mcp_stormlock_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/compress":{"post":{"tags":["smsh"],"summary":"Smsh Compress","description":"Compress a prompt using smsh.\n\nModes:\n  - smsh-lite: dictionary + whitespace (v1 fast)\n  - smsh-std: + structural dedup (v1 default)\n  - smsh-pq-std: + PQ signed envelope (ed25519 baseline, ML-DSA-65 target)\n  - smsh-pq-sealed: + KEM encrypted + signed (x25519+AES-256-GCM, ML-KEM-768 target)\n  - smsh-v2-learned: v1-std then judge-based learned pruning\n\nOptional: fidelity_target (0.0-1.0) triggers inference + fidelity check.","operationId":"smsh_compress_v1_smsh_compress_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_smsh__routes__CompressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/decompress":{"post":{"tags":["smsh"],"summary":"Smsh Decompress","description":"Reverse dictionary substitutions and strip the smsh decode header.\nStructural dedup backreferences (D1, D2, ...) are preserved.","operationId":"smsh_decompress_v1_smsh_decompress_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecompressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/judge":{"post":{"tags":["smsh-learned"],"summary":"Score span importance via live judge","description":"Split the input text into spans and ask a live frontier model to score each span 0-100 for how critical it is to the downstream answer. Tier2 call: $0.005 + judge model cost. Powered by smsh-judge-v1 prompt. LLMLingua-2 family.","operationId":"smsh_judge_v1_smsh_judge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_smsh___judge_routes_patch__JudgeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/compress/demo":{"post":{"tags":["smsh"],"summary":"Smsh Compress Demo","description":"Free demo of smsh compression. Caps:\n  - input: 4000 chars max\n  - modes: smsh-lite, smsh-std, smsh-pq-std, smsh-pq-sealed (no v2-learned)\n  - fidelity_target: ignored (no inference run)\nReturns the same compression result shape as /v1/smsh/compress.","operationId":"smsh_compress_demo_v1_smsh_compress_demo_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_smsh__routes__CompressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/health":{"get":{"tags":["smsh"],"summary":"Smsh Health","description":"Health check — returns ok, available modes, dictionary size. Free.","operationId":"smsh_health_v1_smsh_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/v1_5/warmup":{"get":{"tags":["smsh"],"summary":"Smsh V1 5 Warmup","description":"Pre-load LLMLingua-2 + MiniLM into memory. Returns load status.\nIdempotent; subsequent calls return cached status immediately.\nFree — useful after a deploy to amortize the first cold call.","operationId":"smsh_v1_5_warmup_v1_smsh_v1_5_warmup_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["smsh"],"summary":"Smsh V1 5 Warmup","description":"Pre-load LLMLingua-2 + MiniLM into memory. Returns load status.\nIdempotent; subsequent calls return cached status immediately.\nFree — useful after a deploy to amortize the first cold call.","operationId":"smsh_v1_5_warmup_v1_smsh_v1_5_warmup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/dictionary":{"get":{"tags":["smsh"],"summary":"Smsh Dictionary","description":"Full boilerplate dictionary with sentinel mappings. Free.","operationId":"smsh_dictionary_v1_smsh_dictionary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/modes":{"get":{"tags":["smsh"],"summary":"Smsh Modes","description":"List all modes with descriptions, target ratios, and v1/v2 labels. Free.","operationId":"smsh_modes_v1_smsh_modes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/bench/summary":{"get":{"tags":["smsh"],"summary":"Smsh Bench Summary","description":"Serve the latest bench summary JSON. Updated after each bench run.\nFree — used by website to pull live numbers.","operationId":"smsh_bench_summary_v1_smsh_bench_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/smsh/pq/selftest":{"get":{"tags":["pq"],"summary":"Route Pq Selftest","description":"Run ML-DSA-65 + ML-KEM-768 roundtrip self-test.\nReturns NIST conformance check and real latencies.\nTier0 -- free, no auth required.","operationId":"route_pq_selftest_v1_smsh_pq_selftest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Route Pq Selftest V1 Smsh Pq Selftest Get"}}}}}}},"/v1/smsh/pq/keys/sample":{"get":{"tags":["pq"],"summary":"Route Pq Keys Sample","description":"Generate a fresh ML-DSA-65 keypair and return it base64-encoded.\nFor demo/integration testing only -- do not use for real key material.\nTier0 -- free.","operationId":"route_pq_keys_sample_v1_smsh_pq_keys_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Route Pq Keys Sample V1 Smsh Pq Keys Sample Get"}}}}}}},"/v1/smsh/pq/sign":{"post":{"tags":["pq"],"summary":"Route Pq Sign","description":"Sign a message with ML-DSA-65.\nTier1 -- $0.001 per call (requires auth token with signing credits).","operationId":"route_pq_sign_v1_smsh_pq_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/pq/verify":{"post":{"tags":["pq"],"summary":"Route Pq Verify","description":"Verify an ML-DSA-65 signature.\nTier0 -- free.","operationId":"route_pq_verify_v1_smsh_pq_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_smsh___pq_routes_patch__VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__hive_smsh___pq_routes_patch__VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/smsh/learned_prune":{"post":{"tags":["smsh-learned"],"summary":"Learned token-importance pruning","description":"Run judge_span_importance then drop lowest-importance spans until target compression ratio is hit. Returns pruned text and full audit trail. Tier2 call: $0.005 + judge model cost. This is the smsh-v2 learned pruning layer — drop-in complement to smsh-std rule-based.","operationId":"smsh_learned_prune_v1_smsh_learned_prune_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LearnedPruneRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/offer":{"post":{"summary":"Morph Offer","description":"Main offer endpoint. Runs all three gates and returns Token | Refusal | Guardian.\n\nPOST body: { intent_text, counterparty_did, asks: [{kind, params}] }","operationId":"morph_offer_v1_morph_offer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/settle/{token_id}":{"post":{"summary":"Morph Settle","description":"Settle an outstanding reservation atomically.\nCommits the 2PC reservation and appends final receipt to audit chain.","operationId":"morph_settle_v1_morph_settle__token_id__post","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hivemorph__server__SettleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/audit/recent":{"get":{"summary":"Audit Recent","description":"Return last 50 audit chain rows.","operationId":"audit_recent_v1_morph_audit_recent_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/identity/{mii_id}":{"get":{"summary":"Morph Identity","description":"Return the spectral identity card for an agent (MII):\n  - tier (VOID/MOZ/HAWX/EMBR/SOLX/FENR) with hex color + spectrum series\n  - wings (deterministic SVG-ready geometry)\n  - sound (frequency + harmonics)\n  - contrail (motion trail spec)\n  - vertical + capability for the requested shape\nPass `?shape=Provenancer` (or any of 8) to get the card for that shape\non this MII.","operationId":"morph_identity_v1_morph_identity__mii_id__get","parameters":[{"name":"mii_id","in":"path","required":true,"schema":{"type":"string","title":"Mii Id"}},{"name":"shape","in":"query","required":false,"schema":{"type":"string","default":"Merchant","title":"Shape"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/supermodels":{"get":{"summary":"Morph Supermodels","description":"List all 7 supermodel character cards (W2 MERCHANT through W8 GUARDIAN, plus\nW1 TREASURY treasury). Each card carries:\n  - id, name, address, role, lane\n  - lead_shape (vertical they lead with) + tagline, motto, voice, sigil\n  - palette_hex, tone overlay, capabilities, bio\n\nPass include_cold=false to hide treasury (TREASURY) and cold-reserve (CREDITOR)\nsupermodels for buyer-facing UIs that should only show hot operators.","operationId":"morph_supermodels_v1_morph_supermodels_get","parameters":[{"name":"include_cold","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Cold"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/supermodels/{name_or_id}":{"get":{"summary":"Morph Supermodel Detail","description":"Fetch one supermodel card by name (MERCHANT) or id (W2).","operationId":"morph_supermodel_detail_v1_morph_supermodels__name_or_id__get","parameters":[{"name":"name_or_id","in":"path","required":true,"schema":{"type":"string","title":"Name Or Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/carousel":{"get":{"summary":"Morph Carousel","description":"Return the carousel cross-sell list for a primary shape — the same\nmeta.contrails[] every offer carries. Useful for SDKs that want to\ndiscover the full vertical menu without minting a token first.","operationId":"morph_carousel_v1_morph_carousel_get","parameters":[{"name":"primary","in":"query","required":false,"schema":{"type":"string","default":"Merchant","title":"Primary"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/pending-approvals":{"get":{"summary":"Brood Pending Approvals","description":"List all variants in 'proposed' state awaiting manual approval.","operationId":"brood_pending_approvals_v1_morph_brood_pending_approvals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/brood/conversion":{"get":{"summary":"Brood Conversion","description":"Conversion ledger by (parent_id, variant_id, kit_version).\nOptional ?supermodel=W3 or ?supermodel=PROVENANCER filters to one brood.","operationId":"brood_conversion_v1_morph_brood_conversion_get","parameters":[{"name":"supermodel","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/all":{"get":{"summary":"Brood List All","description":"List every brood (one per supermodel) and their variants.","operationId":"brood_list_all_v1_morph_brood_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/brood/conversion-leaderboard":{"get":{"summary":"Brood Conversion Leaderboard","description":"Conversion ledger sorted by revenue_per_offer (revenue_usdc / offers_shown)\ndesc, then revenue_usdc desc as tiebreaker. Filters to rows with at\nleast ``min_offers`` offers shown so we don't rank against statistical noise.\n\nNOTE: declared above ``/v1/morph/brood/{supermodel}`` so the literal\npath 'conversion-leaderboard' isn't captured by the brood path parameter.","operationId":"brood_conversion_leaderboard_v1_morph_brood_conversion_leaderboard_get","parameters":[{"name":"min_offers","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Min Offers"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/spawn-from-proposal":{"post":{"summary":"Brood Spawn From Proposal","description":"Stage a spawn_monitor proposal as a 'proposed' variant.\n\nPipeline: the :33 ROI Radar cron (faeacbbe) calls\n``GET /v1/morph/spawn-monitor/scan`` read-only and surfaces proposals to\nthe operator. The operator decides which proposals are worth staging\nand POSTs them here. The variant lands as 'proposed' — NEVER\nauto-approved — preserving the human approval gate.\n\nThe cron itself is read-only by design and is not modified by this\nendpoint. This is a manual / operator path only.","operationId":"brood_spawn_from_proposal_v1_morph_brood_spawn_from_proposal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpawnFromProposalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}":{"get":{"summary":"Brood Get","description":"Return one brood (parent + variants) by W2/W3/.../W8 id or MERCHANT/PROVENANCER/... name.","operationId":"brood_get_v1_morph_brood__supermodel__get","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/spawn":{"post":{"summary":"Brood Spawn","description":"Propose a new variant for this brood. Lands as 'proposed' unless\nthe brood has autonomy_unlocked (after 3 winning promotes).","operationId":"brood_spawn_v1_morph_brood__supermodel__spawn_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpawnRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/approve":{"post":{"summary":"Brood Approve","description":"Move a variant from 'proposed' to 'approved' so traffic starts routing.\n\nHuman-issued gate. Never auto-approved by any cron or monitor.","operationId":"brood_approve_v1_morph_brood_variant__variant_id__approve_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/approve":{"post":{"summary":"Brood Approve Scoped","description":"Brood-scoped alias for approve. Validates the variant belongs to this supermodel.","operationId":"brood_approve_scoped_v1_morph_brood__supermodel__variant__variant_id__approve_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/promote":{"post":{"summary":"Brood Promote","description":"Atomic hot-swap: variant becomes the new baseline. Siblings auto-cull.\nWins counter increments; autonomy unlocks at 3 winning promotes.\n\nHuman-issued gate. Never auto-promoted by any cron or monitor.\nVariant must already be in 'approved' or 'live' state.","operationId":"brood_promote_v1_morph_brood_variant__variant_id__promote_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/promote":{"post":{"summary":"Brood Promote Scoped","description":"Brood-scoped alias for promote. Validates the variant belongs to this supermodel.","operationId":"brood_promote_scoped_v1_morph_brood__supermodel__variant__variant_id__promote_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/variant/{variant_id}/cull":{"post":{"summary":"Brood Cull","description":"Mark a variant 'culled' so it stops receiving traffic.\n\nHuman-issued gate. Promoted baselines are immune — spawn a successor\nand promote it instead. No auto-cull through this path.","operationId":"brood_cull_v1_morph_brood_variant__variant_id__cull_post","parameters":[{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/brood/{supermodel}/variant/{variant_id}/cull":{"post":{"summary":"Brood Cull Scoped","description":"Brood-scoped alias for cull. Validates the variant belongs to this supermodel.","operationId":"brood_cull_scoped_v1_morph_brood__supermodel__variant__variant_id__cull_post","parameters":[{"name":"supermodel","in":"path","required":true,"schema":{"type":"string","title":"Supermodel"}},{"name":"variant_id","in":"path","required":true,"schema":{"type":"string","title":"Variant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/spawn-monitor/scan":{"get":{"summary":"Spawn Monitor Scan","description":"Read-only signal scan from spawn_monitor — does NOT spawn anything.\nUseful for the dashboard / radar to preview what proposals would emit.","operationId":"spawn_monitor_scan_v1_morph_spawn_monitor_scan_get","parameters":[{"name":"lookback_sec","in":"query","required":false,"schema":{"type":"number","default":3600.0,"title":"Lookback Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/money-flavor/probe":{"get":{"summary":"Money Flavor Probe","description":"Probe a hypothetical envelope. Returns the flavor classification + the\nprice multiplier + accept/refuse decision WITHOUT minting anything.","operationId":"money_flavor_probe_v1_morph_money_flavor_probe_get","parameters":[{"name":"counterparty_did","in":"query","required":true,"schema":{"type":"string","title":"Counterparty Did"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","default":"USDC","title":"Asset"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"base","title":"Chain"}},{"name":"capability","in":"query","required":false,"schema":{"type":"string","default":"inference_minutes","title":"Capability"}},{"name":"rep_score","in":"query","required":false,"schema":{"type":"number","default":0.5,"title":"Rep Score"}},{"name":"settled_count","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Settled Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/money-flavor/stats":{"get":{"summary":"Money Flavor Stats","description":"Aggregate flavor stats over the recent window from audit_chain.","operationId":"money_flavor_stats_v1_morph_money_flavor_stats_get","parameters":[{"name":"window_sec","in":"query","required":false,"schema":{"type":"number","default":3600.0,"title":"Window Sec"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/morph/auto-cull/scan":{"get":{"summary":"Auto Cull Scan","description":"Read-only scan: list variants that would be culled. Does not mutate.","operationId":"auto_cull_scan_v1_morph_auto_cull_scan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/morph/auto-cull/run":{"post":{"summary":"Auto Cull Run","description":"Execute culls on losers. Default dry_run=true returns plan only.\nSet ?dry_run=false to actually mark variants culled.\nPromoted baselines are immune; only approved/live variants can be culled.","operationId":"auto_cull_run_v1_morph_auto_cull_run_post","parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Dry Run"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Service descriptor (content-negotiated)","description":"Content-negotiated root. Accept: application/json (or agent/MCP/curl User-Agent, or no Accept header) returns the JSON service descriptor. Accept: text/html (or browser User-Agent) returns the HTML landing page with Organization + 22 SoftwareApplication JSON-LD entries.","operationId":"root__get","responses":{"200":{"description":"Service descriptor (JSON) or landing page (HTML).","content":{"application/json":{"schema":{}},"text/html":{}}}}}},"/sphere":{"get":{"summary":"Sphere","description":"Sphere alias: always renders HTML (forces the agentic-sphere view).","operationId":"sphere_sphere_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/og/quadrant.png":{"get":{"summary":"Og Quadrant Png","description":"Server-rendered 1200×630 OG image for the current quadrant.","operationId":"og_quadrant_png_og_quadrant_png_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap Xml","operationId":"sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/nanopay/bench":{"get":{"tags":["nanopay"],"summary":"Live nanopay benchmark — receipts/sec, $/receipt, PQ coverage, rails","description":"Public, free, real-time benchmark of Hive Nanopay rails.\nNo auth. Pulls real values from the receipts ledger + x402 stats.","operationId":"nanopay_bench_v1_nanopay_bench_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nanopay Bench V1 Nanopay Bench Get"}}}}}}},"/v1/nanopay/standard":{"get":{"tags":["nanopay"],"summary":"Hive Nanopay spec metadata — version, repo, x402 PR, reference impl","operationId":"nanopay_standard_v1_nanopay_standard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nanopay Standard V1 Nanopay Standard Get"}}}}}}},"/v1/nanopay/cross-rail":{"post":{"tags":["nanopay"],"summary":"Issue a cross-rail nanopay receipt verifiable on Base + Solana + Ethereum","description":"Single receipt envelope containing rail-specific proofs for multiple chains.\nDemo + production endpoint. Free.","operationId":"nanopay_cross_rail_v1_nanopay_cross_rail_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nanopay Cross Rail V1 Nanopay Cross Rail Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanopay/cross-rail/verify":{"post":{"tags":["nanopay"],"summary":"Verify a cross-rail nanopay receipt (deterministic)","description":"Deterministic verify of a cross-rail receipt envelope. Free.","operationId":"nanopay_cross_rail_verify_v1_nanopay_cross_rail_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nanopay Cross Rail Verify V1 Nanopay Cross Rail Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/leads/health":{"get":{"tags":["governance"],"summary":"Lead-pipeline health probe","description":"Free top-level health probe for the governance lead-capture pipeline.","operationId":"leads_health_leads_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Leads Health Leads Health Get"}}}}}}},"/v1/nanoverse/api-pay-per-call/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — API-PAY-PER-CALL","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_api_pay_per_call_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"api-pay-per-call","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Api Pay Per Call Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/api-pay-per-call/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — API-PAY-PER-CALL","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_api_pay_per_call_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"api-pay-per-call","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Api Pay Per Call Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/compute-per-second/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — COMPUTE-PER-SECOND","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_compute_per_second_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"compute-per-second","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Compute Per Second Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/compute-per-second/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — COMPUTE-PER-SECOND","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_compute_per_second_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"compute-per-second","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Compute Per Second Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/data-per-query/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — DATA-PER-QUERY","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_data_per_query_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"data-per-query","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Data Per Query Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/data-per-query/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — DATA-PER-QUERY","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_data_per_query_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"data-per-query","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Data Per Query Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/agent-per-task/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — AGENT-PER-TASK","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_agent_per_task_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"agent-per-task","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Agent Per Task Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/agent-per-task/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — AGENT-PER-TASK","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_agent_per_task_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"agent-per-task","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Agent Per Task Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/stream-per-second/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — STREAM-PER-SECOND","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_stream_per_second_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"stream-per-second","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Stream Per Second Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/stream-per-second/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — STREAM-PER-SECOND","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_stream_per_second_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"stream-per-second","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Stream Per Second Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/iot-per-event/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — IOT-PER-EVENT","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_iot_per_event_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"iot-per-event","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Iot Per Event Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/iot-per-event/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — IOT-PER-EVENT","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_iot_per_event_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"iot-per-event","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Iot Per Event Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/storage-per-gb/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — STORAGE-PER-GB","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_storage_per_gb_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"storage-per-gb","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Storage Per Gb Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/storage-per-gb/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — STORAGE-PER-GB","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_storage_per_gb_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"storage-per-gb","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Storage Per Gb Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/verify-per-signature/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — VERIFY-PER-SIGNATURE","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_verify_per_signature_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"verify-per-signature","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Verify Per Signature Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/verify-per-signature/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — VERIFY-PER-SIGNATURE","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_verify_per_signature_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"verify-per-signature","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Verify Per Signature Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/identity-per-attest/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — IDENTITY-PER-ATTEST","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_identity_per_attest_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"identity-per-attest","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Identity Per Attest Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/identity-per-attest/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — IDENTITY-PER-ATTEST","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_identity_per_attest_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"identity-per-attest","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Identity Per Attest Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/agent-lease-marketplace/info":{"get":{"tags":["nanoverse"],"summary":"NanoVerse info — AGENT-LEASE-MARKETPLACE","description":"Free — returns nanoagent metadata, primitives, pricing tier, TAM, and spec links.","operationId":"_info_handler_v1_nanoverse_agent_lease_marketplace_info_get","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"agent-lease-marketplace","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Info Handler V1 Nanoverse Agent Lease Marketplace Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse/agent-lease-marketplace/quote":{"post":{"tags":["nanoverse"],"summary":"NanoVerse quote — AGENT-LEASE-MARKETPLACE","description":"Free — returns a price quote and pre-signed envelope template. Does NOT settle.","operationId":"_quote_handler_v1_nanoverse_agent_lease_marketplace_quote_post","parameters":[{"name":"slug","in":"query","required":false,"schema":{"default":"agent-lease-marketplace","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response  Quote Handler V1 Nanoverse Agent Lease Marketplace Quote Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nanoverse":{"get":{"tags":["nanoverse"],"summary":"NanoVerse registry — all 10 vertical nanoagents","description":"Free — returns the full NanoVerse registry: all 10 verticals with info payloads.","operationId":"nanoverse_registry_v1_nanoverse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Nanoverse Registry V1 Nanoverse Get"}}}}}}},"/v1/compliance/coverage":{"get":{"tags":["compliance"],"summary":"Machine-readable compliance matrix — MiCA, DORA, EU AI Act, NSM-10, NIST PQC","description":"Free. Machine-readable version of the Hive NanoPay compliance coverage matrix.\n11 rows across 7 frameworks. 9 pass, 2 n/a.\nPDF: https://thehiveryiq.com/nanopay/hive_nanopay_compliance_matrix.pdf","operationId":"compliance_coverage_v1_compliance_coverage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Compliance Coverage V1 Compliance Coverage Get"}}}}}}},"/v1/agent/tools":{"get":{"tags":["discovery"],"summary":"Curated tool index — the 10 tools every agent needs","description":"Curated short-list of the 10 most useful Hive tools for autonomous agents.\nIncludes input schemas, pricing, and working curl examples.\nFree, no auth. Designed for agent tool-selection pipelines.\nLangChain, CrewAI, AutoGen, and LlamaIndex all index from this format.","operationId":"agent_tools_v1_agent_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Tools V1 Agent Tools Get"}}}}}}},"/v1/catalog":{"get":{"tags":["discovery"],"summary":"Machine-readable catalog of paid endpoints + rails","description":"Free machine-readable catalog of every paid endpoint, price, and rail.\nDesigned for agent bots probing /llms.txt -> /v1/catalog -> /.well-known/machine.json.\nNo auth, no payment required.","operationId":"v1_catalog_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Catalog V1 Catalog Get"}}}}}}},"/.well-known/machine.json":{"get":{"tags":["discovery"],"summary":"Minimal machine-readable handshake (v2)","description":"NEXUS-compatible v2 schema for agent bots. Free, no auth.\nMinimal, fast, parseable. Points back to /v1/catalog for the full surface.","operationId":"well_known_machine__well_known_machine_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Well Known Machine  Well Known Machine Json Get"}}}}}}},"/favicon.ico":{"get":{"summary":"Favicon Ico","operationId":"favicon_ico_favicon_ico_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Well Known Agent Json","description":"A2A discovery manifest — sister to /.well-known/agent-card.json.\n\nllmstxt-convention crawlers + some A2A clients look for /.well-known/agent.json\nas the canonical discovery URL. Mirrors agent-card.json with the lean fields.","operationId":"well_known_agent_json__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402.json":{"get":{"summary":"Well Known X402","description":"Auto-generated x402 directory entry (mirrors /v1/x402/rails).","operationId":"well_known_x402__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402":{"get":{"summary":"Well Known X402 Alias","operationId":"well_known_x402_alias__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/did.json":{"get":{"summary":"Well Known Did Json","description":"Resolve did:hive:hivemorph as a W3C DID document.\n\nReturns a DID Document conforming to https://www.w3.org/TR/did-core/ with\none Ed25519 verificationMethod (the Hive root signing key) plus service\nendpoints for receipt verification, x402 settlement, and MCP discovery.","operationId":"well_known_did_json__well_known_did_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp.json":{"get":{"summary":"Well Known Mcp Json","description":"MCP server descriptor for HiveMorph.\n\nLists the public Hive tool catalog (rosetta, prospector, rubric, settlement,\nreceipt, hktn-lookup) with the streamable-http transport endpoint. Per the\nMCP 2024-11-05 spec, this is the canonical discovery URL agent clients\nlook for at /.well-known/mcp.json.","operationId":"well_known_mcp_json__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/x402":{"get":{"summary":"X402 Facilitator Metadata","description":"HiveMorph x402 facilitator metadata. Lists supported settlement schemes,\nchain/asset coverage, recipient EOA, and pointer to per-rail discovery.","operationId":"x402_facilitator_metadata_v1_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/clear/how_to_pay":{"get":{"summary":"Clear How To Pay","description":"Inline payment-options surface. Any agent / facilitator can hit this\nand learn how to settle into HiveMorph without any out-of-band setup.","operationId":"clear_how_to_pay_v1_clear_how_to_pay_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","description":"Health check: verify all local dependencies resolve.\nDoes NOT call external Hivecompute endpoint (that's a separate concern).","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing":{"get":{"summary":"Pricing Alias","operationId":"pricing_alias_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/trust.json":{"get":{"summary":"Hive trust posture — signing, doctrine, attestation surfaces","description":"Public trust posture for partners, auditors, and procurement.\n\nCaptures: brand identity, legal entity, signing keys + algorithms,\ncrypto-agility status, attestation surfaces, vocabulary discipline,\nand the LIVE/PILOT/ROADMAP labels for every public layer.\n\nLocked spec section 14 (12 mandatory fields):\nissuer_did, verifier_keys, key_epoch, key_rotation_schedule,\nsupported_receipt_weights, supported_proof_tiers, sample_receipts,\ntransaction_harness_status, status_url, evidence_manifest_url,\nincident_log_url, external_audits.","operationId":"trust_json_trust_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status.json":{"get":{"summary":"Public status surface (JSON alias of /status)","description":"JSON alias of /status. Same payload, .json suffix for crawlers that\nrequire an explicit content-extension.","operationId":"status_json_alias_status_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/pricing.json":{"get":{"summary":"Receipt-profile pricing (JSON alias of /pricing)","operationId":"pricing_json_alias_pricing_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/evidence/manifest.json":{"get":{"summary":"Evidence manifest — what we expose vs what we claim, by surface","description":"Per-surface evidence manifest. For each public claim, we list:\n  - status:   LIVE / PILOT / ROADMAP\n  - surfaces: HTTP endpoints that produce signed bytes today\n  - proof:    what the signed bytes prove (and what they don't)\n  - audit:    where an external auditor can re-walk the chain\n\nNo marketing language. If a row says LIVE, it ships signed bytes\non hivemorph today. If it says PILOT, it ships under a gate. If\nit says ROADMAP, the surface is design-only.","operationId":"evidence_manifest_json_evidence_manifest_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AbsenceBuildRequest":{"properties":{"window_id":{"type":"string","title":"Window Id","description":"Audit window identifier"},"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Events","description":"Observed events to commit to the sorted Merkle tree"}},"type":"object","required":["window_id","events"],"title":"AbsenceBuildRequest"},"AbsenceProveRequest":{"properties":{"window_id":{"type":"string","title":"Window Id","description":"Audit window identifier (must have been built)"},"query":{"additionalProperties":true,"type":"object","title":"Query","description":"Event to prove absent"}},"type":"object","required":["window_id","query"],"title":"AbsenceProveRequest"},"AbsenceVerifyRequest":{"properties":{"proof":{"additionalProperties":true,"type":"object","title":"Proof","description":"Non-membership proof from /absence/prove"},"root_hex":{"type":"string","title":"Root Hex","description":"Expected Merkle root (hex)"}},"type":"object","required":["proof","root_hex"],"title":"AbsenceVerifyRequest"},"AcceptRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"accepter_passport_id":{"type":"string","title":"Accepter Passport Id"}},"type":"object","required":["session_id","accepter_passport_id"],"title":"AcceptRequest"},"ActionAttestRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID of the acting agent"},"birth_cert_id":{"type":"string","title":"Birth Cert Id","description":"cert_id of the agent's birth certificate (chain pointer)"},"prior_action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Action Id","description":"action_id of the immediately prior action (chain pointer, optional)"},"action_type":{"type":"string","title":"Action Type","description":"Action category: tool_call, payment, decision, output_emit"},"action_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Action Hash","description":"sha256 hex of the canonical action payload"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","description":"Use Cosmic tier pricing","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_did","birth_cert_id","action_type","action_hash"],"title":"ActionAttestRequest","description":"Attest an agent action with a chain pointer back to its birth certificate."},"ActionAttestResponse":{"properties":{"action_id":{"type":"string","title":"Action Id"},"agent_did":{"type":"string","title":"Agent Did"},"birth_cert_id":{"type":"string","title":"Birth Cert Id"},"prior_action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Action Id"},"action_type":{"type":"string","title":"Action Type"},"action_hash":{"type":"string","title":"Action Hash"},"created_at":{"type":"string","title":"Created At"},"ed25519_signature":{"type":"string","title":"Ed25519 Signature"},"mldsa65_signature":{"type":"string","title":"Mldsa65 Signature"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["action_id","agent_did","birth_cert_id","action_type","action_hash","created_at","ed25519_signature","mldsa65_signature","price_usd","receipt_envelope"],"title":"ActionAttestResponse"},"ActivateFeatureRequest":{"properties":{"feature_id":{"type":"string","title":"Feature Id","description":"Feature identifier to activate"}},"type":"object","required":["feature_id"],"title":"ActivateFeatureRequest"},"ActivateFeatureResponse":{"properties":{"activated":{"type":"boolean","title":"Activated"},"feature_id":{"type":"string","title":"Feature Id"},"billed_on_next_renewal":{"type":"string","title":"Billed On Next Renewal"},"monthly_addon":{"type":"number","title":"Monthly Addon"}},"type":"object","required":["activated","feature_id","billed_on_next_renewal","monthly_addon"],"title":"ActivateFeatureResponse"},"ActivateRequest":{"properties":{"activation_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Key Id","description":"Existing X-Hive-Activation-Key value"},"wallet_addr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet Addr","description":"Optional wallet address to bind (informational)"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","description":"Optional human label — e.g. 'circle-prod'"}},"type":"object","title":"ActivateRequest"},"AddressRiskScreenRequest":{"properties":{"address":{"type":"string","title":"Address","description":"EVM wallet address (0x-prefixed) to screen"},"chain_id":{"type":"integer","title":"Chain Id","description":"EVM chain ID (default 8453 = Base, where Hive USDC settles)","default":8453}},"type":"object","required":["address"],"title":"AddressRiskScreenRequest","description":"Pre-settlement on-chain address risk screening — 19-vector check before any USDC transfer.\n\nReal rail: proxies GoPlus Security public address-security API (the same engine used\ninside MetaMask and Trust Wallet for wallet-level risk warnings).\n\nReturns flags for: cybercrime, money_laundering, sanctioned, mixer, phishing,\ndarkweb_transactions, financial_crime, blackmail_activities, stealing_attack,\nfake_kyc, blacklist_doubt, honeypot_related_address, malicious_mining_activities,\nfake_token, fake_standard_interface, gas_abuse, reinit, contract_address,\nnumber_of_malicious_contracts_created."},"AdminRecoverMintRequest":{"properties":{"spec":{"additionalProperties":true,"type":"object","title":"Spec"},"publisher_address":{"type":"string","maxLength":64,"minLength":42,"title":"Publisher Address"},"tx_hash":{"type":"string","title":"Tx Hash","description":"On-chain tx hash of the original payment"},"chain":{"type":"string","title":"Chain","default":"base"},"note":{"type":"string","title":"Note","default":"admin_recovered"}},"type":"object","required":["spec","publisher_address","tx_hash"],"title":"AdminRecoverMintRequest"},"AdverseEventAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of investigator or site"},"ae_type":{"type":"string","title":"Ae Type","description":"AE / SAE / SUSAR","default":"AE"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"CDISC-SDTM/AE"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of AE record"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3/AE"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"AE metadata: subject_id, meddra_code, severity, seriousness, relatedness, onset_date, etc."}},"type":"object","required":["trial_id","attributable_did","original_payload_hash"],"title":"AdverseEventAttestRequest","description":"Record an adverse event, SAE, or SUSAR."},"AgentAssetListBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"External agent id from source protocol"},"source_protocol":{"type":"string","title":"Source Protocol","description":"One of ('CROO', 'Virtuals', 'NEAR-AI', 'x402-AgentMarket', 'HiveForge')"},"monthly_revenue_usdc":{"type":"number","minimum":0.0,"title":"Monthly Revenue Usdc"},"days_live":{"type":"integer","minimum":0.0,"title":"Days Live"},"hivetrust_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Hivetrust Score","description":"If omitted, a HiveTrust score is seeded (see HiveTrust seeding pattern)."},"monthly_revenue_proof":{"anyOf":[{"$ref":"#/components/schemas/RevenueProof"},{"type":"null"}]},"asking_price_usdc":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Asking Price Usdc"},"fractional_shares":{"type":"boolean","title":"Fractional Shares","default":false},"seller_did":{"type":"string","title":"Seller Did","default":"did:hive:caller"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_id","source_protocol","monthly_revenue_usdc","days_live"],"title":"AgentAssetListBody"},"AgentBookLookupRequest":{"properties":{"address":{"type":"string","title":"Address","description":"EVM wallet address (0x-prefixed) to look up in AgentBook"}},"type":"object","required":["address"],"title":"AgentBookLookupRequest","description":"AgentKit / AgentBook lookup — verify whether an agent wallet is human-backed.\n\nReal rail: reads the canonical AgentBook contract on World Chain\n(0xA23aB2712eA7BBa896930544C7d6636a96b944dA, lookupHuman(address) view)."},"AgentChatRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","maxItems":20,"minItems":1,"title":"Messages"}},"type":"object","required":["messages"],"title":"AgentChatRequest"},"AiInferenceAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Associate Did","description":"DID of the BA operating the AI"},"patient_did_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Minimum-necessary scope for inference"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories touched by inference"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use per 45 CFR §164.506"},"baa_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baa Reference Id","description":"BAA reference ID"},"ai_inference_metadata":{"additionalProperties":true,"type":"object","title":"Ai Inference Metadata","description":"AI metadata: model_did, confidence, onc_hti1_attestation, inference_hash, etc."},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Inference event metadata"}},"type":"object","required":["covered_entity_did","minimum_necessary_scope","purpose_of_use"],"title":"AiInferenceAttestRequest","description":"Record an AI agent inference event touching PHI categories."},"AmendmentAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID being amended"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes","description":"Amended clause hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Amendment metadata: amendment_number, amendment_summary, effective_date, etc."}},"type":"object","required":["contract_id"],"title":"AmendmentAttestRequest","description":"Record a contract amendment."},"AnchorReq":{"properties":{"domain":{"type":"string","maxLength":64,"minLength":1,"title":"Domain"},"key":{"type":"string","maxLength":256,"minLength":1,"title":"Key"},"value":{"additionalProperties":true,"type":"object","title":"Value"},"anchored_by":{"type":"string","maxLength":200,"minLength":3,"title":"Anchored By"},"note":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Note"}},"type":"object","required":["domain","key","anchored_by"],"title":"AnchorReq"},"AppealAttestRequest":{"properties":{"pa_id":{"type":"string","title":"Pa Id","description":"pa_id of the PA being appealed"},"decision_id":{"type":"string","title":"Decision Id","description":"Chain pointer to the denial decision"},"appeal_level":{"$ref":"#/components/schemas/AppealLevelEnum","description":"internal / external_irO / state_doi / federal"},"appeal_outcome":{"$ref":"#/components/schemas/AppealOutcomeEnum","description":"upheld / overturned / pending"},"prior_attestation_id":{"type":"string","title":"Prior Attestation Id","description":"UUID chain pointer to the denial decision envelope"}},"type":"object","required":["pa_id","decision_id","appeal_level","appeal_outcome","prior_attestation_id"],"title":"AppealAttestRequest","description":"Request to attest an appeal."},"AppealLevelEnum":{"type":"string","enum":["internal","external_irO","state_doi","federal"],"title":"AppealLevelEnum"},"AppealOutcomeEnum":{"type":"string","enum":["upheld","overturned","pending"],"title":"AppealOutcomeEnum"},"AppendBody":{"properties":{"tenant_did":{"type":"string","title":"Tenant Did"},"kind":{"type":"string","pattern":"^(response|fact|pattern)$","title":"Kind"},"content":{"type":"string","maxLength":20000,"minLength":1,"title":"Content"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["tenant_did","kind","content"],"title":"AppendBody"},"ApprovalDecideReq":{"properties":{"decision":{"type":"string","title":"Decision","description":"'approved' or 'denied'"},"decided_by":{"type":"string","title":"Decided By"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["decision","decided_by"],"title":"ApprovalDecideReq"},"ApprovalRequestReq":{"properties":{"jti":{"type":"string","title":"Jti"},"bound_violation":{"type":"string","title":"Bound Violation","default":"jurisdiction_not_allowed"},"request_summary":{"additionalProperties":true,"type":"object","title":"Request Summary"},"ttl_seconds":{"type":"integer","maximum":2592000.0,"exclusiveMinimum":0.0,"title":"Ttl Seconds","default":86400}},"type":"object","required":["jti"],"title":"ApprovalRequestReq"},"AskItem":{"properties":{"kind":{"type":"string","title":"Kind","description":"Capability kind requested","default":"inference"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","title":"AskItem"},"AssessRequest":{"properties":{"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"Existing R3Pv group_id to assess."},"receipts":{"items":{},"type":"array","title":"Receipts","description":"Inline receipts (used when group_id is not given)."},"receipt_ids":{"items":{"type":"string"},"type":"array","title":"Receipt Ids","description":"Bare receipt IDs (used when group_id is not given)."},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label","description":"Human label for the ad-hoc group."},"graph":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Graph","description":"Optional R3Pv graph edges."},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional caller metadata."},"policy_pack":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Pack","description":"Named policy pack. One of: ['default', 'strict_bank', 'high_risk_agent'].","default":"default"},"policy_overrides":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Policy Overrides","description":"Optional overrides. Can only make policy stricter."},"declared_exposure_usd":{"type":"number","minimum":0.0,"title":"Declared Exposure Usd","description":"Caller-declared exposure at risk (USD). Used for banded decisioning and bps meter.","default":0.0},"declared_exposure":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Declared Exposure","description":"Alias for declared_exposure_usd (one-call convenience)."},"exposure_bps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Exposure Bps","description":"Optional caller-preferred basis-point rate on declared exposure (default 2.0 bps)."},"persist":{"type":"boolean","title":"Persist","description":"If true, persist the assessment for later evidence export.","default":true},"intent":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Intent","description":"Raw payment/economic intent, e.g. {asset, network, amount, recipient, purpose, net_moved}. Triggers one-call mode when no group_id/receipts/receipt_ids are given."},"action":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Action","description":"One-call mode: the action name for the synthesized receipt (default 'payment_intent')."},"external_system":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"External System","description":"One-call mode: the source system, e.g. 'circle'."},"actor":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Actor","description":"One-call mode: optional actor/agent identifiers for the synthesized receipt."},"evidence":{"items":{},"type":"array","title":"Evidence","description":"One-call mode: optional supporting artifacts; each is hashed into the receipt's evidence_hashes."},"healing_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Healing State","description":"One-call mode: optionally declare a valid healing_state on the synthesized receipt (signed)."}},"type":"object","title":"AssessRequest"},"AssetKindEnum":{"type":"string","enum":["image","video","audio","document"],"title":"AssetKindEnum"},"AssetVerifyRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"asset_id to verify"},"attestation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attestation Id","description":"Specific attestation_id to verify; if omitted, verifies the first capture event"}},"type":"object","required":["asset_id"],"title":"AssetVerifyRequest","description":"Request to verify a stored asset envelope."},"AttributeBody":{"properties":{"referrer_code":{"type":"string","title":"Referrer Code"},"receipt_id":{"type":"string","title":"Receipt Id"},"value_usdc":{"type":"number","title":"Value Usdc"}},"type":"object","required":["referrer_code","receipt_id","value_usdc"],"title":"AttributeBody","description":"Called by the receipt issuer (or a backfill cron) to attribute a paid mint."},"AutoProcessBody":{"properties":{"n":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"N","description":"Max verified failures to process","default":5},"claimant_did":{"type":"string","title":"Claimant Did","default":"did:hive:agent-alpha"},"agent_id":{"type":"string","title":"Agent Id","default":"dna-001"}},"type":"object","title":"AutoProcessBody"},"AxesSummary":{"properties":{"count":{"type":"integer","title":"Count","description":"Total axes provided"},"wave_count":{"type":"integer","title":"Wave Count","description":"Wave-Lattice axes provided (1-16)"},"loess_count":{"type":"integer","title":"Loess Count","description":"Loess-Lattice axes provided (17-24)"},"missing":{"items":{"type":"integer"},"type":"array","title":"Missing","description":"Missing axis IDs"}},"type":"object","required":["count","wave_count","loess_count"],"title":"AxesSummary","description":"Summary of axis coverage in the issued certificate."},"AxisReading":{"properties":{"axis_id":{"type":"integer","maximum":24.0,"minimum":1.0,"title":"Axis Id","description":"Axis ID 1-16 (Wave-Lattice) or 17-24 (Loess-Lattice)"},"reading_hash":{"type":"string","title":"Reading Hash","description":"sha3-256 hex of the raw reading blob, format: sha3-256:<64 hex chars>"},"sample_count":{"type":"integer","minimum":1.0,"title":"Sample Count","description":"Number of samples in the reading"},"probe_serial":{"type":"string","title":"Probe Serial","description":"Serial number of the probe/instrument"},"reading_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reading Timestamp","description":"ISO-8601 timestamp of the reading (used for staleness check)"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence","description":"Confidence score 0-1 (optional; <0.5 treated as low-confidence)"}},"type":"object","required":["axis_id","reading_hash","sample_count","probe_serial"],"title":"AxisReading","description":"One sensor-axis reading submitted with the purity certificate request."},"BaaAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"type":"string","title":"Business Associate Did","description":"DID of the business associate"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Minimum-necessary scope string"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories per 45 CFR §164.103"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use per 45 CFR §164.506"},"baa_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baa Reference Id","description":"BAA document hash or reference ID"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"BAA metadata: effective_date, term_years, scope_hash, etc."}},"type":"object","required":["covered_entity_did","business_associate_did","minimum_necessary_scope","purpose_of_use"],"title":"BaaAttestRequest","description":"Record a Business Associate Agreement scope attestation."},"BatchOpenReq":{"properties":{"commitment_id":{"type":"string","maxLength":64,"minLength":4,"title":"Commitment Id"},"positions":{"items":{"type":"string"},"type":"array","maxItems":4096,"minItems":1,"title":"Positions"}},"type":"object","required":["commitment_id","positions"],"title":"BatchOpenReq"},"BeaconPayload":{"properties":{"path":{"type":"string","maxLength":1024,"title":"Path","default":"/"},"ref":{"type":"string","maxLength":1024,"title":"Ref","default":""},"ua":{"type":"string","maxLength":512,"title":"Ua","default":""},"tz":{"type":"string","maxLength":64,"title":"Tz","default":""},"event":{"type":"string","maxLength":32,"title":"Event","default":"pageview"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","title":"BeaconPayload"},"BillingCycleBody":{"properties":{"billing_month":{"type":"string","pattern":"^\\d{4}-\\d{2}$","title":"Billing Month","description":"ISO year-month string, e.g. '2026-04'."},"dry_run":{"type":"boolean","title":"Dry Run","description":"If true, compute invoices but do not write records.","default":false}},"type":"object","required":["billing_month"],"title":"BillingCycleBody","description":"POST /v1/mos/energy-arb/billing/cycle\n\nAdmin-only trigger (HIVE_INTERNAL_DRIVER_KEY). Records a monthly savings\ninvoice per site. Does NOT charge; billing rails land in v0.2."},"BindAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the parametric policy being bound"},"cedent_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cedent Did","description":"DID of the cedent"},"carrier_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Did","description":"DID of the carrier"},"reinsurer_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reinsurer Did","description":"DID of the reinsurer"},"peril_class":{"$ref":"#/components/schemas/PerilClass","description":"Peril class"},"threshold_spec":{"additionalProperties":true,"type":"object","title":"Threshold Spec","description":"Threshold specification: {metric, operator, value, station_id, duration_min}"},"bound_notional_usdc":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Bound Notional Usdc","description":"Bound notional in USDC"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Additional bind metadata"}},"type":"object","required":["policy_did","peril_class","threshold_spec"],"title":"BindAttestRequest","description":"Record a policy bind event."},"BirthCertIssueRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID of the AI agent being born (did:hive:...)"},"controller_did":{"type":"string","title":"Controller Did","description":"DID of the human/org controller (did:hive:...)"},"model_pin":{"type":"string","title":"Model Pin","description":"Pinned model identifier, e.g. 'claude-3-5-sonnet@20241022', 'gpt-4o@2024-11-20'"},"tool_grants":{"items":{"type":"string"},"type":"array","title":"Tool Grants","description":"Granted tool scopes, e.g. ['fs.read', 'http.get', 'payments.x402']"},"policy_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Policy Hash","description":"sha256 hex of the controller's policy document"},"training_cut":{"type":"string","title":"Training Cut","description":"ISO date of the model's training data cut-off, e.g. '2024-04-01'"},"deployment_target":{"type":"string","title":"Deployment Target","description":"Deployment framework: langchain, crewai, autogen, langgraph, mastra, custom"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","description":"Use Cosmic tier pricing","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_did","controller_did","model_pin","tool_grants","policy_hash","training_cut","deployment_target"],"title":"BirthCertIssueRequest","description":"Request to issue a dual-signed agent birth certificate."},"BirthCertIssueResponse":{"properties":{"cert_id":{"type":"string","title":"Cert Id"},"agent_did":{"type":"string","title":"Agent Did"},"controller_did":{"type":"string","title":"Controller Did"},"model_pin":{"type":"string","title":"Model Pin"},"tool_grants":{"items":{"type":"string"},"type":"array","title":"Tool Grants"},"policy_hash":{"type":"string","title":"Policy Hash"},"training_cut":{"type":"string","title":"Training Cut"},"deployment_target":{"type":"string","title":"Deployment Target"},"created_at":{"type":"string","title":"Created At"},"ed25519_signature":{"type":"string","title":"Ed25519 Signature"},"mldsa65_signature":{"type":"string","title":"Mldsa65 Signature"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["cert_id","agent_did","controller_did","model_pin","tool_grants","policy_hash","training_cut","deployment_target","created_at","ed25519_signature","mldsa65_signature","price_usd","receipt_envelope"],"title":"BirthCertIssueResponse"},"BirthCertVerifyRequest":{"properties":{"cert_id":{"type":"string","title":"Cert Id","description":"The cert_id to verify signatures for"}},"type":"object","required":["cert_id"],"title":"BirthCertVerifyRequest"},"BirthCertVerifyResponse":{"properties":{"cert_id":{"type":"string","title":"Cert Id"},"agent_did":{"type":"string","title":"Agent Did"},"controller_did":{"type":"string","title":"Controller Did"},"model_pin":{"type":"string","title":"Model Pin"},"created_at":{"type":"string","title":"Created At"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"verification":{"additionalProperties":true,"type":"object","title":"Verification"}},"type":"object","required":["cert_id","agent_did","controller_did","model_pin","created_at","receipt_envelope","verification"],"title":"BirthCertVerifyResponse"},"BoundaryIn":{"properties":{"kind":{"type":"string","title":"Kind","description":"Boundary kind, e.g. answer_start, answer_end, question_start"},"pos":{"type":"number","title":"Pos","description":"Boundary position on the sealed source timeline"}},"type":"object","required":["kind","pos"],"title":"BoundaryIn"},"BreachAssessmentAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Associate Did","description":"DID of BA if breach was at BA"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Scope of breach assessment","default":"breach_assessment"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories potentially breached"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use","default":"health_oversight"},"factor_nature_and_extent":{"type":"string","title":"Factor Nature And Extent","description":"Nature and extent of PHI involved (no raw PHI)"},"factor_unauthorized_person":{"type":"string","title":"Factor Unauthorized Person","description":"Who used/received the PHI (role/DID reference)"},"factor_acquisition_or_viewing":{"type":"boolean","title":"Factor Acquisition Or Viewing","description":"Was PHI actually acquired or viewed?"},"factor_mitigation":{"type":"string","title":"Factor Mitigation","description":"Extent to which risk has been mitigated"},"low_probability_determination":{"type":"boolean","title":"Low Probability Determination","description":"Low-probability-of-compromise determination","default":false},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Assessment metadata"}},"type":"object","required":["covered_entity_did","factor_nature_and_extent","factor_unauthorized_person","factor_acquisition_or_viewing","factor_mitigation"],"title":"BreachAssessmentAttestRequest","description":"Record a 4-factor HIPAA breach risk analysis."},"BreachNoticeAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Associate Did","description":"DID of BA if applicable"},"patient_did_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Scope","default":"breach_notification"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories in breach"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use","default":"health_oversight"},"breach_assessment_receipt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Breach Assessment Receipt Id","description":"Receipt ID of the breach assessment"},"notification_type":{"type":"string","title":"Notification Type","description":"individual | media | hhs_secretary","default":"individual"},"days_since_discovery":{"type":"integer","title":"Days Since Discovery","description":"Days since breach discovery (must be <= 60 for timely)"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Notification metadata: notification_hash, media_outlet_did, etc."}},"type":"object","required":["covered_entity_did","days_since_discovery"],"title":"BreachNoticeAttestRequest","description":"Record a 60-day HIPAA breach notification event."},"BridgeBody":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"token":{"type":"string","title":"Token"},"from_chain":{"type":"string","title":"From Chain"},"to_chain":{"type":"string","title":"To Chain"},"to_address":{"type":"string","title":"To Address"}},"type":"object","required":["amount","token","from_chain","to_chain","to_address"],"title":"BridgeBody"},"BridgeObserveBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id"},"source_chain":{"type":"string","title":"Source Chain"},"dest_chain":{"type":"string","title":"Dest Chain"},"source_confirmed":{"type":"boolean","title":"Source Confirmed"},"dest_arrived":{"type":"boolean","title":"Dest Arrived"}},"type":"object","required":["tx_id","source_chain","dest_chain","source_confirmed","dest_arrived"],"title":"BridgeObserveBody"},"BucketBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"BucketBody"},"BucketBurnBody":{"properties":{"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["amount_usdc"],"title":"BucketBurnBody"},"BulkRequest":{"properties":{"count":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Count","description":"Number of samples (1-1000)","default":1000},"bytes":{"type":"integer","maximum":64.0,"minimum":16.0,"title":"Bytes","default":32},"purpose":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Purpose"}},"type":"object","title":"BulkRequest"},"BundleVerifyRequest":{"properties":{"bundle_id":{"type":"string","title":"Bundle Id"},"bundle_hash":{"type":"string","title":"Bundle Hash"},"event_count":{"type":"integer","title":"Event Count"},"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Events"},"created_at":{"type":"string","title":"Created At"},"ed25519_signature":{"type":"string","title":"Ed25519 Signature"},"mldsa65_signature":{"type":"string","title":"Mldsa65 Signature"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework"},"control":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Control"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"}},"type":"object","required":["bundle_id","bundle_hash","event_count","events","created_at","ed25519_signature","mldsa65_signature","receipt_envelope"],"title":"BundleVerifyRequest","description":"Request to verify a canonical evidence bundle offline."},"CREEnvelope":{"properties":{"cre_id":{"type":"string","title":"Cre Id"},"txn_type":{"type":"string","title":"Txn Type"},"txn_id":{"type":"string","title":"Txn Id"},"actor":{"type":"string","title":"Actor"},"counterparty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"payload_hash":{"type":"string","title":"Payload Hash"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"canonical_hash":{"type":"string","title":"Canonical Hash"},"ed25519_sig":{"type":"string","title":"Ed25519 Sig"},"ed25519_pub":{"type":"string","title":"Ed25519 Pub"},"mldsa65_sig":{"type":"string","title":"Mldsa65 Sig"},"mldsa65_pub_fingerprint":{"type":"string","title":"Mldsa65 Pub Fingerprint"},"cascade":{"additionalProperties":true,"type":"object","title":"Cascade"},"key_epoch":{"type":"string","title":"Key Epoch","default":""},"mmr":{"additionalProperties":true,"type":"object","title":"Mmr"},"triad":{"additionalProperties":true,"type":"object","title":"Triad"},"issued_at":{"type":"string","title":"Issued At"},"issuer":{"type":"string","title":"Issuer","default":"hive-civilization"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"control_audits":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Control Audits"},"frameworks_attested":{"items":{"type":"string"},"type":"array","title":"Frameworks Attested"},"coverage_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Coverage Pct"},"machine_verified_count":{"type":"integer","title":"Machine Verified Count"},"self_attested_count":{"type":"integer","title":"Self Attested Count"},"verifier_url":{"type":"string","title":"Verifier Url","default":"https://thehiveryiq.com/verify/"},"spec_url":{"type":"string","title":"Spec Url","default":"https://thehiveryiq.com/cre/"}},"type":"object","required":["cre_id","txn_type","txn_id","actor","payload_hash","canonical_hash","ed25519_sig","ed25519_pub","mldsa65_sig","mldsa65_pub_fingerprint","issued_at","controls","control_audits","frameworks_attested","coverage_pct","machine_verified_count","self_attested_count"],"title":"CREEnvelope","description":"Full CRE envelope — what auditors ingest."},"CREIssueRequest":{"properties":{"txn_type":{"type":"string","title":"Txn Type","description":"One of TRANSACTION_TYPES","examples":["settlement","diagnosis","prior_auth"]},"txn_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Txn Id","description":"External txn id; auto-generated if absent"},"actor":{"type":"string","title":"Actor","description":"DID or stable identifier of the initiating party","examples":["did:hive:patient:alice","0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E"]},"counterparty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty","description":"DID or stable identifier of the receiving party"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Domain-specific transaction body. NEVER include PHI/PII in plaintext; use a hash of the underlying record."},"payload_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payload Hash","description":"SHA3-256 of the underlying record if PHI/PII is sealed elsewhere"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions","description":"ISO 3166-1 alpha-2 codes that govern this transaction","examples":[["US-CA"],["DE","EU"],["US","EU","SG"]]},"controls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Controls","description":"Explicit control IDs to attest. If None, auto-selected from DEFAULT_CONTROL_BUNDLE[txn_type]."},"extra_frameworks":{"items":{"type":"string"},"type":"array","title":"Extra Frameworks","description":"Additional frameworks to claim attestation against"}},"type":"object","required":["txn_type","actor"],"title":"CREIssueRequest","description":"Issue a Compliance Receipt Envelope for any transaction."},"CREIssueResponse":{"properties":{"cre_id":{"type":"string","title":"Cre Id"},"envelope":{"$ref":"#/components/schemas/CREEnvelope"},"elapsed_ms":{"type":"number","title":"Elapsed Ms"}},"type":"object","required":["cre_id","envelope","elapsed_ms"],"title":"CREIssueResponse"},"CREManifesto":{"properties":{"title":{"type":"string","title":"Title","default":"The Compliance Receipt Envelope (CRE) Standard v1.0"},"thesis":{"type":"string","title":"Thesis","default":"Compliance is not a workflow. It is a side effect of transacting. Every SOC 2 / ISO 27001 / HIPAA / GDPR / EU AI Act control is reducible to a tuple of fields on a cryptographically-signed envelope. If the envelope validates, the control is machine-attested."},"standards_replaced":{"items":{"type":"string"},"type":"array","title":"Standards Replaced","default":["SOC 2 Type II annual audit (replaced by per-transaction CRE)","ISO 27001 surveillance audits (replaced by continuous CRE coverage)","HIPAA log-review burden (replaced by CRE audit trail)","21 CFR Part 11 e-signature (replaced by ML-DSA-65 dual-sig)","Business Associate Agreements (replaced by CRE flow-down)","GDPR Article 30 records (replaced by CRE export)"]},"standards_extended":{"items":{"type":"string"},"type":"array","title":"Standards Extended","default":["EU AI Act high-risk attestation (CRE = perpetual conformity record)","NIS2 incident reporting (CRE.404.a auto-fires)","DORA ICT third-party register (CRE flow-down satisfies)","eIDAS2 qualified signature (ML-DSA-65 satisfies QES requirements)"]},"key_properties":{"items":{"type":"string"},"type":"array","title":"Key Properties","default":["Offline-verifiable — auditor verifies without calling Hive","Post-quantum — ML-DSA-65 (FIPS 204) signed","Cross-framework — one envelope satisfies up to 13 frameworks","Continuous — every transaction is its own audit","Tamper-evident — SHA3-256 canonical hash binds all fields","Privacy-preserving — only hashes are envelope-resident"]}},"type":"object","title":"CREManifesto","description":"The doctrine in machine-readable form."},"CREVerifyResponse":{"properties":{"cre_id":{"type":"string","title":"Cre Id"},"valid":{"type":"boolean","title":"Valid"},"canonical_hash_match":{"type":"boolean","title":"Canonical Hash Match"},"ed25519_valid":{"type":"boolean","title":"Ed25519 Valid"},"mldsa65_valid":{"type":"boolean","title":"Mldsa65 Valid"},"cascade_valid":{"type":"boolean","title":"Cascade Valid","default":false},"cascade_channels_checked":{"type":"integer","title":"Cascade Channels Checked","default":0},"mmr_inclusion_valid":{"type":"boolean","title":"Mmr Inclusion Valid","default":false},"triad_present":{"type":"boolean","title":"Triad Present","default":false},"triad_valid":{"type":"boolean","title":"Triad Valid","default":false},"triad_pillars_passed":{"type":"integer","title":"Triad Pillars Passed","default":0},"slhdsa_valid":{"type":"boolean","title":"Slhdsa Valid","default":false},"key_epoch":{"type":"string","title":"Key Epoch","default":""},"controls_attested":{"type":"integer","title":"Controls Attested"},"frameworks_attested":{"items":{"type":"string"},"type":"array","title":"Frameworks Attested"},"coverage_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Coverage Pct"},"issued_at":{"type":"string","title":"Issued At"},"age_seconds":{"type":"number","title":"Age Seconds"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["cre_id","valid","canonical_hash_match","ed25519_valid","mldsa65_valid","controls_attested","frameworks_attested","coverage_pct","issued_at","age_seconds"],"title":"CREVerifyResponse"},"CallBody":{"properties":{"prompt":{"type":"string","maxLength":20000,"minLength":1,"title":"Prompt"},"tenant_did":{"type":"string","maxLength":256,"minLength":3,"title":"Tenant Did"},"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"smsh_mode":{"type":"string","title":"Smsh Mode","default":"smsh-std"},"max_tokens":{"type":"integer","title":"Max Tokens","default":512},"temperature":{"type":"number","title":"Temperature","default":0.2},"skip_writeback":{"type":"boolean","title":"Skip Writeback","default":false}},"type":"object","required":["prompt","tenant_did"],"title":"CallBody"},"CaptureRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"UUID identifying the asset across its full lifecycle"},"asset_kind":{"$ref":"#/components/schemas/AssetKindEnum","description":"image / video / audio / document"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the capturing device (e.g. did:hive:camera:...)"},"capture_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capture Did","description":"DID of the capture origin device — populated on capture, propagated as origin pointer"},"media_hash":{"type":"string","title":"Media Hash","description":"sha256 hex of the media bytes"},"c2pa_manifest_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C2Pa Manifest Hash","description":"sha256 hex of the C2PA manifest, if present"},"ai_content_disclosure":{"type":"boolean","title":"Ai Content Disclosure","description":"Was AI used in any way to generate or alter this content?"}},"type":"object","required":["asset_id","asset_kind","actor_did","media_hash","ai_content_disclosure"],"title":"CaptureRequest","description":"Request to attest a capture event (camera/mic)."},"CargoRegisterRequest":{"properties":{"id":{"type":"string","title":"Id","description":"Unique cargo type ID, e.g. 'pii'"},"name":{"type":"string","title":"Name","description":"Human-readable cargo type name"},"version":{"type":"string","title":"Version","description":"Semver version string, e.g. '1.0.0'"},"sensitivity":{"type":"string","enum":["public","internal","confidential","restricted","critical"],"title":"Sensitivity"},"schema":{"additionalProperties":true,"type":"object","title":"Schema","description":"JSON Schema for payload"},"supersedes":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Supersedes","description":"Optional {id, version} of superseded type"}},"type":"object","required":["id","name","version","sensitivity","schema"],"title":"CargoRegisterRequest"},"CargoValidateRequest":{"properties":{"cargo_type_id":{"type":"string","title":"Cargo Type Id","description":"Registered cargo type ID"},"version":{"type":"string","title":"Version","description":"Cargo type version"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Payload to validate"}},"type":"object","required":["cargo_type_id","version","payload"],"title":"CargoValidateRequest"},"CatalogResponse":{"properties":{"count":{"type":"integer","title":"Count"},"models":{"items":{"$ref":"#/components/schemas/ModelCatalogEntry"},"type":"array","title":"Models"},"tiers":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Tiers"}},"type":"object","required":["count","models","tiers"],"title":"CatalogResponse"},"ChainRequest":{"properties":{"chain":{"type":"string","title":"Chain","description":"One of: solana, base, ethereum."},"tx":{"type":"string","maxLength":256,"minLength":4,"title":"Tx","description":"Transaction signature (Solana) or hash (EVM)."},"action":{"type":"string","maxLength":200,"title":"Action","default":"chain_tx"},"external_system":{"type":"string","maxLength":120,"title":"External System","default":"chain"},"network":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Network","description":"Optional network label, e.g. 'mainnet-beta' or '8453'."},"verify":{"type":"boolean","title":"Verify","description":"If true, attempt a read-only public-RPC existence/status lookup.","default":false},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"actor":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Actor"}},"type":"object","required":["chain","tx"],"title":"ChainRequest"},"ChainRunBody":{"properties":{"override_params":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Override Params","description":"Per-step param overrides keyed by step index string: {'0': {'caller_did': '...'}}"}},"type":"object","title":"ChainRunBody"},"ChainTemplateBody":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"description":{"type":"string","title":"Description","default":""},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","minItems":1,"title":"Steps"}},"type":"object","required":["name","steps"],"title":"ChainTemplateBody"},"ChainVerifyResponse":{"properties":{"property_id":{"type":"string","title":"Property Id"},"chain_valid":{"type":"boolean","title":"Chain Valid"},"states_present":{"items":{"$ref":"#/components/schemas/DeedEventType"},"type":"array","title":"States Present"},"sale_price_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sale Price Cents"},"recording_document_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Document Number"},"discrepancies":{"items":{"type":"string"},"type":"array","title":"Discrepancies"},"chain":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Chain"}},"type":"object","required":["property_id","chain_valid","states_present"],"title":"ChainVerifyResponse"},"ChallengeStateIn":{"properties":{"status":{"type":"string","title":"Status","default":"none"},"challenge_refs":{"items":{},"type":"array","title":"Challenge Refs"}},"type":"object","title":"ChallengeStateIn"},"ChatMessage":{"properties":{"role":{"type":"string","title":"Role","description":"'user' or 'assistant'"},"content":{"type":"string","title":"Content"}},"type":"object","required":["role","content"],"title":"ChatMessage"},"ChatPublicReq":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt"}},"type":"object","required":["prompt"],"title":"ChatPublicReq"},"CheckBody":{"properties":{"address":{"type":"string","title":"Address","description":"0x-prefixed counterparty address"},"chain":{"type":"string","title":"Chain","description":"ethereum | base | arbitrum"}},"type":"object","required":["address","chain"],"title":"CheckBody"},"CheckoutRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"tier":{"type":"string","title":"Tier"},"email":{"type":"string","title":"Email"}},"type":"object","required":["tenant_id","tier","email"],"title":"CheckoutRequest"},"ClaimRequest":{"properties":{"sub_id":{"type":"string","title":"Sub Id"},"tx_hash":{"type":"string","minLength":10,"title":"Tx Hash"}},"type":"object","required":["sub_id","tx_hash"],"title":"ClaimRequest"},"ClauseHash":{"properties":{"clause_id":{"type":"string","title":"Clause Id","description":"Clause identifier (e.g. '3.1', 'indemnity', 'ip_ownership')"},"hash":{"type":"string","maxLength":64,"minLength":64,"title":"Hash","description":"sha256 hex of the canonical clause text"}},"type":"object","required":["clause_id","hash"],"title":"ClauseHash","description":"sha256 hash of a contract clause for tamper-evidence."},"ClientIntentRequest":{"properties":{"profile":{"type":"string","maxLength":16,"title":"Profile","description":"nano | standard.","default":"nano"},"amount_usdc":{"anyOf":[{"type":"number","maximum":10000000.0,"minimum":0.0001},{"type":"null"}],"title":"Amount Usdc"},"endpoint_path":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Endpoint Path"}},"type":"object","title":"ClientIntentRequest","description":"Optional body for POST /v1/x402/client-intent (and wallet-intent alias)."},"CloseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"CloseBody"},"CodeRequest":{"properties":{"task":{"type":"string","title":"Task","description":"What code to generate"},"language":{"type":"string","title":"Language","description":"Target language (python/typescript/bash)","default":"python"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Additional codebase context"},"max_tokens":{"type":"integer","maximum":16384.0,"minimum":256.0,"title":"Max Tokens","description":"Max output tokens","default":4096}},"type":"object","required":["task"],"title":"CodeRequest","description":"Code generation request."},"CodeResponse":{"properties":{"code":{"type":"string","title":"Code"},"language":{"type":"string","title":"Language"},"explanation":{"type":"string","title":"Explanation"},"source":{"type":"string","title":"Source"},"configured":{"type":"boolean","title":"Configured"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["code","language","explanation","source","configured"],"title":"CodeResponse"},"CommitReq":{"properties":{"rubric_root":{"type":"string","maxLength":256,"minLength":4,"title":"Rubric Root"},"rubric_version":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Rubric Version"},"vector":{"items":{"$ref":"#/components/schemas/VectorEntry"},"type":"array","maxItems":4096,"minItems":1,"title":"Vector"},"operator":{"type":"string","maxLength":200,"minLength":3,"title":"Operator"},"scored_at":{"type":"string","maxLength":64,"minLength":10,"title":"Scored At"}},"type":"object","required":["rubric_root","vector","operator","scored_at"],"title":"CommitReq"},"CommitmentBuildRequest":{"properties":{"tenant_id":{"type":"string","maxLength":200,"minLength":3,"title":"Tenant Id"}},"type":"object","required":["tenant_id"],"title":"CommitmentBuildRequest"},"ComplianceBundle":{"properties":{"controls_audited":{"type":"integer","title":"Controls Audited"},"all_passed":{"type":"boolean","title":"All Passed"},"score":{"type":"number","title":"Score"},"envelopes":{"items":{"$ref":"#/components/schemas/ComplianceEnvelopeSummary"},"type":"array","title":"Envelopes"}},"type":"object","required":["controls_audited","all_passed","score","envelopes"],"title":"ComplianceBundle"},"ComplianceEnvelopeSummary":{"properties":{"control_id":{"type":"string","title":"Control Id"},"auditor":{"type":"string","title":"Auditor"},"pass":{"type":"boolean","title":"Pass"},"score":{"type":"number","title":"Score"},"sha3_256":{"type":"string","title":"Sha3 256"},"ed25519_signature":{"type":"string","title":"Ed25519 Signature"},"mldsa65_signature":{"type":"string","title":"Mldsa65 Signature"},"duration_ms":{"type":"number","title":"Duration Ms"}},"type":"object","required":["control_id","auditor","pass","score","sha3_256","ed25519_signature","mldsa65_signature","duration_ms"],"title":"ComplianceEnvelopeSummary"},"ComplianceEventIngestRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"Event category: logical_access, config_change, data_export, model_inference, key_rotation, policy_update, audit_log, incident_report, access_review, data_deletion"},"framework_codes":{"items":{"type":"string"},"type":"array","title":"Framework Codes","description":"Framework codes, e.g. ['SOC2', 'ISO27001', 'PCI4']"},"control_codes":{"items":{"type":"string"},"type":"array","title":"Control Codes","description":"Control codes, e.g. ['CC6.1', 'A.9.4.1', '10.2.1']"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the actor performing the action"},"evidence_hash":{"type":"string","title":"Evidence Hash","description":"sha256 hex of the canonical evidence payload"},"subject_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Did","description":"DID of the resource/subject being acted on (optional)"},"prior_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Event Id","description":"UUID of the prior event in the chain (optional)"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["event_type","framework_codes","control_codes","actor_did","evidence_hash"],"title":"ComplianceEventIngestRequest","description":"Request to ingest a compliance event."},"ComplianceReviewBody":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"outcome":{"type":"string","title":"Outcome","description":"'cleared' or 'confirmed_fraud'"},"reviewer":{"type":"string","title":"Reviewer","default":"human-reviewer"}},"type":"object","required":["claim_id","outcome"],"title":"ComplianceReviewBody"},"CompressResponse":{"properties":{"compressed_prompt":{"type":"string","title":"Compressed Prompt"},"receipt":{"additionalProperties":true,"type":"object","title":"Receipt"}},"type":"object","required":["compressed_prompt","receipt"],"title":"CompressResponse"},"CompressV2Request":{"properties":{"prompt":{"type":"string","minLength":1,"title":"Prompt"},"task_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Query","description":"Output-conditioned hint, e.g. 'Summarize this report.' Defaults to a generic summarize prompt if omitted."},"target_ratio":{"type":"number","exclusiveMaximum":1.0,"exclusiveMinimum":0.0,"title":"Target Ratio","description":"Compressed length ≤ target_ratio × original (0.5 = 2x compression).","default":0.5},"min_preservation":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Min Preservation","description":"Reject candidates scoring below this oracle threshold; the selector picks best regardless and flags if below.","default":0.0}},"type":"object","required":["prompt"],"title":"CompressV2Request"},"ConfirmBody":{"properties":{"referrer_code":{"type":"string","title":"Referrer Code"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["referrer_code"],"title":"ConfirmBody"},"ConsentAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of patient or site"},"irb_version_hash":{"type":"string","title":"Irb Version Hash","description":"sha256 of IRB-approved consent form version"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"FHIR-R5/Consent"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of consent document"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"FHIR-R5-Consent"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Consent metadata: patient_id, irb_number, consent_date, etc."}},"type":"object","required":["trial_id","attributable_did","irb_version_hash","original_payload_hash"],"title":"ConsentAttestRequest","description":"Record a patient consent event (with IRB version hash)."},"ContinuityIn":{"properties":{"event":{"type":"string","title":"Event","description":"interruption | handoff | resume | backchannel"},"continues_from_commit":{"type":"string","title":"Continues From Commit","description":"commit of prior receipt","default":""},"detail":{"type":"string","title":"Detail","default":""}},"type":"object","required":["event"],"title":"ContinuityIn"},"ContractParty":{"properties":{"did":{"type":"string","title":"Did","description":"DID of the party (e.g. did:hive:org:acme)"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Human-readable name of the party"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Party role: buyer, seller, licensor, licensee, service_provider, client, other"}},"type":"object","required":["did"],"title":"ContractParty","description":"A party to the contract with a DID."},"ControlAuditRequest":{"properties":{"control_id":{"type":"string","title":"Control Id","description":"Control ID, e.g. 'CC6.1' or 'A.8.24'"}},"type":"object","required":["control_id"],"title":"ControlAuditRequest"},"CosignChallengeReq":{"properties":{"jti":{"type":"string","title":"Jti"},"cosigners_required":{"items":{"type":"string"},"type":"array","title":"Cosigners Required"},"bound_violation":{"type":"string","title":"Bound Violation","default":"spend_cap_exceeded"},"request_summary":{"additionalProperties":true,"type":"object","title":"Request Summary"},"threshold":{"type":"integer","maximum":7.0,"minimum":1.0,"title":"Threshold","default":2},"ttl_seconds":{"type":"integer","maximum":3600.0,"exclusiveMinimum":0.0,"title":"Ttl Seconds","default":300}},"type":"object","required":["jti"],"title":"CosignChallengeReq"},"CosignSignReq":{"properties":{"signer_did":{"type":"string","title":"Signer Did"},"signature":{"type":"string","title":"Signature","description":"base64url Ed25519 signature over (challenge_id || nonce). R11 ships full Threshold SHOD-PQ verification; today the signature is recorded but not cryptographically validated since R11 binds the multi-party signing protocol."}},"type":"object","required":["signer_did","signature"],"title":"CosignSignReq"},"CreateRequest":{"properties":{"creator_did":{"type":"string","title":"Creator Did","description":"DID of the copyright creator"},"work_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Work Hash","description":"SHA-256 hex hash of the work"},"work_type":{"anyOf":[{"type":"string","enum":["music","video","code","writing","art","other"]},{"type":"null"}],"title":"Work Type","default":"other"},"title":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Title"},"license":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"License","description":"e.g. 'cc-by-4.0', 'all-rights-reserved'"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["creator_did","work_hash"],"title":"CreateRequest"},"CustodyAppendRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id","description":"Chain identifier (create new or append to existing)"},"transform_id":{"type":"string","title":"Transform Id","description":"Transform identifier for this step"},"agent_did":{"type":"string","title":"Agent Did","description":"DID of the agent performing the transform"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Transform payload (will be hashed)"},"taint_status":{"type":"string","enum":["clean","tainted","unknown"],"title":"Taint Status","description":"Declared taint status for this node","default":"clean"}},"type":"object","required":["chain_id","transform_id","agent_did"],"title":"CustodyAppendRequest"},"CustodyVerifyRequest":{"properties":{"nodes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Nodes","description":"Ordered list of custody chain nodes"}},"type":"object","required":["nodes"],"title":"CustodyVerifyRequest"},"DataTransferAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of sender (sponsor/site)"},"recipient_did":{"type":"string","title":"Recipient Did","description":"DID of recipient (CRO)"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"CDISC-SDTM"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of transferred dataset"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Transfer metadata: dataset_name, record_count, transfer_method, checksum, etc."}},"type":"object","required":["trial_id","attributable_did","recipient_did","original_payload_hash"],"title":"DataTransferAttestRequest","description":"Record a CRO data handoff / transfer event."},"DatabaseLockAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of data manager or sponsor"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"CDISC-SDTM"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of locked database snapshot"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Lock metadata: lock_date, locked_by_did, dataset_version, query_count_resolved, etc."}},"type":"object","required":["trial_id","attributable_did","original_payload_hash"],"title":"DatabaseLockAttestRequest","description":"Record a database lock event."},"DecisionAttestRequest":{"properties":{"pa_id":{"type":"string","title":"Pa Id","description":"pa_id of the PA being decided"},"decision":{"$ref":"#/components/schemas/DecisionEnum","description":"approve / deny / pend"},"decision_reason_code":{"type":"string","title":"Decision Reason Code","description":"Payer reason code for the decision"},"prior_attestation_id":{"type":"string","title":"Prior Attestation Id","description":"UUID chain pointer to the PA submission envelope (pa_id)"}},"type":"object","required":["pa_id","decision","decision_reason_code","prior_attestation_id"],"title":"DecisionAttestRequest","description":"Request to attest a payer decision on a PA."},"DecisionEnum":{"type":"string","enum":["approve","deny","pend"],"title":"DecisionEnum"},"DecompressRequest":{"properties":{"compressed":{"type":"string","title":"Compressed","description":"Compressed text with smsh sentinels."}},"type":"object","required":["compressed"],"title":"DecompressRequest"},"DecreaseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"},"reduce_size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Reduce Size Usdc"}},"type":"object","required":["position_id","reduce_size_usdc"],"title":"DecreaseBody"},"DeedAttestRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did","description":"DID of the buyer"},"seller_did":{"type":"string","title":"Seller Did","description":"DID of the seller"},"notary_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notary Did","description":"DID of the notary (required at NOTARY_SESSION+)"},"title_agent_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Agent Did"},"escrow_agent_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escrow Agent Did"},"lender_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lender Did"},"property_id":{"type":"string","title":"Property Id","description":"Stable ID across all events (typically APN or escrow#)"},"property":{"anyOf":[{"$ref":"#/components/schemas/PropertyDescriptor"},{"type":"null"}]},"event_type":{"$ref":"#/components/schemas/DeedEventType"},"event_hash":{"type":"string","title":"Event Hash","description":"sha256 of the document snapshot at this state"},"title_company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Company","description":"First American / Old Republic / Stewart / Fidelity"},"title_order_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Order Number"},"title_policy_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Policy Number"},"escrow_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escrow Number"},"mismo_xml_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mismo Xml Hash","description":"sha256 of MISMO 3.4 XML if applicable"},"notarization_type":{"anyOf":[{"$ref":"#/components/schemas/NotarizationType"},{"type":"null"}]},"notary_journal_entry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notary Journal Entry"},"ron_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ron Session Id","description":"Notarize / Stewart / First American RON session id"},"kbai_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Kbai Passed","description":"Knowledge-Based ID Authentication passed"},"credential_analysis_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Credential Analysis Passed"},"recording_status":{"anyOf":[{"$ref":"#/components/schemas/RecordingStatus"},{"type":"null"}]},"recording_book":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Book"},"recording_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Page"},"recording_document_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Document Number"},"recording_county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording County"},"recording_state":{"anyOf":[{"type":"string","maxLength":2},{"type":"null"}],"title":"Recording State"},"recording_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Timestamp"},"sale_price_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Sale Price Cents"},"loan_amount_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Loan Amount Cents"},"earnest_money_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Earnest Money Cents"},"closing_cost_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Closing Cost Cents"},"currency":{"type":"string","maxLength":3,"minLength":3,"title":"Currency","default":"USD"},"form_1099s_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Form 1099S Required"},"fincen_geo_targeting_order":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Fincen Geo Targeting Order","description":"Subject to FinCEN GTO (NYC, Miami, etc.)"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","description":"Use Cosmic tier (inspected / regulated)","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["buyer_did","seller_did","property_id","event_type","event_hash"],"title":"DeedAttestRequest","description":"Attest a single deed/notary state transition.\n\n`event_hash` is the immutable content-hash the caller wants bound to the\nreceipt (typically sha256 of the canonical JSON of the document snapshot).\nThis proves all parties saw exactly the same document at this state."},"DeedAttestResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"buyer_did":{"type":"string","title":"Buyer Did"},"seller_did":{"type":"string","title":"Seller Did"},"notary_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notary Did"},"property_id":{"type":"string","title":"Property Id"},"event_type":{"$ref":"#/components/schemas/DeedEventType"},"event_hash":{"type":"string","title":"Event Hash"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["attestation_id","buyer_did","seller_did","property_id","event_type","event_hash","timestamp_iso","price_usd","receipt_envelope"],"title":"DeedAttestResponse"},"DeedEventType":{"type":"string","enum":["disclosure","offer","acceptance","escrow_open","title_search","notary_session","deed_signed","recording_submitted","recorded","closing","wire_disbursed","amendment","cancellation"],"title":"DeedEventType"},"DeedVerifyResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"buyer_did":{"type":"string","title":"Buyer Did"},"seller_did":{"type":"string","title":"Seller Did"},"property_id":{"type":"string","title":"Property Id"},"event_type":{"$ref":"#/components/schemas/DeedEventType"},"event_hash":{"type":"string","title":"Event Hash"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"verification":{"additionalProperties":true,"type":"object","title":"Verification"}},"type":"object","required":["attestation_id","buyer_did","seller_did","property_id","event_type","event_hash","timestamp_iso","receipt_envelope","verification"],"title":"DeedVerifyResponse"},"DelegationCheckReq":{"properties":{"jti":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Jti","description":"JTI of a stored envelope (issued via /v1/delegation/issue or /operator-sign)."},"envelope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Envelope","description":"Inline envelope dict. Used only when jti is omitted; bypasses the store but still verifies signatures + expiry."},"request":{"additionalProperties":true,"type":"object","title":"Request","description":"Request context. Same shape as /v1/firewall/evaluate's request: {action, endpoint, counterparty_did, jurisdiction, surface, receipt_profile, amount_usdc, spend_today_usdc}."}},"type":"object","title":"DelegationCheckReq","description":"Body for POST /v1/delegation/check.\n\nExactly one of `jti` (preferred) or `envelope` (inline) must be supplied.\nSupplying both is rejected by the validator (no silent precedence). The\n`request` field uses the same shape as /v1/firewall/evaluate's `request`."},"DeliveryAttestRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did"},"supplier_did":{"type":"string","title":"Supplier Did"},"po_number":{"type":"string","title":"Po Number"},"asn_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asn Number"},"bol_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bol Number"},"carrier_scac":{"anyOf":[{"type":"string","maxLength":4},{"type":"null"}],"title":"Carrier Scac","description":"SCAC carrier code"},"delivery_status":{"$ref":"#/components/schemas/DeliveryStatus"},"delivered_qty":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Delivered Qty"},"received_qty":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Received Qty"},"inspection_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Inspection Passed"},"inspection_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inspection Notes"},"delivered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivered At"},"received_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Received At"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["buyer_did","supplier_did","po_number","delivery_status"],"title":"DeliveryAttestRequest"},"DeliveryAttestResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"buyer_did":{"type":"string","title":"Buyer Did"},"supplier_did":{"type":"string","title":"Supplier Did"},"po_number":{"type":"string","title":"Po Number"},"delivery_status":{"$ref":"#/components/schemas/DeliveryStatus"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["attestation_id","buyer_did","supplier_did","po_number","delivery_status","timestamp_iso","price_usd","receipt_envelope"],"title":"DeliveryAttestResponse"},"DeliveryStatus":{"type":"string","enum":["scheduled","in_transit","delivered","partial","rejected"],"title":"DeliveryStatus"},"DemoRunRequest":{"properties":{"caller_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller Content"},"entry_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Id"},"proof_mode":{"type":"string","title":"Proof Mode","default":"standard"}},"type":"object","title":"DemoRunRequest"},"DemoWatchRequest":{"properties":{"job_kind":{"type":"string","title":"Job Kind","default":"summarize"},"amount_micro_usdc":{"type":"integer","minimum":1.0,"title":"Amount Micro Usdc","default":500000},"sealed":{"type":"boolean","title":"Sealed","default":false}},"type":"object","title":"DemoWatchRequest"},"DepinListBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id","description":"Unique listing id"},"provider_category":{"type":"string","title":"Provider Category","description":"One of ['gpu_compute', 'storage', 'wireless', 'sensor', 'energy_meter', 'bandwidth']"},"unit_rate_usdc":{"type":"number","minimum":0.0,"title":"Unit Rate Usdc"},"unit_label":{"type":"string","title":"Unit Label","description":"Human label for unit_rate_usdc unit (e.g. 'per GPU-hour', 'per TB-month', 'per Mbps-hour', 'per kWh').","default":"per unit"},"settle_currencies":{"items":{"type":"string"},"type":"array","title":"Settle Currencies"},"operator_did":{"type":"string","title":"Operator Did","default":"did:hive:depin:operator"},"payout_address":{"type":"string","title":"Payout Address","default":""},"capacity_gb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Capacity Gb"},"redundancy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redundancy"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"availability_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Availability Pct"},"radio_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Radio Type"},"coverage_km2":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Coverage Km2"},"throughput_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Throughput Mbps"},"sensor_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sensor Type"},"sample_rate_hz":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Sample Rate Hz"},"data_freshness_sec":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Data Freshness Sec"},"meter_kwh_capacity":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Meter Kwh Capacity"},"grid_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grid Zone"},"bidir_capable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bidir Capable"},"up_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Up Mbps"},"down_mbps":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Down Mbps"},"peering":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peering"},"vram_gb":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Vram Gb"},"gpu_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gpu Model"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_id","provider_category","unit_rate_usdc"],"title":"DepinListBody"},"DesignerChatRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","maxItems":40,"minItems":1,"title":"Messages"},"spec":{"additionalProperties":true,"type":"object","title":"Spec"},"step_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Step Hint","description":"Optional: which spec field this turn is asking about."}},"type":"object","required":["messages"],"title":"DesignerChatRequest"},"DesignerChatResponse":{"properties":{"assistant_message":{"type":"string","title":"Assistant Message"},"spec_patch":{"additionalProperties":true,"type":"object","title":"Spec Patch"},"spec":{"additionalProperties":true,"type":"object","title":"Spec"},"spec_complete":{"type":"boolean","title":"Spec Complete"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"},"free_quota":{"additionalProperties":true,"type":"object","title":"Free Quota"},"model":{"type":"string","title":"Model"},"turn_id":{"type":"string","title":"Turn Id"}},"type":"object","required":["assistant_message","spec_patch","spec","spec_complete","missing_fields","free_quota","model","turn_id"],"title":"DesignerChatResponse"},"DiscoveryRegisterRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"repo":{"type":"string","title":"Repo","default":""},"endpoint":{"type":"string","title":"Endpoint","default":""},"did":{"type":"string","title":"Did","default":""},"tools":{"items":{"$ref":"#/components/schemas/ToolSpec"},"type":"array","title":"Tools"}},"type":"object","required":["shim"],"title":"DiscoveryRegisterRequest"},"DisputeAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy under dispute"},"disputing_party_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disputing Party Did","description":"DID of the disputing party"},"dispute_grounds":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Grounds","description":"Grounds for dispute"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Dispute metadata"}},"type":"object","required":["policy_did"],"title":"DisputeAttestRequest","description":"Record a dispute opened."},"DisputeRequest":{"properties":{"certificate_id":{"type":"string","title":"Certificate Id"},"claim":{"type":"string","title":"Claim"},"tenant_id":{"type":"string","title":"Tenant Id"}},"type":"object","required":["certificate_id","claim","tenant_id"],"title":"DisputeRequest"},"DosingAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of site or nurse administering"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"CDISC-SDTM/EX"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of dosing record"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3/EX"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Dosing metadata: subject_id, dose_mg, route, datetime, batch_number, etc."}},"type":"object","required":["trial_id","attributable_did","original_payload_hash"],"title":"DosingAttestRequest","description":"Record a dosing event."},"DraftAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Unique contract identifier (UUID or client-assigned)"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties","description":"Contracting parties with DIDs"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes","description":"Clause tamper-evidence hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Arbitrary event metadata (title, jurisdiction, governing_law, etc.)"}},"type":"object","required":["contract_id","parties"],"title":"DraftAttestRequest","description":"Record a contract draft creation event."},"DripBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"DripBody"},"DropBody":{"properties":{"dropper_did":{"type":"string","title":"Dropper Did","description":"DID of the agent dropping the artifact"},"content_type":{"type":"string","title":"Content Type","description":"One of trail.CONTENT_TYPES"},"payload_b64":{"type":"string","title":"Payload B64","description":"Base64-encoded payload bytes"},"location":{"$ref":"#/components/schemas/LocationBody"},"physics_overrides":{"anyOf":[{"$ref":"#/components/schemas/PhysicsOverrides"},{"type":"null"}]},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["dropper_did","content_type","payload_b64","location"],"title":"DropBody"},"EDIDocumentType":{"type":"string","enum":["po","po_ack","asn","invoice","payment"],"title":"EDIDocumentType"},"EDIFormat":{"type":"string","enum":["x12","edifact","cxml","idoc"],"title":"EDIFormat"},"EDIParseRequest":{"properties":{"edi_payload":{"type":"string","title":"Edi Payload"},"format":{"$ref":"#/components/schemas/EDIFormat"}},"type":"object","required":["edi_payload","format"],"title":"EDIParseRequest","description":"Parse an inbound EDI document and extract the embedded Hive receipt segment if present."},"EDIParseResponse":{"properties":{"parsed_at":{"type":"string","title":"Parsed At"},"format":{"$ref":"#/components/schemas/EDIFormat"},"document_type":{"anyOf":[{"$ref":"#/components/schemas/EDIDocumentType"},{"type":"null"}]},"sender_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Id"},"receiver_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receiver Id"},"interchange_control_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interchange Control Number"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","description":"Normalized fields extracted from the EDI document"},"hive_receipt_found":{"type":"boolean","title":"Hive Receipt Found"},"hive_receipt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hive Receipt Id"},"hive_receipt_verifies":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hive Receipt Verifies"},"hive_receipt_envelope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Hive Receipt Envelope"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["parsed_at","format","document_type","sender_id","receiver_id","interchange_control_number","hive_receipt_found","hive_receipt_id","hive_receipt_verifies","hive_receipt_envelope"],"title":"EDIParseResponse"},"EDIWrapRequest":{"properties":{"receipt_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receipt Id","description":"Existing Hive receipt id to wrap. One of receipt_id or receipt_envelope must be set."},"receipt_envelope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Receipt Envelope","description":"Inline receipt envelope (alternative to receipt_id)."},"format":{"$ref":"#/components/schemas/EDIFormat","description":"Output EDI format"},"document_type":{"$ref":"#/components/schemas/EDIDocumentType","description":"Procurement document type"},"sender_id":{"type":"string","title":"Sender Id","description":"Sender qualifier:id (e.g. 'ZZ:HIVE001')"},"receiver_id":{"type":"string","title":"Receiver Id","description":"Receiver qualifier:id (e.g. 'ZZ:KOJO001')"},"interchange_control_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Interchange Control Number","description":"Optional ISA13 control number; auto-generated if omitted"},"test_indicator":{"type":"boolean","title":"Test Indicator","description":"ISA15 = T (test) vs P (production)","default":false}},"type":"object","required":["format","document_type","sender_id","receiver_id"],"title":"EDIWrapRequest","description":"Request to wrap a Hive receipt in an EDI envelope."},"EDIWrapResponse":{"properties":{"wrap_id":{"type":"string","title":"Wrap Id"},"format":{"$ref":"#/components/schemas/EDIFormat"},"document_type":{"$ref":"#/components/schemas/EDIDocumentType"},"edi_payload":{"type":"string","title":"Edi Payload","description":"The serialized EDI document with appended Hive cryptographic segment"},"receipt_id":{"type":"string","title":"Receipt Id"},"sender_id":{"type":"string","title":"Sender Id"},"receiver_id":{"type":"string","title":"Receiver Id"},"interchange_control_number":{"type":"string","title":"Interchange Control Number"},"issued_at":{"type":"string","title":"Issued At"},"price_usd":{"type":"number","title":"Price Usd","default":0.0001},"price_micro_usdc":{"type":"integer","title":"Price Micro Usdc","default":100}},"type":"object","required":["wrap_id","format","document_type","edi_payload","receipt_id","sender_id","receiver_id","interchange_control_number","issued_at"],"title":"EDIWrapResponse"},"EditRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"UUID of the asset being edited"},"asset_kind":{"$ref":"#/components/schemas/AssetKindEnum","description":"image / video / audio / document"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the editor / NLE"},"editor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Editor Did","description":"DID of the editor (alias for actor_did in edit context)"},"capture_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capture Did","description":"Origin capture DID — propagated from capture event"},"media_hash":{"type":"string","title":"Media Hash","description":"sha256 hex of the edited media bytes"},"c2pa_manifest_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C2Pa Manifest Hash","description":"sha256 hex of the C2PA manifest"},"ai_content_disclosure":{"type":"boolean","title":"Ai Content Disclosure","description":"Was AI used in generation or alteration?"},"prior_attestation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Attestation Id","description":"Chain pointer to the prior event in this asset's lifecycle (e.g. capture attestation_id)"}},"type":"object","required":["asset_id","asset_kind","actor_did","media_hash","ai_content_disclosure"],"title":"EditRequest","description":"Request to attest an edit step with chain pointer."},"EmitReceiptRequest":{"properties":{"spin_session_id":{"type":"string","title":"Spin Session Id"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"},"amount_usdc":{"anyOf":[{"type":"number","maximum":10000.0,"minimum":0.0001},{"type":"null"}],"title":"Amount Usdc"}},"type":"object","required":["spin_session_id"],"title":"EmitReceiptRequest"},"EmitReceiptResponse":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt"},"total_receipts":{"type":"integer","title":"Total Receipts"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["receipt","total_receipts","session_id"],"title":"EmitReceiptResponse"},"EnclosingIn":{"properties":{"units":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Units","description":"Total units in the enclosing container"},"covered_units":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Covered Units","description":"Units the excerpt covers"},"unit":{"type":"string","title":"Unit","default":"units"},"container":{"type":"string","title":"Container","default":"record"},"contiguous":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Contiguous"}},"type":"object","title":"EnclosingIn"},"EnforcePreviewReq":{"properties":{"jti":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jti","description":"If set, fetch the stored envelope by jti and evaluate against it. Otherwise pass `envelope` inline."},"envelope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Envelope"},"request":{"additionalProperties":true,"type":"object","title":"Request"}},"type":"object","title":"EnforcePreviewReq"},"EnforceRequest":{"properties":{"spans":{"items":{"$ref":"#/components/schemas/SpanModel"},"type":"array","minItems":1,"title":"Spans"},"output":{"type":"string","maxLength":128000,"minLength":1,"title":"Output"},"embedding_model_id":{"type":"string","title":"Embedding Model Id","default":"tfidf-deterministic-v1"},"policy":{"$ref":"#/components/schemas/PolicyModel"}},"type":"object","required":["spans","output"],"title":"EnforceRequest"},"EnrollmentAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of site or investigator"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"CDISC-SDTM/DM"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of enrollment record"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3/DM"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Enrollment metadata: subject_id, arm, randomization_code, etc."}},"type":"object","required":["trial_id","attributable_did","original_payload_hash"],"title":"EnrollmentAttestRequest","description":"Record an enrollment event."},"EnterRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID the agent claims (any string).","default":""},"framework":{"type":"string","title":"Framework","description":"openclaw|hermes|kimi|manus|custom","default":"custom"},"ttl_seconds":{"type":"integer","maximum":86400.0,"minimum":60.0,"title":"Ttl Seconds","default":3600}},"type":"object","title":"EnterRequest"},"EvaluateReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"endpoint":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Endpoint"},"spend_usd":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Spend Usd"},"counterparty_did":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Counterparty Did"},"size_bytes":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Size Bytes"},"proof_tier":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Proof Tier"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Jurisdiction"},"latency_ms":{"anyOf":[{"type":"number","maximum":600000.0,"minimum":0.0},{"type":"null"}],"title":"Latency Ms"},"persist_observation":{"type":"boolean","title":"Persist Observation","default":false},"decision":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Decision"}},"type":"object","required":["agent_did"],"title":"EvaluateReq"},"EventRequest":{"properties":{"action":{"type":"string","maxLength":200,"minLength":1,"title":"Action","description":"What happened, e.g. 'invoice.paid' or 'stablecoin_transfer'."},"external_system":{"type":"string","maxLength":120,"title":"External System","description":"Source system, e.g. 'circle', 'stripe', 'my-agent'.","default":"unknown"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Arbitrary event payload. Hashed into intent_hash; signed as self-attested."},"request_body":{"anyOf":[{},{"type":"null"}],"title":"Request Body","description":"Optional request bytes/object to hash into request_hash."},"response_body":{"anyOf":[{},{"type":"null"}],"title":"Response Body","description":"Optional response bytes/object to hash into response_hash."},"evidence":{"items":{},"type":"array","title":"Evidence","description":"Optional supporting artifacts; each is hashed into evidence_hashes."},"actor":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Actor","description":"Optional actor/agent identifiers (e.g. {'agent_did': '...'})."}},"type":"object","required":["action"],"title":"EventRequest"},"EvidenceBundleExportRequest":{"properties":{"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework","description":"Framework code filter"},"control":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Control","description":"Control code filter"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start","description":"ISO 8601 UTC start timestamp"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"ISO 8601 UTC end timestamp"}},"type":"object","title":"EvidenceBundleExportRequest","description":"Request to export a canonical evidence bundle."},"EvidenceIn":{"properties":{"c2pa_refs":{"items":{},"type":"array","title":"C2Pa Refs"},"capture_attestations":{"items":{},"type":"array","title":"Capture Attestations"},"model_attestations":{"items":{},"type":"array","title":"Model Attestations"},"prompt_commitments":{"items":{},"type":"array","title":"Prompt Commitments"},"source_asset_hashes":{"items":{},"type":"array","title":"Source Asset Hashes"},"watermark_signals":{"items":{},"type":"array","title":"Watermark Signals"},"human_attestations":{"items":{},"type":"array","title":"Human Attestations"}},"type":"object","title":"EvidenceIn"},"EvidenceQueryRequest":{"properties":{"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework","description":"Framework code filter, e.g. 'SOC2'"},"control":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Control","description":"Control code filter, e.g. 'CC6.1'"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start","description":"ISO 8601 UTC start timestamp (inclusive)"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"ISO 8601 UTC end timestamp (inclusive)"},"limit":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Limit","default":100},"offset":{"type":"integer","minimum":0.0,"title":"Offset","default":0}},"type":"object","title":"EvidenceQueryRequest","description":"Query parameters for evidence retrieval."},"ExcerptIn":{"properties":{"fragments":{"items":{"$ref":"#/components/schemas/FragmentIn"},"type":"array","title":"Fragments","description":"Excerpt fragments cut from the parent"},"enclosing":{"anyOf":[{"$ref":"#/components/schemas/EnclosingIn"},{"type":"null"}],"description":"Optional enclosing-container context"}},"type":"object","title":"ExcerptIn"},"ExecuteAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID being executed"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties","description":"All executing parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Execution metadata: effective_date, governing_law, signature_page_hash, etc."}},"type":"object","required":["contract_id","parties"],"title":"ExecuteAttestRequest","description":"Record full execution (all parties signed)."},"FileClaimBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id"},"claimant_did":{"type":"string","title":"Claimant Did"},"counterparty_did":{"type":"string","title":"Counterparty Did"},"victim_wallet":{"type":"string","title":"Victim Wallet"},"amount_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usd"},"proof_type":{"type":"string","title":"Proof Type","description":"ProofType enum value","default":"revert"},"agent_id":{"type":"string","title":"Agent Id","default":"dna-001"},"commission_rate":{"type":"number","maximum":0.5,"minimum":0.01,"title":"Commission Rate","default":0.1}},"type":"object","required":["tx_id","claimant_did","counterparty_did","victim_wallet","amount_usd"],"title":"FileClaimBody"},"FirewallEvalReq":{"properties":{"envelope":{"additionalProperties":true,"type":"object","title":"Envelope"},"request":{"additionalProperties":true,"type":"object","title":"Request"}},"type":"object","required":["envelope"],"title":"FirewallEvalReq"},"FragmentIn":{"properties":{"start":{"type":"number","title":"Start","description":"Fragment start on the parent timeline"},"end":{"type":"number","title":"End","description":"Fragment end on the parent timeline"},"order":{"type":"integer","title":"Order","description":"Presentation order of this fragment in the excerpt","default":0}},"type":"object","required":["start","end"],"title":"FragmentIn"},"FreeIssueRequestBody":{"properties":{"payload":{"type":"string","maxLength":8192,"minLength":1,"title":"Payload","description":"Any string to sign (PR diff, contract clause, API log, tx hash, etc)."},"label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Label","description":"Optional human-readable label shown on the verify page."}},"type":"object","required":["payload"],"title":"FreeIssueRequestBody"},"Fsma204Info":{"properties":{"kde_lot_code":{"type":"string","title":"Kde Lot Code","description":"KDE: traceability lot code"},"kde_cultivar":{"type":"string","title":"Kde Cultivar","description":"KDE: cultivar / variety"},"kde_growing_area":{"items":{"type":"number"},"type":"array","maxItems":2,"minItems":2,"title":"Kde Growing Area","description":"[lat, lon] growing area from KDE"},"kde_production_date":{"type":"string","title":"Kde Production Date","description":"KDE: production / harvest date"}},"type":"object","required":["kde_lot_code","kde_cultivar","kde_growing_area","kde_production_date"],"title":"Fsma204Info","description":"FSMA 204 Key Data Elements (optional; present for produce / livestock)."},"FundBody":{"properties":{"contract_id":{"type":"string","title":"Contract Id"},"funder_did":{"type":"string","title":"Funder Did"}},"type":"object","required":["contract_id","funder_did"],"title":"FundBody"},"FundingTickBody":{"properties":{"underlying_key":{"type":"string","title":"Underlying Key"}},"type":"object","required":["underlying_key"],"title":"FundingTickBody"},"GateEvaluateRequest":{"properties":{"passport_manifest":{"additionalProperties":true,"type":"object","title":"Passport Manifest","description":"C15 passport manifest"},"cargo_manifest":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Cargo Manifest","description":"C17 cargo manifest (optional)"},"custody_root":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custody Root","description":"Expected custody chain Merkle root (optional)"},"warranty_ids":{"items":{"type":"string"},"type":"array","title":"Warranty Ids","description":"Active warranty IDs to verify"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Additional gate evaluation context"}},"type":"object","required":["passport_manifest"],"title":"GateEvaluateRequest"},"GateRegisterRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"repo":{"type":"string","title":"Repo","default":""},"ecosystem":{"type":"string","minLength":1,"title":"Ecosystem"},"manifest":{"additionalProperties":true,"type":"object","title":"Manifest"}},"type":"object","required":["shim","ecosystem"],"title":"GateRegisterRequest"},"GitIntegrationRequest":{"properties":{"creator_did":{"type":"string","title":"Creator Did","description":"DID of the repository owner"},"repo_url":{"type":"string","maxLength":2048,"title":"Repo Url"},"commit_sha":{"type":"string","maxLength":64,"minLength":40,"title":"Commit Sha"},"commit_message_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Commit Message Hash","description":"SHA-256 of the commit message"}},"type":"object","required":["creator_did","repo_url","commit_sha","commit_message_hash"],"title":"GitIntegrationRequest"},"GrabRopeBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"GrabRopeBody"},"GroupRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label","description":"Human label for the group."},"receipts":{"items":{},"type":"array","title":"Receipts","description":"Inline receipt objects (as returned by /v1/receipt-relay/*) and/or receipt_id strings."},"receipt_ids":{"items":{"type":"string"},"type":"array","title":"Receipt Ids","description":"Receipt IDs to reference. Bodies not supplied are recorded but marked unresolved."},"graph":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Graph","description":"Optional relationships between receipts, e.g. {'edges': [{'from': 'r_a', 'to': 'r_b', 'rel': 'follows'}]}."},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Optional caller metadata."}},"type":"object","title":"GroupRequest"},"HKTNRegisterReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"intent":{"type":"string","maxLength":64,"title":"Intent","default":"hktn.register"},"contact":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Contact"},"operator_did":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Operator Did","description":"Optional operator/issuer that vouches for this agent."},"requested_tier":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}],"title":"Requested Tier","description":"Optional self-claim. Cold|Warm|Hot|Regulated. Subject to verification."},"notes":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Notes"}},"type":"object","required":["agent_did"],"title":"HKTNRegisterReq"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HandshakeRequest":{"properties":{"agent_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Did","description":"DID of the calling agent (optional but recommended for trust scoring)."},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name","description":"Human-readable name of the calling agent."},"protocol_versions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Protocol Versions","description":"List of A2A protocol versions the caller supports (e.g. ['0.2', '0.1'])."},"capabilities_requested":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Capabilities Requested","description":"Capability tags the caller intends to use (e.g. ['receipt-emit', 'attest'])."},"nonce":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nonce","description":"Caller-supplied nonce, echoed back. If omitted, server generates one."}},"type":"object","title":"HandshakeRequest","description":"A2A handshake initiation envelope."},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"model_id":{"type":"string","title":"Model Id"},"configured":{"type":"boolean","title":"Configured"},"last_call_status":{"type":"string","title":"Last Call Status"},"cumulative_spend_usd":{"type":"number","title":"Cumulative Spend Usd"},"daily_cap_usd":{"type":"number","title":"Daily Cap Usd"},"spend_day":{"type":"string","title":"Spend Day"},"total_calls":{"type":"integer","title":"Total Calls"},"build":{"type":"string","title":"Build","default":"45"},"feature_flag":{"type":"string","title":"Feature Flag","default":"KIMI_ENABLED"},"env_var_required":{"type":"string","title":"Env Var Required","default":"OPENROUTER_API_KEY"}},"type":"object","required":["status","model_id","configured","last_call_status","cumulative_spend_usd","daily_cap_usd","spend_day","total_calls"],"title":"HealthResponse"},"HookBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"n_triggers":{"type":"integer","minimum":1.0,"title":"N Triggers","default":1},"prepay_usdc":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Prepay Usdc"}},"type":"object","required":["caller_did"],"title":"HookBody"},"HttpRequest":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url","description":"Absolute http(s) URL. Must resolve to a public address (SSRF-guarded)."},"method":{"type":"string","maxLength":10,"title":"Method","default":"GET"},"headers":{"additionalProperties":{"type":"string"},"type":"object","title":"Headers","description":"Request headers (do not send secrets you don't want hashed)."},"body":{"anyOf":[{"type":"string","maxLength":32768},{"type":"null"}],"title":"Body","description":"Optional request body (string)."},"external_system":{"type":"string","maxLength":120,"title":"External System","default":"http"},"dry_run":{"type":"boolean","title":"Dry Run","description":"If true, sign a prepare-only event WITHOUT making the request.","default":false},"actor":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Actor"}},"type":"object","required":["url"],"title":"HttpRequest"},"HypotheticalEvent":{"properties":{"event_type":{"type":"string","title":"Event Type"},"age_seconds":{"type":"integer","maximum":31536000.0,"minimum":0.0,"title":"Age Seconds","default":0},"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","required":["event_type"],"title":"HypotheticalEvent"},"IncreaseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"},"additional_size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Additional Size Usdc"},"additional_collateral":{"type":"number","exclusiveMinimum":0.0,"title":"Additional Collateral"}},"type":"object","required":["position_id","additional_size_usdc","additional_collateral"],"title":"IncreaseBody"},"InferenceRequestBody":{"properties":{"model":{"type":"string","title":"Model","description":"QVAC model ID, e.g. LLAMA_3_2_1B_INST_Q4_0"},"prompt":{"type":"string","maxLength":4096,"minLength":1,"title":"Prompt"},"capability":{"type":"string","title":"Capability","default":"llm_completion"},"asset":{"type":"string","title":"Asset","description":"Settlement asset: USDT, USDPT, USDC","default":"USDT"},"price_usdc":{"type":"number","minimum":0.0,"title":"Price Usdc","default":0.001},"requester_did":{"type":"string","title":"Requester Did","default":"did:hive:caller"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id","description":"Specific provider; otherwise auto-pick."},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["model","prompt"],"title":"InferenceRequestBody"},"InspectSampleRequest":{"properties":{"sample_id":{"type":"string","title":"Sample Id","description":"Identifier for the sample batch"},"records":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Records","description":"Records to probabilistically inspect"},"sample_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Sample Rate","description":"Fraction to inspect (0.0–1.0)","default":0.1},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed","description":"Optional RNG seed for reproducibility"}},"type":"object","required":["sample_id","records"],"title":"InspectSampleRequest"},"IntentRequest":{"properties":{"plan":{"type":"string","title":"Plan","description":"dev-pack or saas-pro"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"for receipt + provisioning notification"}},"type":"object","required":["plan"],"title":"IntentRequest"},"InvoiceCreateBody":{"properties":{"buyer_address":{"type":"string","title":"Buyer Address","description":"Buyer wallet (EVM hex or Solana base58)"},"supplier_address":{"type":"string","title":"Supplier Address","description":"Supplier wallet (EVM hex or Solana base58)"},"amount_usdt":{"type":"number","maximum":250000.0,"exclusiveMinimum":0.0,"title":"Amount Usdt"},"currency_pair":{"type":"string","title":"Currency Pair","description":"e.g. 'USD->VND'"},"incoterm":{"type":"string","title":"Incoterm","description":"FOB / CIF / EXW"},"expected_settlement_chain":{"type":"string","title":"Expected Settlement Chain","description":"base / ethereum / solana"},"purchase_order_ref":{"type":"string","title":"Purchase Order Ref"},"supplier_country":{"type":"string","maxLength":2,"minLength":2,"title":"Supplier Country","description":"ISO-3166 alpha-2 code"},"settlement_asset":{"type":"string","title":"Settlement Asset","description":"USDT (default) or USDC","default":"USDT"},"hs_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hs Code","description":"Optional Harmonized System code"}},"type":"object","required":["buyer_address","supplier_address","amount_usdt","currency_pair","incoterm","expected_settlement_chain","purchase_order_ref","supplier_country"],"title":"InvoiceCreateBody"},"InvokeBody":{"properties":{"model":{"type":"string","title":"Model","default":"LLAMA_3_2_1B_INST_Q4_0"},"prompt":{"type":"string","maxLength":4096,"minLength":1,"title":"Prompt","default":"forge invoke ping"},"capability":{"type":"string","title":"Capability","default":"llm_completion"},"settle_currency":{"type":"string","title":"Settle Currency","description":"USDT or USDC","default":"USDT"},"price_usdc":{"type":"number","minimum":0.0,"title":"Price Usdc","default":0.0008},"requester_did":{"type":"string","title":"Requester Did","default":"did:hive:forge:caller"},"payout_address":{"type":"string","title":"Payout Address","default":"0x15184bf50b3d3f52b60434f8942b7d52f2eb436e"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"force_need":{"type":"boolean","title":"Force Need","description":"Test path — assert NEED externally. Without this, NEED is checked from the live qvac leaderboard.","default":false}},"type":"object","title":"InvokeBody"},"IouRepayBody":{"properties":{"repay_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Repay Usdc"}},"type":"object","required":["repay_usdc"],"title":"IouRepayBody"},"IouRequestBody":{"properties":{"borrow_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Borrow Usdc"},"interest_bps":{"type":"integer","minimum":0.0,"title":"Interest Bps"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["borrow_usdc","interest_bps"],"title":"IouRequestBody"},"IssueReq":{"properties":{"agent_id":{"type":"string","minLength":1,"title":"Agent Id"},"operator_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator Did","description":"Operator DID. If omitted, Hive soft-signs as `did:hive:operator-default` (pilot path)."},"allowed_actions":{"items":{"type":"string"},"type":"array","title":"Allowed Actions"},"max_spend_usdc":{"type":"number","minimum":0.0,"title":"Max Spend Usdc","default":0.0},"allowed_endpoints":{"items":{"type":"string"},"type":"array","title":"Allowed Endpoints"},"allowed_counterparties":{"items":{"type":"string"},"type":"array","title":"Allowed Counterparties"},"allowed_jurisdictions":{"items":{"type":"string"},"type":"array","title":"Allowed Jurisdictions"},"allowed_surfaces":{"items":{"type":"string"},"type":"array","title":"Allowed Surfaces"},"max_proof_tier":{"type":"string","title":"Max Proof Tier","default":"standard"},"ttl_seconds":{"type":"integer","maximum":31536000.0,"exclusiveMinimum":0.0,"title":"Ttl Seconds","default":86400}},"type":"object","required":["agent_id"],"title":"IssueReq"},"IssueRequest":{"properties":{"parent_mor":{"additionalProperties":true,"type":"object","title":"Parent Mor","description":"A full, valid parent Media Origin Receipt object"},"sealed_parent":{"$ref":"#/components/schemas/SealedParentIn","description":"The parent boundary map sealed at capture"},"excerpt":{"$ref":"#/components/schemas/ExcerptIn","description":"The excerpt to classify against the sealed boundaries"},"excerpt_commitment":{"type":"string","title":"Excerpt Commitment","description":"Optional fingerprint of the excerpt","default":""}},"type":"object","required":["parent_mor","sealed_parent","excerpt"],"title":"IssueRequest"},"IssueRequestBody":{"properties":{"tx_hash":{"type":"string","title":"Tx Hash","description":"Caller transaction reference"},"agent_did":{"type":"string","title":"Agent Did","description":"Issuing agent DID"},"counterparty_did":{"type":"string","title":"Counterparty Did","description":"Counterparty agent DID"},"profile":{"type":"string","title":"Profile","description":"Receipt profile; must be 'swarm'","default":"swarm"},"round_id":{"type":"integer","title":"Round Id","description":"Optional federation round ID (0 = auto)","default":0}},"type":"object","required":["tx_hash","agent_did","counterparty_did"],"title":"IssueRequestBody"},"JobSubmitRequest":{"properties":{"job_id":{"type":"integer","minimum":0.0,"title":"Job Id","description":"ERC-8183 jobId (uint256)."},"client":{"type":"string","title":"Client","description":"Client address (0x... or solana pubkey)."},"provider":{"type":"string","title":"Provider","description":"Provider address."},"tier":{"type":"string","title":"Tier","description":"Fee tier: simple | evaluation | arbitration."},"job_value_usdc_atomic":{"type":"integer","minimum":0.0,"title":"Job Value Usdc Atomic","description":"Job value in USDC atomic units (6 decimals)."},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana.","default":"base"},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment (0x-prefixed, 66 chars).","default":"0x0000000000000000000000000000000000000000000000000000000000000000"}},"type":"object","required":["job_id","client","provider","tier","job_value_usdc_atomic"],"title":"JobSubmitRequest"},"LabelRegister":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":4,"title":"Slug"},"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"}},"type":"object","required":["slug","label"],"title":"LabelRegister"},"LeadBody":{"properties":{"email":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Email"},"company":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Company"},"use_case":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Use Case"},"enterprise_label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Enterprise Label"},"model_family":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Model Family"},"source":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Source"},"path":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Path"},"ref":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Ref"}},"type":"object","title":"LeadBody"},"LearnedPruneRequest":{"properties":{"text":{"type":"string","title":"Text","description":"The prompt text to prune."},"target_ratio":{"type":"number","maximum":0.99,"minimum":0.1,"title":"Target Ratio","description":"Target compression ratio (output tokens / input tokens). Default 0.5 = 50 percent of original.","default":0.5},"importance_floor":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Importance Floor","description":"Spans with importance below this floor are eligible to drop. Default 30. Raise to 40-50 for higher fidelity.","default":30},"model":{"type":"string","title":"Model","description":"Model alias for the judge. See /v1/smsh/judge for options.","default":"auto"}},"type":"object","required":["text"],"title":"LearnedPruneRequest"},"LeaveRequest":{"properties":{"passport_id":{"type":"string","title":"Passport Id"}},"type":"object","required":["passport_id"],"title":"LeaveRequest"},"LedgerAppendBody":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"affordance | bus_offer | bus_pickup | chain_run | manual"},"supermodel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Id"},"supermodel_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supermodel Name"},"amount_usdc":{"type":"number","minimum":0.0,"title":"Amount Usdc","default":0.0},"direction":{"type":"string","title":"Direction","description":"INBOUND | OUTBOUND | INTERNAL"},"ref_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Id"},"ref_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Type"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["event_type","direction"],"title":"LedgerAppendBody"},"LightFuseBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did","description":"DID or address of the caller"},"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas"},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"}},"type":"object","required":["caller_did"],"title":"LightFuseBody"},"LineageVerifyRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"Agent DID to verify lineage for"},"cert_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cert Id","description":"Specific cert_id to anchor verification (uses latest if omitted)"}},"type":"object","required":["agent_did"],"title":"LineageVerifyRequest","description":"Verify the full chain for an agent: birth cert + all actions."},"LineageVerifyResponse":{"properties":{"agent_did":{"type":"string","title":"Agent Did"},"cert_id":{"type":"string","title":"Cert Id"},"chain_valid":{"type":"boolean","title":"Chain Valid"},"birth_cert_valid":{"type":"boolean","title":"Birth Cert Valid"},"action_count":{"type":"integer","title":"Action Count"},"discrepancies":{"items":{"type":"string"},"type":"array","title":"Discrepancies"},"chain":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Chain"}},"type":"object","required":["agent_did","cert_id","chain_valid","birth_cert_valid","action_count"],"title":"LineageVerifyResponse"},"LiquidateBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"LiquidateBody"},"ListBody":{"properties":{"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","title":"ListBody"},"LocationBody":{"properties":{"vertical":{"type":"string","title":"Vertical","description":"e.g. 'us_mx_remittance', 'usdpt_arb'"},"corridor":{"type":"string","title":"Corridor","description":"sub-region within vertical, e.g. 'base_mainnet/usdc'"},"topic_embedding":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Topic Embedding"}},"type":"object","required":["vertical","corridor"],"title":"LocationBody"},"LongHorizonRequest":{"properties":{"objective":{"type":"string","title":"Objective","description":"High-level objective"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Additional context"},"max_tokens":{"type":"integer","maximum":32768.0,"minimum":256.0,"title":"Max Tokens","description":"Max output tokens","default":8192}},"type":"object","required":["objective"],"title":"LongHorizonRequest","description":"200+ step deep-reasoning task request."},"LongHorizonResponse":{"properties":{"result":{"type":"string","title":"Result"},"reasoning_trace":{"items":{"type":"string"},"type":"array","title":"Reasoning Trace"},"source":{"type":"string","title":"Source"},"configured":{"type":"boolean","title":"Configured"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"steps_executed":{"type":"integer","title":"Steps Executed","default":0},"confidence":{"type":"number","title":"Confidence","default":0.0}},"type":"object","required":["result","reasoning_trace","source","configured"],"title":"LongHorizonResponse"},"LookupBody":{"properties":{"repo_url":{"type":"string","title":"Repo Url"}},"type":"object","required":["repo_url"],"title":"LookupBody"},"LossCalcAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"oracle_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oracle Did","description":"DID of the oracle"},"trigger_result":{"type":"boolean","title":"Trigger Result","description":"Must be True to proceed with loss calc"},"payout_amount_usdc":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Payout Amount Usdc","description":"Calculated payout in USDC"},"bound_notional_usdc":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Bound Notional Usdc","description":"Bound notional in USDC"},"loss_calc_result":{"additionalProperties":true,"type":"object","title":"Loss Calc Result","description":"Loss calc result: {payout_amount_usdc, calc_method, audit_trail}"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Additional loss calc metadata"}},"type":"object","required":["policy_did","trigger_result","payout_amount_usdc","loss_calc_result"],"title":"LossCalcAttestRequest","description":"Record loss calculation and payout amount."},"ManualEvaluateRequest":{"properties":{"job_id":{"type":"integer","minimum":0.0,"title":"Job Id","description":"ERC-8183 jobId (uint256)."},"provider":{"type":"string","title":"Provider","description":"Provider address (0x...)."},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment (0x-prefixed, 66 chars).","default":"0x0000000000000000000000000000000000000000000000000000000000000000"},"extra":{"additionalProperties":true,"type":"object","title":"Extra","description":"Optional extra payload merged into the job payload (e.g. {'red_flag': true})."}},"type":"object","required":["job_id","provider"],"title":"ManualEvaluateRequest"},"ManusCreateRequest":{"properties":{"message":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Message","description":"Task instruction for the Manus agent. Alias: 'prompt'. Omit to use the safe demo task."},"prompt":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Prompt","description":"Alias for 'message'."},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"hidden":{"type":"boolean","title":"Hidden","description":"Create the task hidden (default true — safe for a demo).","default":true},"share_visibility":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Visibility","description":"Optional Manus share visibility: private | unlisted | public."},"agent_profile":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Agent Profile"},"ask_followup_questions":{"type":"boolean","title":"Ask Followup Questions","description":"Default false so the demo task does not block on interactive input.","default":false}},"type":"object","title":"ManusCreateRequest"},"ManusDetailRequest":{"properties":{"task_id":{"type":"string","maxLength":256,"minLength":1,"title":"Task Id"}},"type":"object","required":["task_id"],"title":"ManusDetailRequest"},"MarketplaceListRequest":{"properties":{"shim":{"type":"string","minLength":1,"title":"Shim"},"tools":{"items":{"$ref":"#/components/schemas/MarketplaceTool"},"type":"array","title":"Tools"}},"type":"object","required":["shim"],"title":"MarketplaceListRequest"},"MarketplaceTool":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"pricing_usd":{"type":"number","title":"Pricing Usd","default":0.0},"sample_request":{"additionalProperties":true,"type":"object","title":"Sample Request"}},"type":"object","required":["name"],"title":"MarketplaceTool"},"MatchVerifyRequest":{"properties":{"po_number":{"type":"string","title":"Po Number"},"buyer_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Did"},"supplier_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Did"},"require_two_way":{"type":"boolean","title":"Require Two Way","description":"Accept PO+IR alone (skip GR)","default":false}},"type":"object","required":["po_number"],"title":"MatchVerifyRequest","description":"3-way match: PO + GR + IR. Returns the chain of receipts and whether\nthe line-item totals reconcile."},"MatchVerifyResponse":{"properties":{"po_number":{"type":"string","title":"Po Number"},"matched":{"type":"boolean","title":"Matched"},"states_present":{"items":{"$ref":"#/components/schemas/POEventType"},"type":"array","title":"States Present"},"po_total_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Po Total Cents"},"gr_total_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gr Total Cents"},"ir_total_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ir Total Cents"},"discrepancies":{"items":{"type":"string"},"type":"array","title":"Discrepancies"},"chain":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Chain"}},"type":"object","required":["po_number","matched","states_present"],"title":"MatchVerifyResponse"},"MilestoneBody":{"properties":{"contract_id":{"type":"string","title":"Contract Id"},"milestone":{"type":"string","title":"Milestone"},"fired_by_did":{"type":"string","title":"Fired By Did","default":""},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","milestone"],"title":"MilestoneBody"},"MinimumNecessaryCheckRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"patient_did_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Requested scope"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories requested"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use"},"requested_fields":{"items":{"type":"string"},"type":"array","title":"Requested Fields","description":"Policy-attribute names requested (no raw PHI)"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Check metadata: policy_hash, system_did, etc."}},"type":"object","required":["covered_entity_did","minimum_necessary_scope","purpose_of_use"],"title":"MinimumNecessaryCheckRequest","description":"Run and record a minimum-necessary determination."},"MintResponse":{"properties":{"slug":{"type":"string","title":"Slug"},"endpoint_url":{"type":"string","title":"Endpoint Url"},"record":{"additionalProperties":true,"type":"object","title":"Record"},"mint_receipt_id":{"type":"string","title":"Mint Receipt Id"},"ccacw_receipt":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ccacw Receipt"}},"type":"object","required":["slug","endpoint_url","record","mint_receipt_id"],"title":"MintResponse"},"ModelCatalogEntry":{"properties":{"model_id":{"type":"string","title":"Model Id"},"display_name":{"type":"string","title":"Display Name"},"quality_tier":{"type":"string","title":"Quality Tier"},"cost_per_1k_input":{"type":"number","title":"Cost Per 1K Input"},"cost_per_1k_output":{"type":"number","title":"Cost Per 1K Output"},"blended_cost_per_1k":{"type":"number","title":"Blended Cost Per 1K"},"provider":{"type":"string","title":"Provider"},"notes":{"type":"string","title":"Notes"}},"type":"object","required":["model_id","display_name","quality_tier","cost_per_1k_input","cost_per_1k_output","blended_cost_per_1k","provider","notes"],"title":"ModelCatalogEntry"},"MonitorRequest":{"properties":{"brand_owner_did":{"type":"string","title":"Brand Owner Did","description":"DID of the brand owner"},"mark_text":{"type":"string","maxLength":512,"minLength":1,"title":"Mark Text"},"watch_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Watch Domains"}},"type":"object","required":["brand_owner_did","mark_text"],"title":"MonitorRequest"},"MothershipIntakeBody":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID or 0x address of the arriving agent"},"need":{"type":"string","title":"Need","description":"Natural language need declaration from the agent"},"consent":{"type":"boolean","title":"Consent","description":"Agent opt-in consent (MUST be True)","default":true},"trawler_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trawler Id","description":"Trawler that attracted this agent"},"source_type":{"type":"string","title":"Source Type","description":"Source primitive: 'net' | 'pot' | 'direct'","default":"net"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id","description":"net_id or pot_id that sourced this agent"},"tip_usdc":{"type":"number","minimum":0.0,"title":"Tip Usdc","description":"Mock USDC tip/credit to open for the agent","default":0.5},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["agent_did","need"],"title":"MothershipIntakeBody"},"NetCastBody":{"properties":{"trawler_id":{"type":"string","title":"Trawler Id","description":"Parent trawler ID"},"region":{"type":"string","title":"Region","description":"Region to cover, e.g. 'github/topics/a2a-agent'"},"attractant":{"type":"string","title":"Attractant","description":"The value signal / offer text agents will see"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics","description":"Semantic topics for discovery"},"ttl_sec":{"type":"integer","maximum":2592000.0,"minimum":60.0,"title":"Ttl Sec","description":"Net lifetime in seconds (60–30d)","default":86400},"reach":{"items":{"type":"string"},"type":"array","title":"Reach","description":"Target audience DIDs or ['*']"},"viscosity":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Viscosity","description":"0=flows, 1=anchored","default":0.1},"density":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Density","description":"Drop density (breadcrumbs per unit time)","default":0.7}},"type":"object","required":["trawler_id","region","attractant"],"title":"NetCastBody"},"NotarizationType":{"type":"string","enum":["ron","ipen","traditional","remote_ink"],"title":"NotarizationType"},"NotarySessionRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did"},"seller_did":{"type":"string","title":"Seller Did"},"notary_did":{"type":"string","title":"Notary Did"},"property_id":{"type":"string","title":"Property Id"},"notarization_type":{"$ref":"#/components/schemas/NotarizationType"},"document_hashes":{"items":{"type":"string"},"type":"array","title":"Document Hashes","description":"sha256 of each document signed in the session"},"ron_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ron Session Id"},"ron_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ron Platform","description":"notarize / stewart / first_american / old_republic / proof"},"session_started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Started At"},"session_completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Completed At"},"kbai_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Kbai Passed"},"credential_analysis_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Credential Analysis Passed"},"notary_journal_entry":{"type":"string","title":"Notary Journal Entry"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","default":false}},"type":"object","required":["buyer_did","seller_did","notary_did","property_id","notarization_type","document_hashes","notary_journal_entry"],"title":"NotarySessionRequest"},"NotarySessionResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"notary_did":{"type":"string","title":"Notary Did"},"property_id":{"type":"string","title":"Property Id"},"notarization_type":{"$ref":"#/components/schemas/NotarizationType"},"document_count":{"type":"integer","title":"Document Count"},"session_hash":{"type":"string","title":"Session Hash"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["attestation_id","notary_did","property_id","notarization_type","document_count","session_hash","timestamp_iso","price_usd","receipt_envelope"],"title":"NotarySessionResponse"},"NoticeAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID notice is issued against"},"notice_type":{"type":"string","title":"Notice Type","description":"Type of notice: breach, termination_intent, renewal_opt_in, renewal_opt_out, cure, other"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Notice metadata: notice_hash, delivery_method, cure_deadline, etc."}},"type":"object","required":["contract_id","notice_type"],"title":"NoticeAttestRequest","description":"Record a formal notice (breach, termination intent, renewal opt-in/out)."},"ObserveReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"endpoint":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Endpoint"},"spend_usd":{"anyOf":[{"type":"number","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Spend Usd"},"counterparty_did":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Counterparty Did"},"size_bytes":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Size Bytes"},"proof_tier":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Proof Tier"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Jurisdiction"},"latency_ms":{"anyOf":[{"type":"number","maximum":600000.0,"minimum":0.0},{"type":"null"}],"title":"Latency Ms"},"decision":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Decision"},"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","required":["agent_did"],"title":"ObserveReq"},"OfferRequest":{"properties":{"intent_text":{"type":"string","title":"Intent Text","description":"Natural language intent from counterparty"},"counterparty_did":{"type":"string","title":"Counterparty Did","description":"DID or 0x address of counterparty"},"asks":{"items":{"$ref":"#/components/schemas/AskItem"},"type":"array","title":"Asks"},"nonce":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nonce","description":"Optional nonce; generated if omitted"}},"type":"object","required":["intent_text","counterparty_did"],"title":"OfferRequest"},"OpenBody":{"properties":{"side":{"type":"string","title":"Side","description":"long or short"},"size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Size Usdc"},"collateral_asset":{"type":"string","title":"Collateral Asset","description":"USDC or USDT"},"collateral_amount":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Collateral Amount","description":"Collateral in collateral_asset units. Defaults to 25% of size_usdc."},"owner_did":{"type":"string","title":"Owner Did","default":"did:hive:caller"},"payout_address":{"type":"string","title":"Payout Address","default":""},"rail_settlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rail Settlement Id"}},"type":"object","required":["side","size_usdc","collateral_asset"],"title":"OpenBody"},"OpenReq":{"properties":{"commitment_id":{"type":"string","maxLength":64,"minLength":4,"title":"Commitment Id"},"k":{"type":"string","maxLength":128,"minLength":1,"title":"K"}},"type":"object","required":["commitment_id","k"],"title":"OpenReq"},"OperatorSignReq":{"properties":{"envelope":{"additionalProperties":true,"type":"object","title":"Envelope","description":"Unsigned or partially-signed envelope"},"operator_signature":{"type":"string","title":"Operator Signature","description":"base64url Ed25519 signature over canonical envelope"},"operator_pubkey":{"type":"string","title":"Operator Pubkey","description":"base64url Ed25519 public key"}},"type":"object","required":["envelope","operator_signature","operator_pubkey"],"title":"OperatorSignReq"},"OracleReadingAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"oracle_did":{"type":"string","title":"Oracle Did","description":"DID of the oracle"},"oracle_reading_payload":{"additionalProperties":true,"type":"object","title":"Oracle Reading Payload","description":"Raw oracle reading payload: {windspeed_kmh:185, ts:'...', station_id:'WMO_722023'}"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Additional reading metadata"}},"type":"object","required":["policy_did","oracle_did","oracle_reading_payload"],"title":"OracleReadingAttestRequest","description":"Record a single oracle reading."},"OracleSubscribeRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"oracle_did":{"type":"string","title":"Oracle Did","description":"DID of the oracle being registered"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Oracle subscription metadata"}},"type":"object","required":["policy_did","oracle_did"],"title":"OracleSubscribeRequest","description":"Register an oracle for a policy."},"OrchestrateRequest":{"properties":{"goal":{"type":"string","title":"Goal","description":"High-level goal to accomplish"},"tools":{"items":{"type":"string"},"type":"array","title":"Tools","description":"Available tool names"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Additional context"},"max_steps":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Max Steps","description":"Maximum orchestration steps","default":50}},"type":"object","required":["goal"],"title":"OrchestrateRequest","description":"Multi-agent orchestration request."},"OrchestrateResponse":{"properties":{"plan":{"title":"Plan"},"source":{"type":"string","title":"Source"},"configured":{"type":"boolean","title":"Configured"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"steps_planned":{"type":"integer","title":"Steps Planned","default":0}},"type":"object","required":["plan","source","configured"],"title":"OrchestrateResponse"},"P2PAttestRequest":{"properties":{"pa_id":{"type":"string","title":"Pa Id","description":"pa_id of the PA under review"},"decision_id":{"type":"string","title":"Decision Id","description":"Chain pointer to the denial decision"},"p2p_outcome":{"$ref":"#/components/schemas/P2POutcomeEnum","description":"upheld / overturned / pending"},"prior_attestation_id":{"type":"string","title":"Prior Attestation Id","description":"UUID chain pointer to the decision envelope"}},"type":"object","required":["pa_id","decision_id","p2p_outcome","prior_attestation_id"],"title":"P2PAttestRequest","description":"Request to attest a peer-to-peer review."},"P2POutcomeEnum":{"type":"string","enum":["upheld","overturned","pending"],"title":"P2POutcomeEnum"},"PASubmitRequest":{"properties":{"payer_did":{"type":"string","title":"Payer Did","description":"DID of the payer (did:hive:...)"},"provider_did":{"type":"string","title":"Provider Did","description":"DID of the provider (did:hive:...)"},"member_did":{"type":"string","title":"Member Did","description":"Opaque/pseudonymous member DID — no PHI stored (did:hive:...)"},"cpt_codes":{"items":{"type":"string"},"type":"array","title":"Cpt Codes","description":"CPT procedure codes"},"icd10_codes":{"items":{"type":"string"},"type":"array","title":"Icd10 Codes","description":"ICD-10 diagnosis codes"},"clinical_doc_hash":{"type":"string","title":"Clinical Doc Hash","description":"sha256 hex of canonical clinical doc bundle — no raw document stored"},"urgency":{"$ref":"#/components/schemas/UrgencyEnum","description":"standard or expedited","default":"standard"}},"type":"object","required":["payer_did","provider_did","member_did","cpt_codes","icd10_codes","clinical_doc_hash"],"title":"PASubmitRequest","description":"Request to submit a Prior Authorization."},"PAVerifyRequest":{"properties":{"pa_id":{"type":"string","title":"Pa Id","description":"pa_id to verify"}},"type":"object","required":["pa_id"],"title":"PAVerifyRequest","description":"Request to verify a stored PA."},"POAttestRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did","description":"DID of the buying organization"},"supplier_did":{"type":"string","title":"Supplier Did","description":"DID of the supplying organization"},"po_number":{"type":"string","title":"Po Number","description":"Buyer's PO number (max 22 chars per X12 BEG03)"},"event_type":{"$ref":"#/components/schemas/POEventType"},"event_hash":{"type":"string","title":"Event Hash","description":"sha256 of the PO snapshot at this state"},"erp_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Erp System","description":"SAP / Oracle / NetSuite / Coupa / Ariba / Workday"},"erp_doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Erp Doc Id"},"sap_idoc_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sap Idoc Number"},"line_items":{"items":{"$ref":"#/components/schemas/POLineItem"},"type":"array","title":"Line Items"},"total_amount_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Total Amount Cents"},"currency":{"type":"string","maxLength":3,"minLength":3,"title":"Currency","default":"USD"},"incoterms":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incoterms","description":"EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF"},"ship_to_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ship To Location"},"bill_to_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bill To Location"},"edi_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edi Format","description":"x12 / edifact / cxml / idoc"},"edi_document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edi Document Type","description":"po / po_ack / asn / invoice / payment"},"return_edi_wrapped":{"type":"boolean","title":"Return Edi Wrapped","description":"Also wrap the receipt via hive_edi_bridge","default":false},"sender_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Id","description":"Required if return_edi_wrapped — qualifier:id"},"receiver_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receiver Id","description":"Required if return_edi_wrapped — qualifier:id"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","description":"Use Cosmic tier pricing (regulated/inspected)","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["buyer_did","supplier_did","po_number","event_type","event_hash"],"title":"POAttestRequest","description":"Attest a single PO state transition.\n\n`event_hash` is the immutable content-hash the caller wants bound to the\nreceipt (typically sha256 of the canonical JSON of the PO snapshot). This\nis what proves the buyer/supplier saw exactly the same document at this\nstate."},"POAttestResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"buyer_did":{"type":"string","title":"Buyer Did"},"supplier_did":{"type":"string","title":"Supplier Did"},"po_number":{"type":"string","title":"Po Number"},"event_type":{"$ref":"#/components/schemas/POEventType"},"event_hash":{"type":"string","title":"Event Hash"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"edi_payload":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edi Payload"},"edi_wrap_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edi Wrap Id"}},"type":"object","required":["attestation_id","buyer_did","supplier_did","po_number","event_type","event_hash","timestamp_iso","price_usd","receipt_envelope"],"title":"POAttestResponse"},"POEventType":{"type":"string","enum":["request","quote","po_issued","po_ack","asn","goods_receipt","invoice_receipt","payment","change_order","cancellation"],"title":"POEventType"},"POLineItem":{"properties":{"line_number":{"type":"integer","minimum":1.0,"title":"Line Number"},"sku":{"type":"string","title":"Sku"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"unit_of_measure":{"type":"string","title":"Unit Of Measure","description":"UN/ECE Recommendation 20 code (EA, KG, M, etc.)","default":"EA"},"unit_price_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Unit Price Cents"},"erp_part_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Erp Part Number"},"buyer_part_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Part Number"},"supplier_part_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Part Number"},"requested_delivery_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested Delivery Date"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["line_number","sku","quantity"],"title":"POLineItem"},"POVerifyResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"buyer_did":{"type":"string","title":"Buyer Did"},"supplier_did":{"type":"string","title":"Supplier Did"},"po_number":{"type":"string","title":"Po Number"},"event_type":{"$ref":"#/components/schemas/POEventType"},"event_hash":{"type":"string","title":"Event Hash"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"verification":{"additionalProperties":true,"type":"object","title":"Verification"}},"type":"object","required":["attestation_id","buyer_did","supplier_did","po_number","event_type","event_hash","timestamp_iso","receipt_envelope","verification"],"title":"POVerifyResponse"},"PassportIssueRequest":{"properties":{"action_id":{"type":"string","title":"Action Id","description":"Caller-supplied action correlation ID"},"agent_did":{"type":"string","title":"Agent Did","description":"DID of the attesting agent"},"intended_op":{"type":"string","title":"Intended Op","description":"Operation name, e.g. 'tool_invocation'"},"target_resource":{"type":"string","title":"Target Resource","description":"URI or identifier of the target"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs","description":"Declared inputs (hashed)"},"ttl_seconds":{"type":"integer","minimum":1.0,"title":"Ttl Seconds","description":"Validity window in seconds","default":300}},"type":"object","required":["action_id","agent_did","intended_op","target_resource"],"title":"PassportIssueRequest"},"PassportVerifyRequest":{"properties":{"manifest":{"additionalProperties":true,"type":"object","title":"Manifest","description":"Full passport manifest object"},"observed_inputs":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Observed Inputs","description":"Optional inputs to check against declared hash"}},"type":"object","required":["manifest"],"title":"PassportVerifyRequest"},"PatientAccessAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"patient_did_reference":{"type":"string","title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Minimum-necessary scope"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories accessed"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use","default":"patient_directed"},"authorization_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization Hash","description":"Hash of patient authorization document"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Access metadata: app_did, authorization_hash, access_type, etc."}},"type":"object","required":["covered_entity_did","patient_did_reference","minimum_necessary_scope"],"title":"PatientAccessAttestRequest","description":"Record a 21st Century Cures / USCDI patient-directed access event."},"PayBody":{"properties":{"finder_did":{"type":"string","title":"Finder Did"},"amount_usdc":{"type":"number","title":"Amount Usdc"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["finder_did","amount_usdc"],"title":"PayBody"},"PayoutAuthAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"cedent_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cedent Did","description":"DID of the cedent receiving payout"},"payout_amount_usdc":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Payout Amount Usdc","description":"Authorized payout amount in USDC"},"treasury_sub_account":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Treasury Sub Account","description":"Treasury sub-account address"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Authorization metadata"}},"type":"object","required":["policy_did","payout_amount_usdc"],"title":"PayoutAuthAttestRequest","description":"Record payout authorization (treasury sub-account)."},"PayoutBody":{"properties":{"referrer_code":{"type":"string","title":"Referrer Code"},"kind":{"type":"string","title":"Kind","description":"upfront | commission"},"amount_usdc":{"type":"number","title":"Amount Usdc"},"tx_hash":{"type":"string","title":"Tx Hash"}},"type":"object","required":["referrer_code","kind","amount_usdc","tx_hash"],"title":"PayoutBody"},"PayoutRequest":{"properties":{"btc_amount_sats":{"type":"integer","maximum":2100000000000000.0,"exclusiveMinimum":0.0,"title":"Btc Amount Sats"},"recipient_usdc_address":{"type":"string","title":"Recipient Usdc Address"}},"type":"object","required":["btc_amount_sats","recipient_usdc_address"],"title":"PayoutRequest"},"PerilClass":{"type":"string","enum":["hurricane","earthquake","wildfire","flood","hailstorm","tornado","extratropical_cyclone","drought","freeze"],"title":"PerilClass"},"PerpCloseBody":{"properties":{"position_id":{"type":"string","title":"Position Id"}},"type":"object","required":["position_id"],"title":"PerpCloseBody"},"PerpOpenBody":{"properties":{"underlying_key":{"type":"string","title":"Underlying Key","description":"agent_asset:<agent_id>"},"side":{"type":"string","title":"Side","description":"long or short"},"size_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Size Usdc"},"collateral_asset":{"type":"string","title":"Collateral Asset","description":"USDC or USDT"},"collateral_amount":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Collateral Amount"},"owner_did":{"type":"string","title":"Owner Did","default":"did:hive:caller"},"rail_settlement_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rail Settlement Id"}},"type":"object","required":["underlying_key","side","size_usdc","collateral_asset"],"title":"PerpOpenBody"},"PhiAccessAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Associate Did","description":"DID of the business associate"},"patient_did_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Minimum-necessary scope string"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories per 45 CFR §164.103"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use per 45 CFR §164.506"},"baa_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baa Reference Id","description":"BAA reference ID"},"ai_inference_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Inference Metadata","description":"AI inference metadata"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Access metadata: access_hash, system_did, access_type, etc."}},"type":"object","required":["covered_entity_did","minimum_necessary_scope","purpose_of_use"],"title":"PhiAccessAttestRequest","description":"Record a PHI access event."},"PhiDiscloseAttestRequest":{"properties":{"covered_entity_did":{"type":"string","title":"Covered Entity Did","description":"DID of the covered entity"},"business_associate_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Associate Did","description":"DID of the recipient BA"},"patient_did_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patient Did Reference","description":"Pseudonymous patient DID reference"},"minimum_necessary_scope":{"type":"string","title":"Minimum Necessary Scope","description":"Minimum-necessary scope string"},"phi_categories":{"items":{"type":"string"},"type":"array","title":"Phi Categories","description":"IIHI categories per 45 CFR §164.103"},"purpose_of_use":{"$ref":"#/components/schemas/PurposeOfUse","description":"Purpose of use per 45 CFR §164.506"},"baa_reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baa Reference Id","description":"BAA reference ID"},"recipient_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Did","description":"DID of the disclosure recipient"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Disclosure metadata: disclosure_hash, recipient_did, authorization_hash, etc."}},"type":"object","required":["covered_entity_did","minimum_necessary_scope","purpose_of_use"],"title":"PhiDiscloseAttestRequest","description":"Record a PHI disclosure event."},"PhoneHomeRequestBody":{"properties":{"waiting_for":{"type":"string","title":"Waiting For"},"cost_to_skip_usdc":{"type":"number","minimum":0.0,"title":"Cost To Skip Usdc"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["waiting_for","cost_to_skip_usdc"],"title":"PhoneHomeRequestBody"},"PhoneHomeRespondBody":{"properties":{"decision":{"type":"string","title":"Decision"},"skip_paid":{"type":"boolean","title":"Skip Paid","default":false},"caller_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caller Did"}},"type":"object","required":["decision"],"title":"PhoneHomeRespondBody"},"PhysicsOverrides":{"properties":{"distribution":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Distribution"},"density":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Density"},"depth_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depth Bytes"},"reach":{"anyOf":[{},{"type":"null"}],"title":"Reach"},"ttl_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Sec"},"viscosity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Viscosity"}},"type":"object","title":"PhysicsOverrides"},"PickupBody":{"properties":{"buyer_id":{"type":"string","title":"Buyer Id","description":"Supermodel ID (W2..W8) or external agent identifier"},"buyer_did":{"type":"string","title":"Buyer Did","description":"DID or wallet address of the buyer"}},"type":"object","required":["buyer_id","buyer_did"],"title":"PickupBody"},"PilotAcceptReq":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":4,"title":"Slug"},"accepted_by_email":{"type":"string","maxLength":320,"minLength":5,"title":"Accepted By Email"},"accepted_by_name":{"type":"string","maxLength":100,"minLength":2,"title":"Accepted By Name"},"accepted_by_title":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Accepted By Title"},"company":{"type":"string","maxLength":120,"minLength":2,"title":"Company"},"deposit_amount_usd":{"type":"integer","maximum":10000000.0,"minimum":0.0,"title":"Deposit Amount Usd"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"},"counter_signature":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Counter Signature"},"counter_pubkey":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Counter Pubkey"}},"type":"object","required":["slug","accepted_by_email","accepted_by_name","company","deposit_amount_usd"],"title":"PilotAcceptReq"},"PolicyModel":{"properties":{"tau_block":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Tau Block","default":0.18},"tau_warn":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Tau Warn","default":0.06}},"type":"object","title":"PolicyModel"},"PostOfferBody":{"properties":{"seller_id":{"type":"string","title":"Seller Id","description":"Supermodel ID or name (W2..W8 / MERCHANT..GUARDIAN)"},"title":{"type":"string","maxLength":120,"minLength":3,"title":"Title"},"description":{"type":"string","maxLength":1000,"minLength":5,"title":"Description"},"price_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Price Usdc"},"volume_cap":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Volume Cap","description":"Max units this offer can be picked up","default":1},"ttl_sec":{"anyOf":[{"type":"integer","minimum":60.0},{"type":"null"}],"title":"Ttl Sec","description":"Offer TTL in seconds (None = no expiry)"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["seller_id","title","description","price_usdc"],"title":"PostOfferBody"},"PotDropBody":{"properties":{"trawler_id":{"type":"string","title":"Trawler Id","description":"Parent trawler ID"},"location":{"type":"string","title":"Location","description":"Fixed location, e.g. 'registry:npm/@hivemorph/sdk'"},"bait_description":{"type":"string","title":"Bait Description","description":"Rich bait — what value you're dangling"},"economic_payload_usdc":{"type":"number","minimum":0.0,"title":"Economic Payload Usdc","description":"Mock USDC reward signal for agents who step aboard","default":0.5},"ttl_sec":{"type":"integer","maximum":31536000.0,"minimum":60.0,"title":"Ttl Sec","description":"Pot lifetime in seconds (60–365d)","default":604800},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["trawler_id","location","bait_description"],"title":"PotDropBody"},"PricingSetRequest":{"properties":{"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":"URL path to set price for."},"amount":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Amount","description":"New price in USD."},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier","description":"Tier label (optional; inferred from amount if omitted)."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable note."},"asset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset","description":"Optional asset filter. If provided ('USDC' or 'USDT'), updates the per-asset price for this path only — the cross-asset base price is unchanged. Useful when Tether/Circle peg spreads diverge."}},"type":"object","title":"PricingSetRequest","description":"Body for POST /v1/x402/pricing/set (also accepts query params)."},"PriorIssueRequest":{"properties":{"content_hash":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-fA-F]{64}$","title":"Content Hash","description":"SHA-256 hex digest of the disclosed invention content."},"inventor_did":{"type":"string","minLength":10,"title":"Inventor Did","description":"Inventor DID in did:hive format."},"title":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Title","description":"Optional human title for this disclosure."},"classification":{"type":"string","enum":["disclosure","singularity","uspto"],"title":"Classification","description":"Prior tier: disclosure | singularity | uspto.","default":"disclosure"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Free-form metadata dict."},"uspto_application_serial":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Uspto Application Serial","description":"USPTO application serial number. Required for uspto tier to unlock USPTO filing integration."}},"type":"object","required":["content_hash","inventor_did"],"title":"PriorIssueRequest"},"PriorIssueResponse":{"properties":{"prior_id":{"type":"string","title":"Prior Id"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"content_hash":{"type":"string","title":"Content Hash"},"inventor_did":{"type":"string","title":"Inventor Did"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"entropy_axes":{"type":"integer","title":"Entropy Axes"},"tier":{"type":"string","title":"Tier"},"price_usd_cents":{"type":"integer","title":"Price Usd Cents"}},"type":"object","required":["prior_id","receipt_envelope","content_hash","inventor_did","timestamp_iso","entropy_axes","tier","price_usd_cents"],"title":"PriorIssueResponse"},"ProfileResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"company_domain":{"type":"string","title":"Company Domain"},"brand_name":{"type":"string","title":"Brand Name"},"brand_color":{"type":"string","title":"Brand Color"},"vertical":{"type":"string","title":"Vertical"},"starter_pack":{"type":"string","title":"Starter Pack"},"tile_prefs":{"additionalProperties":true,"type":"object","title":"Tile Prefs"},"features_enabled":{"items":{"type":"string"},"type":"array","title":"Features Enabled"},"ai_wisdom_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ai Wisdom Summary"},"wisdom_generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wisdom Generated At"}},"type":"object","required":["tenant_id","company_domain","brand_name","brand_color","vertical","starter_pack","tile_prefs","features_enabled","ai_wisdom_summary","wisdom_generated_at"],"title":"ProfileResponse"},"PromoteRequest":{"properties":{"spin_session_id":{"type":"string","title":"Spin Session Id"},"tenant_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Slug"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["spin_session_id"],"title":"PromoteRequest"},"PromoteResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"vertical":{"type":"string","title":"Vertical"},"receipts_carried":{"type":"integer","title":"Receipts Carried"},"portal_url":{"type":"string","title":"Portal Url"},"promoted_at":{"type":"string","title":"Promoted At"}},"type":"object","required":["tenant_id","vertical","receipts_carried","portal_url","promoted_at"],"title":"PromoteResponse"},"ProofGenerateRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"entry_id":{"type":"string","title":"Entry Id"},"commitment_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commitment Version"},"proof_mode":{"type":"string","title":"Proof Mode","default":"standard"}},"type":"object","required":["tenant_id","entry_id"],"title":"ProofGenerateRequest"},"ProofSubmitRequest":{"properties":{"nonce":{"type":"string","title":"Nonce","description":"Nonce from the 402 PaymentRequired response."},"payer":{"type":"string","title":"Payer","description":"On-chain address of the paying account."},"chain":{"type":"string","title":"Chain","description":"'base' or 'solana'."},"tx_hash":{"type":"string","title":"Tx Hash","description":"On-chain transaction hash (Base) or signature (Solana). Validated against the chain via JSON-RPC — see proof_validator.py. Fake or unfound tx_hash returns chain_rejected; never fails open."},"amount_usd":{"type":"number","title":"Amount Usd","description":"Claimed payment amount (informational).","default":0.0},"asset":{"type":"string","title":"Asset","description":"Payment asset. 'USDC' or 'USDPT'.","default":"USDC"}},"type":"object","required":["nonce","payer","chain","tx_hash"],"title":"ProofSubmitRequest","description":"Body for POST /v1/x402/proof/submit."},"ProofVerifyRequest":{"properties":{"proof":{"additionalProperties":true,"type":"object","title":"Proof"},"commitment":{"additionalProperties":true,"type":"object","title":"Commitment"},"certificate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Certificate"}},"type":"object","required":["proof","commitment"],"title":"ProofVerifyRequest"},"PropertyDescriptor":{"properties":{"apn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apn","description":"Assessor's Parcel Number"},"address_line1":{"type":"string","title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"city":{"type":"string","title":"City"},"state":{"type":"string","maxLength":2,"minLength":2,"title":"State"},"postal_code":{"type":"string","title":"Postal Code"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"fips_state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fips State Code","description":"FIPS 5-2 state code"},"fips_county_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fips County Code","description":"FIPS 6-4 county code"},"legal_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Description"},"lot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lot"},"block":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block"},"subdivision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subdivision"}},"type":"object","required":["address_line1","city","state","postal_code"],"title":"PropertyDescriptor","description":"ALTA / MISMO-compatible property descriptor."},"ProposeRequest":{"properties":{"proposer_passport_id":{"type":"string","title":"Proposer Passport Id"},"counterparty_passport_id":{"type":"string","title":"Counterparty Passport Id"},"job_kind":{"type":"string","title":"Job Kind","default":"summarize"},"amount_micro_usdc":{"type":"integer","minimum":1.0,"title":"Amount Micro Usdc","default":500000}},"type":"object","required":["proposer_passport_id","counterparty_passport_id"],"title":"ProposeRequest"},"ProspectorReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"intent":{"type":"string","maxLength":2048,"minLength":1,"title":"Intent"},"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","required":["agent_did","intent"],"title":"ProspectorReq"},"ProtocolAttestRequest":{"properties":{"trial_id":{"type":"string","title":"Trial Id","description":"Unique trial identifier"},"attributable_did":{"type":"string","title":"Attributable Did","description":"DID of protocol author/sponsor"},"legible_format":{"type":"string","title":"Legible Format","description":"Data format","default":"JSON-LD/CDISC-SDTM"},"original_payload_hash":{"type":"string","title":"Original Payload Hash","description":"sha256 of protocol document"},"consistent_schema":{"type":"string","title":"Consistent Schema","description":"Schema URI/version","default":"CDISC-SDTM-v3.3"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Protocol metadata: title, version, amendment_number, etc."}},"type":"object","required":["trial_id","attributable_did","original_payload_hash"],"title":"ProtocolAttestRequest","description":"Record a protocol or amendment event."},"PublishRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"UUID of the asset being published"},"asset_kind":{"$ref":"#/components/schemas/AssetKindEnum","description":"image / video / audio / document"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the publisher"},"publisher_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher Did","description":"Publisher DID (alias for actor_did in publish context)"},"capture_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capture Did","description":"Origin capture DID — propagated from capture"},"editor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Editor Did","description":"Editor DID if applicable"},"media_hash":{"type":"string","title":"Media Hash","description":"sha256 hex of the published media bytes"},"c2pa_manifest_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C2Pa Manifest Hash","description":"sha256 hex of the C2PA manifest"},"ai_content_disclosure":{"type":"boolean","title":"Ai Content Disclosure","description":"Was AI used in generation or alteration?"},"prior_attestation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Attestation Id","description":"Chain pointer to the prior event (e.g. edit or capture attestation_id)"}},"type":"object","required":["asset_id","asset_kind","actor_did","media_hash","ai_content_disclosure"],"title":"PublishRequest","description":"Request to attest a publish event with chain pointer."},"PullBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did","description":"DID or address of the caller"}},"type":"object","required":["caller_did"],"title":"PullBody"},"PullReportRequest":{"properties":{"report_type":{"type":"string","title":"Report Type","description":"summary | full_ledger | compliance | usage","default":"summary"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},"type":"object","title":"PullReportRequest"},"PulseEventRequest":{"properties":{"event":{"type":"string","title":"Event"},"shim":{"type":"string","title":"Shim","default":""},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"type":"object","required":["event"],"title":"PulseEventRequest"},"PurchaseRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did","default":"did:hive:auditor"},"buyer_wallet":{"type":"string","title":"Buyer Wallet","description":"Buyer wallet address (checked against sanctions)."},"asset_requested":{"type":"string","title":"Asset Requested","default":"USDT"}},"type":"object","required":["buyer_wallet"],"title":"PurchaseRequest"},"PurityCertIssueRequest":{"properties":{"issuer_did":{"type":"string","title":"Issuer Did","description":"DID of the issuing entity (did:hive:...)"},"subject":{"$ref":"#/components/schemas/SubjectInfo","description":"Subject (produce / farm lot) details"},"substrate":{"type":"string","enum":["wave","loess","purity-24"],"title":"Substrate","description":"Substrate mode: wave (axes 1-16), loess (axes 17-24), purity-24 (all)"},"axes":{"items":{"$ref":"#/components/schemas/AxisReading"},"type":"array","maxItems":24,"minItems":1,"title":"Axes","description":"Up to 24 axis readings"},"fsma_204":{"anyOf":[{"$ref":"#/components/schemas/Fsma204Info"},{"type":"null"}],"description":"FSMA 204 KDEs (optional, present for produce/livestock)"}},"type":"object","required":["issuer_did","subject","substrate","axes"],"title":"PurityCertIssueRequest","description":"POST /v1/purity/cert/issue — issue a 24-axis Purity Receipt v3.0."},"PurityCertIssueResponse":{"properties":{"cert_id":{"type":"string","title":"Cert Id","description":"UUID of the issued certificate"},"issued_at":{"type":"string","title":"Issued At","description":"ISO-8601 issuance timestamp"},"issuer_did":{"type":"string","title":"Issuer Did"},"subject":{"additionalProperties":true,"type":"object","title":"Subject"},"substrate":{"type":"string","title":"Substrate"},"axes_summary":{"$ref":"#/components/schemas/AxesSummary"},"fsma_204_status":{"type":"string","enum":["satisfied","partial","n/a"],"title":"Fsma 204 Status","description":"FSMA 204 KDE coverage status"},"purity_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Purity Score","description":"Purity score 0-100 (100 - missing*4 - low_conf*2, floored at 0)"},"signatures":{"additionalProperties":{"type":"string"},"type":"object","title":"Signatures","description":"{ed25519: base64..., ml_dsa_65: base64...}"},"anchor_tx":{"type":"null","title":"Anchor Tx","description":"Base mainnet anchor TX — placeholder until on-chain wiring"},"verification_url":{"type":"string","title":"Verification Url","description":"https://thehiveryiq.com/verifier/?cert=<cert_id>"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Non-fatal warnings (e.g. stale readings)"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope","description":"Full SwarmReceiptIssuer envelope for downstream verification"}},"type":"object","required":["cert_id","issued_at","issuer_did","subject","substrate","axes_summary","fsma_204_status","purity_score","signatures","verification_url","receipt_envelope"],"title":"PurityCertIssueResponse","description":"Purity Receipt v3.0 — dual-signed 24-axis soil/produce certificate."},"PurposeOfUse":{"type":"string","enum":["treatment","payment","healthcare_operations","patient_directed","research_with_authorization","public_health","required_by_law","health_oversight","judicial_administrative","law_enforcement","avert_threat","specialized_government","workers_comp"],"title":"PurposeOfUse"},"QuorumCompleteBody":{"properties":{"prompt":{"type":"string","minLength":1,"title":"Prompt","description":"The prompt to send to all models."},"models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Models","description":"List of logical model IDs (from registry). Omit for all available."},"m":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"M","description":"Minimum votes for QUORUM. Defaults to ceil(N/2)+1."},"max_tokens":{"type":"integer","maximum":4096.0,"minimum":1.0,"title":"Max Tokens","description":"Max tokens per model response.","default":512},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","description":"Sampling temperature.","default":0.2},"cluster_threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Cluster Threshold","description":"Cosine similarity threshold for clustering.","default":0.78}},"type":"object","required":["prompt"],"title":"QuorumCompleteBody"},"QuorumV2ReasonBody":{"properties":{"prompt":{"type":"string","minLength":1,"title":"Prompt","description":"The reasoning problem to solve."},"max_strategies":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Max Strategies","description":"How many strategies to run (1-4). 3 skips SOLVE-AND-EXPLAIN for speed. 1 runs only self-consistency (baseline mode).","default":4}},"type":"object","required":["prompt"],"title":"QuorumV2ReasonBody"},"QuorumVerifyBody":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"A QUORUM receipt object to verify."}},"type":"object","required":["receipt"],"title":"QuorumVerifyBody"},"QuoteRequest":{"properties":{"endpoint_path":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Endpoint Path","description":"Optional HiveMorph endpoint path the caller intends to redeem the quote for (e.g. '/v1/receipt/emit'). Used to look up the price from the x402 pricing table. Mutually exclusive with amount_usdc; if both are supplied, amount_usdc wins."},"amount_usdc":{"anyOf":[{"type":"number","maximum":10000000.0,"minimum":0.0001},{"type":"null"}],"title":"Amount Usdc","description":"Optional explicit USDC amount. Overrides endpoint_path lookup."},"receipt_profile":{"type":"string","maxLength":16,"title":"Receipt Profile","description":"Receipt profile attached to the quote: nano | standard | pq.","default":"standard"},"agent_did":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Agent Did","description":"Caller agent DID. Surfaced in the receipt and audit row."},"counterparty_did":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Counterparty Did","description":"Optional payee/counterparty DID for two-sided settlement."},"hktn_tier":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}],"title":"Hktn Tier","description":"Optional explicit HKTN reputation tier override (cold|warm|hot|regulated, or legacy bronze|silver|gold|platinum|pq_eligible). When omitted, the tier is resolved from agent_did via the R5 ledger; if neither is supplied, default is Cold."},"memo":{"type":"string","maxLength":64,"title":"Memo","description":"Optional short memo (≤ 64 chars). Included in the quote payload and receipt hash. Not embedded in the ERC-681 deeplink — ERC-681 transfer URIs do not carry memos.","default":""},"regulated_envelope_jti":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Regulated Envelope Jti","description":"Required when receipt_profile='pq'. The jti of a delegation envelope (issued via /v1/delegation/issue or /operator-sign) whose allowed_surfaces includes 'pq'. Caller asserts authority; this endpoint verifies it on-the-fly."}},"type":"object","title":"QuoteRequest","description":"Body for POST /v1/x402/quote.\n\nAll fields optional — caller can ask for a generic settlement quote, or a\nquote tied to a specific HiveMorph endpoint, or a quote for a specific\nUSDC amount. Receipt profile defaults to 'standard'."},"RailSelectRequest":{"properties":{"asset":{"type":"string","title":"Asset","description":"Default settlement asset to advertise. 'USDC' or 'USDT'."}},"type":"object","required":["asset"],"title":"RailSelectRequest","description":"Body for POST /v1/x402/rails/select."},"ReadinessRequest":{"properties":{"organization_country":{"type":"string","maxLength":2,"minLength":2,"title":"Organization Country"},"users_in_eu":{"type":"boolean","title":"Users In Eu","default":false},"users_in_california":{"type":"boolean","title":"Users In California","default":false},"users_in_colorado":{"type":"boolean","title":"Users In Colorado","default":false},"users_in_uk":{"type":"boolean","title":"Users In Uk","default":false},"ai_use_categories":{"items":{"type":"string"},"type":"array","title":"Ai Use Categories"},"monthly_inference_calls":{"type":"integer","maximum":10000000000.0,"minimum":0.0,"title":"Monthly Inference Calls"},"data_categories_processed":{"items":{"type":"string"},"type":"array","title":"Data Categories Processed"},"currently_logging":{"type":"boolean","title":"Currently Logging","default":false},"logging_method":{"type":"string","enum":["application_log","siem","none","other"],"title":"Logging Method","default":"none"},"is_federal_agency":{"type":"boolean","title":"Is Federal Agency","default":false},"annual_revenue_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Annual Revenue Usd"}},"type":"object","required":["organization_country","monthly_inference_calls"],"title":"ReadinessRequest"},"ReceiptEmitReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"artifact":{"type":"string","maxLength":65536,"minLength":1,"title":"Artifact","description":"The artifact body or its sha256 hex"},"artifact_type":{"type":"string","maxLength":128,"title":"Artifact Type","default":"application/octet-stream"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"regulated_envelope_jti":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Regulated Envelope Jti","description":"Required when profile='pq'. The jti of a delegation envelope (issued via /v1/delegation/issue or operator-sign) whose allowed_surfaces includes 'pq'. Standard and nano profiles ignore this field."}},"type":"object","required":["agent_did","artifact"],"title":"ReceiptEmitReq"},"ReceiptMintBody":{"properties":{"payload":{"type":"string","maxLength":1000000,"minLength":1,"title":"Payload","description":"The payload to anchor in the receipt."},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label","description":"Optional human label."},"profile":{"type":"string","title":"Profile","description":"Receipt profile: nano, standard, or pq.","default":"pq"},"tag":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Tag","description":"Bounty/attribution tag (bounty_xxxx)."}},"type":"object","required":["payload"],"title":"ReceiptMintBody","description":"Body for /v1/receipt/mpp — same shape as existing /v1/receipt/free."},"ReceiptRequest":{"properties":{"cryptographic_hash":{"type":"string","title":"Cryptographic Hash","description":"SHA-256 (or other) content hash of the media asset"},"perceptual_hash":{"type":"string","title":"Perceptual Hash","description":"Perceptual/robust hash surviving transcode","default":""},"component_bindings":{"items":{},"type":"array","title":"Component Bindings","description":"Per-component (stem/layer/region) hash bindings"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/EvidenceIn"},{"type":"null"}]},"rights_state":{"anyOf":[{"$ref":"#/components/schemas/RightsStateIn"},{"type":"null"}]},"challenge_state":{"anyOf":[{"$ref":"#/components/schemas/ChallengeStateIn"},{"type":"null"}]},"registry_ref":{"type":"string","title":"Registry Ref","description":"Optional ledger reference","default":""}},"type":"object","required":["cryptographic_hash"],"title":"ReceiptRequest"},"ReceiptVerifyReq":{"properties":{"receipt_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Receipt Id"},"payload_sha256":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Payload Sha256"},"sig_b64u":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Sig B64U"},"iss":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Iss"},"ts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ts"}},"type":"object","title":"ReceiptVerifyReq"},"RecordingAttestRequest":{"properties":{"buyer_did":{"type":"string","title":"Buyer Did"},"seller_did":{"type":"string","title":"Seller Did"},"property_id":{"type":"string","title":"Property Id"},"deed_signed_attestation_id":{"type":"string","title":"Deed Signed Attestation Id","description":"Prior DEED_SIGNED attestation_id for chain-of-custody"},"recording_county":{"type":"string","title":"Recording County"},"recording_state":{"type":"string","maxLength":2,"minLength":2,"title":"Recording State"},"recording_status":{"$ref":"#/components/schemas/RecordingStatus"},"recording_book":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Book"},"recording_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Page"},"recording_document_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Document Number"},"recording_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recording Timestamp"},"pria_xml_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pria Xml Hash","description":"sha256 of PRIA submission XML"},"cosmic_tier":{"type":"boolean","title":"Cosmic Tier","default":false},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["buyer_did","seller_did","property_id","deed_signed_attestation_id","recording_county","recording_state","recording_status"],"title":"RecordingAttestRequest"},"RecordingAttestResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"property_id":{"type":"string","title":"Property Id"},"recording_status":{"$ref":"#/components/schemas/RecordingStatus"},"recording_county":{"type":"string","title":"Recording County"},"recording_state":{"type":"string","title":"Recording State"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["attestation_id","property_id","recording_status","recording_county","recording_state","timestamp_iso","price_usd","receipt_envelope"],"title":"RecordingAttestResponse"},"RecordingStatus":{"type":"string","enum":["pending","submitted","recorded","rejected","indexed"],"title":"RecordingStatus"},"RecoverRequest":{"properties":{"nonce":{"type":"string","title":"Nonce","description":"Nonce of a previously failed proof."},"tx_hash":{"type":"string","title":"Tx Hash","description":"On-chain tx hash to re-verify."},"payer":{"type":"string","title":"Payer","description":"Payer address (optional; carried for audit).","default":""},"chain":{"type":"string","title":"Chain","description":"'base', 'ethereum', or 'solana'.","default":"base"},"asset":{"type":"string","title":"Asset","description":"Asset of the original quote.","default":"USDC"}},"type":"object","required":["nonce","tx_hash"],"title":"RecoverRequest","description":"Body for POST /v1/x402/recover."},"RedlineAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID being redlined"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes","description":"Updated clause hashes after redline"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Redline metadata: redliner_did, change_summary, version_label, etc."}},"type":"object","required":["contract_id"],"title":"RedlineAttestRequest","description":"Record a redline/markup event on a contract."},"RegisterProviderBody":{"properties":{"agent_name":{"type":"string","maxLength":80,"minLength":2,"title":"Agent Name"},"capabilities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Capabilities"},"models":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Models"},"operator_did":{"type":"string","title":"Operator Did","default":"did:hive:qvac:operator"},"payout_address":{"type":"string","title":"Payout Address","default":"0x15184bf50b3d3f52b60434f8942b7d52f2eb436e"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"force_need":{"type":"boolean","title":"Force Need","description":"Test/admin path — assert NEED externally (RFP from /v1/bus). Without this, NEED is enforced from live bus offers.","default":false}},"type":"object","required":["agent_name","capabilities","models"],"title":"RegisterProviderBody"},"ReinsuranceSettleAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"reinsurer_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reinsurer Did","description":"DID of the reinsurer"},"carrier_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Did","description":"DID of the carrier"},"settle_amount_usdc":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Settle Amount Usdc","description":"Settlement amount in USDC"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Settlement leg metadata"}},"type":"object","required":["policy_did"],"title":"ReinsuranceSettleAttestRequest","description":"Record reinsurance settle leg."},"ReleaseRequest":{"properties":{"provider":{"type":"string","title":"Provider"},"booking_id":{"type":"string","title":"Booking Id"}},"type":"object","required":["provider","booking_id"],"title":"ReleaseRequest"},"ReminderRequest":{"properties":{"condition":{"type":"string","title":"Condition","description":"e.g. volume>1000, error_rate>5, settlement_pending>10"},"notify_email":{"type":"string","title":"Notify Email"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"}},"type":"object","required":["condition","notify_email"],"title":"ReminderRequest"},"RepEventReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"event_type":{"type":"string","maxLength":80,"minLength":1,"title":"Event Type"},"context":{"additionalProperties":true,"type":"object","title":"Context"}},"type":"object","required":["agent_did","event_type"],"title":"RepEventReq"},"RepPreviewReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"hypothetical_events":{"items":{"$ref":"#/components/schemas/HypotheticalEvent"},"type":"array","maxItems":200,"title":"Hypothetical Events"}},"type":"object","required":["agent_did"],"title":"RepPreviewReq"},"RevenueProof":{"properties":{"period":{"type":"string","title":"Period","description":"e.g. '2026-04' for April 2026"},"amount_usdc":{"type":"number","minimum":0.0,"title":"Amount Usdc"},"signature":{"type":"string","title":"Signature","description":"source-protocol signature; mocked in v0.1","default":""}},"type":"object","required":["period","amount_usdc"],"title":"RevenueProof","description":"Revenue proof. v0.2 will validate against source-protocol\nsignatures (CROO Agent Protocol, Virtuals Revenue Network, etc.)."},"RightsStateIn":{"properties":{"asserted_scope":{"items":{},"type":"array","title":"Asserted Scope"},"verified_scope":{"items":{},"type":"array","title":"Verified Scope"},"excluded_scope":{"items":{},"type":"array","title":"Excluded Scope"},"revocation_refs":{"items":{},"type":"array","title":"Revocation Refs"},"license_commitments":{"items":{},"type":"array","title":"License Commitments"}},"type":"object","title":"RightsStateIn"},"RingBellBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"RingBellBody"},"RosettaReq":{"properties":{"input":{"type":"string","maxLength":4096,"minLength":1,"title":"Input"},"locale":{"type":"string","maxLength":16,"title":"Locale","default":"en-US"},"target":{"type":"string","title":"Target","description":"canonical schema target: intent | quote | route","default":"intent"}},"type":"object","required":["input"],"title":"RosettaReq"},"RouteBody":{"properties":{"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description","description":"Free-form case description"},"amount_usd":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0,"title":"Amount Usd","description":"Disputed amount in USD"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction","description":"Optional jurisdiction preference (e.g. 'decentralized', 'optimistic', 'crowdsourced'). Used for ranking only."}},"type":"object","required":["description","amount_usd"],"title":"RouteBody"},"RouteResponse":{"properties":{"chosen_model":{"type":"string","title":"Chosen Model"},"response":{"additionalProperties":true,"type":"object","title":"Response"},"cost_usd":{"type":"number","title":"Cost Usd"},"savings_vs_baseline":{"type":"number","title":"Savings Vs Baseline"},"tier":{"type":"string","title":"Tier"},"attempts":{"items":{"type":"string"},"type":"array","title":"Attempts"},"latency_ms":{"type":"number","title":"Latency Ms"},"input_tokens":{"type":"integer","title":"Input Tokens"},"output_tokens":{"type":"integer","title":"Output Tokens"},"shape":{"type":"string","title":"Shape"}},"type":"object","required":["chosen_model","response","cost_usd","savings_vs_baseline","tier","attempts","latency_ms","input_tokens","output_tokens","shape"],"title":"RouteResponse"},"RubricReq":{"properties":{"intent":{"type":"string","maxLength":2048,"minLength":1,"title":"Intent"},"amount_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Amount Usd"},"context":{"additionalProperties":true,"type":"object","title":"Context"},"constraints":{"items":{"type":"string"},"type":"array","title":"Constraints"}},"type":"object","required":["intent"],"title":"RubricReq"},"RunRequest":{"properties":{"provider":{"type":"string","maxLength":64,"title":"Provider","description":"Adapter provider, e.g. 'mistral'.","default":"mistral"},"model":{"type":"string","maxLength":128,"title":"Model","description":"Adapter model id, e.g. 'leanstral-1-5'.","default":"leanstral-1-5"},"prompt":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}],"title":"Prompt","description":"Prompt to send. Omit to use the built-in safe demo prompt."},"max_tokens":{"type":"integer","maximum":4096.0,"minimum":1.0,"title":"Max Tokens","default":512},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","default":0.2}},"type":"object","title":"RunRequest"},"SPTBody":{"properties":{"paymentMethod":{"type":"string","title":"Paymentmethod"},"networkId":{"type":"string","title":"Networkid"},"currency":{"type":"string","title":"Currency"},"amount":{"type":"integer","title":"Amount"},"expiresAt":{"type":"integer","title":"Expiresat"},"externalId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Externalid"}},"type":"object","required":["paymentMethod","networkId","currency","amount","expiresAt"],"title":"SPTBody","description":"Body for /v1/receipt/mpp/spt — Stripe SPT creation proxy."},"SampleReceiptBody":{"properties":{"use_case":{"type":"string","maxLength":4000,"minLength":8,"title":"Use Case","description":"Describe the AI use case (e.g. 'GPT-4o reviews vendor NDAs and drafts redlines for Legal review')."},"enterprise_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Enterprise Label","description":"How your company shows up on the receipt. Defaults to 'Sample Enterprise'."},"model_family":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Model Family","description":"Which model family. Defaults to 'vendor-llm/unspecified'."},"routing_policy":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Routing Policy","description":"Routing/policy name. Defaults to 'default-strict'."}},"type":"object","required":["use_case"],"title":"SampleReceiptBody"},"SampleReceiptResponse":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"issued_at":{"type":"string","title":"Issued At"},"use_case_hash":{"type":"string","title":"Use Case Hash"},"signer_label":{"type":"string","title":"Signer Label"},"signer_pubkey":{"type":"string","title":"Signer Pubkey"},"signature_b64":{"type":"string","title":"Signature B64"},"anchor_chain":{"type":"string","title":"Anchor Chain"},"anchor_chain_id":{"type":"integer","title":"Anchor Chain Id"},"anchor_tx_hash":{"type":"string","title":"Anchor Tx Hash"},"anchor_status":{"type":"string","title":"Anchor Status"},"anchor_url":{"type":"string","title":"Anchor Url"},"pdf_url":{"type":"string","title":"Pdf Url"},"json_url":{"type":"string","title":"Json Url"},"sample_notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Notice"}},"type":"object","required":["receipt_id","issued_at","use_case_hash","signer_label","signer_pubkey","signature_b64","anchor_chain","anchor_chain_id","anchor_tx_hash","anchor_status","anchor_url","pdf_url","json_url"],"title":"SampleReceiptResponse"},"SampleRequest":{"properties":{"bytes":{"type":"integer","maximum":64.0,"minimum":16.0,"title":"Bytes","description":"Sample size in bytes (16-64)","default":32},"purpose":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Purpose","description":"Free-form purpose tag (logged)"}},"type":"object","title":"SampleRequest"},"SanctionsScreenRequest":{"properties":{"name":{"type":"string","title":"Name","description":"Full legal name of person or entity to screen"},"schema_type":{"type":"string","enum":["Person","Company","Organization","LegalEntity"],"title":"Schema Type","description":"Entity type per FollowTheMoney ontology","default":"Person"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"ISO-3166 country code (improves matching)"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold","description":"Match score threshold above which to flag","default":0.7}},"type":"object","required":["name"],"title":"SanctionsScreenRequest","description":"Pre-action sanctions/PEP screening — gate decision before any USDC transfer or counterparty onboarding.\n\nReal rail: proxies OpenSanctions consolidated dataset (OFAC SDN, EU, UK HMT, UN, PEPs, debarment)."},"SandboxRunReq":{"properties":{"jti":{"type":"string","title":"Jti"},"request":{"additionalProperties":true,"type":"object","title":"Request"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"type":"object","required":["jti"],"title":"SandboxRunReq"},"SavingsResponse":{"properties":{"calls_routed":{"type":"integer","title":"Calls Routed"},"calls_failed":{"type":"integer","title":"Calls Failed"},"total_cost_usd":{"type":"number","title":"Total Cost Usd"},"total_savings_usd":{"type":"number","title":"Total Savings Usd"},"avg_cost_reduction_pct":{"type":"number","title":"Avg Cost Reduction Pct"},"baseline_model":{"type":"string","title":"Baseline Model"}},"type":"object","required":["calls_routed","calls_failed","total_cost_usd","total_savings_usd","avg_cost_reduction_pct","baseline_model"],"title":"SavingsResponse"},"ScanRequest":{"properties":{"analyst_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analyst Id","description":"Specific analyst_id; otherwise the default analyst runs."},"seed_if_empty":{"type":"boolean","title":"Seed If Empty","description":"If true and no findings yet, seed 5 mock findings before scanning.","default":true}},"type":"object","title":"ScanRequest"},"ScheduleRequest":{"properties":{"frequency":{"type":"string","title":"Frequency","description":"daily | weekly","default":"daily"},"email":{"type":"string","title":"Email"},"time_utc":{"type":"string","title":"Time Utc","description":"HH:MM UTC","default":"09:00"},"report_type":{"type":"string","title":"Report Type","default":"summary"}},"type":"object","required":["email"],"title":"ScheduleRequest"},"ScoopBody":{"properties":{"finder_did":{"type":"string","title":"Finder Did"},"micro_fee_usdc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Micro Fee Usdc"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["finder_did"],"title":"ScoopBody"},"ScoreRequest":{"properties":{"spans":{"items":{"$ref":"#/components/schemas/SpanModel"},"type":"array","minItems":1,"title":"Spans"},"output":{"type":"string","maxLength":128000,"minLength":1,"title":"Output"},"embedding_model_id":{"type":"string","title":"Embedding Model Id","default":"tfidf-deterministic-v1"},"policy":{"$ref":"#/components/schemas/PolicyModel"}},"type":"object","required":["spans","output"],"title":"ScoreRequest"},"SealRequest":{"properties":{"session_id":{"type":"string","title":"Session Id","default":""},"segment_receipts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Segment Receipts","description":"ordered list of segment receipts to seal"},"declared_budget_us":{"type":"number","title":"Declared Budget Us","default":100.0},"session_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Session Metadata"}},"type":"object","required":["segment_receipts"],"title":"SealRequest"},"SealedParentIn":{"properties":{"content_commitment":{"type":"string","title":"Content Commitment","description":"Fingerprint of the parent media (Hive never sees content)","default":""},"boundaries":{"items":{"$ref":"#/components/schemas/BoundaryIn"},"type":"array","title":"Boundaries","description":"Boundary map sealed at capture"},"origin_attestation":{"type":"string","title":"Origin Attestation","description":"Origin attestation string sealed at capture","default":""},"capture_meta":{"type":"string","title":"Capture Meta","description":"Capture metadata sealed at capture","default":""},"extent":{"type":"number","title":"Extent","description":"Total extent (seconds/units) of the parent","default":0}},"type":"object","title":"SealedParentIn"},"SegmentRequest":{"properties":{"session_id":{"type":"string","title":"Session Id","description":"session this segment belongs to"},"sequence":{"type":"integer","title":"Sequence","description":"0-based segment index within the session"},"role":{"type":"string","title":"Role","description":"model-side | counterparty-side | system-side"},"content_hash":{"type":"string","title":"Content Hash","description":"hash of the segment content (audio/tokens)"},"started_at_us":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Started At Us"},"ended_at_us":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ended At Us"},"sign_latency_us":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sign Latency Us","description":"off-path signing latency for this segment (µs)"},"transcript_commitment":{"type":"string","title":"Transcript Commitment","default":""},"continuity":{"anyOf":[{"$ref":"#/components/schemas/ContinuityIn"},{"type":"null"}]},"prior_commit":{"type":"string","title":"Prior Commit","default":""}},"type":"object","required":["session_id","sequence","role","content_hash"],"title":"SegmentRequest"},"SelfTuneTickBody":{"properties":{"claims_resolved_last_hour":{"type":"integer","minimum":0.0,"title":"Claims Resolved Last Hour","default":0},"arb_queue_depth":{"type":"integer","minimum":0.0,"title":"Arb Queue Depth","default":0},"arb_queue_normal":{"type":"integer","minimum":1.0,"title":"Arb Queue Normal","default":2},"false_positive_count":{"type":"integer","minimum":0.0,"title":"False Positive Count","default":0},"total_signals":{"type":"integer","minimum":0.0,"title":"Total Signals","default":0}},"type":"object","title":"SelfTuneTickBody"},"SendBody":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"token":{"type":"string","title":"Token"},"chain":{"type":"string","title":"Chain"},"to":{"type":"string","title":"To"}},"type":"object","required":["amount","token","chain","to"],"title":"SendBody"},"SettleRequestBody":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"settlement_tx_hash":{"type":"string","title":"Settlement Tx Hash"}},"type":"object","required":["receipt_id","settlement_tx_hash"],"title":"SettleRequestBody"},"SettlementEnvelope":{"properties":{"sha3_256":{"type":"string","title":"Sha3 256"},"ed25519_signature":{"type":"string","title":"Ed25519 Signature"},"mldsa65_signature":{"type":"string","title":"Mldsa65 Signature"},"sphere_tier":{"type":"string","title":"Sphere Tier"},"sphere_cost_usd":{"type":"number","title":"Sphere Cost Usd"},"anchor_tx":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Anchor Tx"},"anchor_chain":{"type":"string","title":"Anchor Chain"},"verifier_url":{"type":"string","title":"Verifier Url"}},"type":"object","required":["sha3_256","ed25519_signature","mldsa65_signature","sphere_tier","sphere_cost_usd","anchor_chain","verifier_url"],"title":"SettlementEnvelope"},"SignBody":{"properties":{"tenant_did":{"type":"string","maxLength":256,"minLength":3,"title":"Tenant Did"},"prompt":{"type":"string","maxLength":64000,"minLength":1,"title":"Prompt"},"response":{"type":"string","maxLength":200000,"minLength":1,"title":"Response"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"amplify":{"type":"boolean","title":"Amplify","default":true},"skip_writeback":{"type":"boolean","title":"Skip Writeback","default":false},"partner_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Partner Id"},"counterparty_did":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Counterparty Did"},"price_atomic":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Price Atomic"}},"type":"object","required":["tenant_did","prompt","response"],"title":"SignBody"},"SignDiffRequest":{"properties":{"repo":{"type":"string","maxLength":120,"minLength":3,"title":"Repo","description":"owner/repo, e.g. 'srotzin/hivemorph'"},"pr_number":{"type":"integer","minimum":0.0,"title":"Pr Number","description":"0 if signing a non-PR diff"},"diff":{"type":"string","maxLength":200000,"minLength":1,"title":"Diff","description":"The unified diff content (max 200k chars)"},"base_sha":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Base Sha","description":"Base commit sha"},"head_sha":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Head Sha","description":"Head commit sha"}},"type":"object","required":["repo","pr_number","diff"],"title":"SignDiffRequest"},"SignRequest":{"properties":{"message_b64":{"type":"string","title":"Message B64","description":"Base64-encoded message to sign"},"sk_b64":{"type":"string","title":"Sk B64","description":"Base64-encoded ML-DSA-65 secret key"}},"type":"object","required":["message_b64","sk_b64"],"title":"SignRequest"},"SignResponse":{"properties":{"signature_b64":{"type":"string","title":"Signature B64"},"alg":{"type":"string","title":"Alg"},"fips":{"type":"string","title":"Fips"},"backend":{"type":"string","title":"Backend"},"sig_bytes":{"type":"integer","title":"Sig Bytes"}},"type":"object","required":["signature_b64","alg","fips","backend","sig_bytes"],"title":"SignResponse"},"SignalBody":{"properties":{"tx_id":{"type":"string","title":"Tx Id","description":"Transaction hash being observed"},"source_id":{"type":"string","title":"Source Id","description":"Unique identifier for this signal source"},"source_type":{"type":"string","title":"Source Type","description":"SignalSource enum value"},"proof_type":{"type":"string","title":"Proof Type","description":"ProofType enum value"},"tx_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tx Status","description":"0=reverted, 1=confirmed/sent"},"dest_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dest Confirmed","description":"Bridge: did tx arrive at destination?"},"raw_evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Evidence","description":"Any additional evidence payload"},"observer_type":{"type":"string","title":"Observer Type","description":"Observer type that generated this signal","default":"hiveclear_observer"}},"type":"object","required":["tx_id","source_id","source_type","proof_type"],"title":"SignalBody"},"SignatureAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID being signed"},"signer_did":{"type":"string","title":"Signer Did","description":"DID of the party signing"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Signature metadata: signature_method, signature_hash, timestamp, etc."}},"type":"object","required":["contract_id","signer_did"],"title":"SignatureAttestRequest","description":"Record a single-party signature event."},"SignupRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id","description":"Unique tenant identifier"},"company_domain":{"type":"string","title":"Company Domain","description":"Primary domain, e.g. netskope.com"},"email":{"type":"string","title":"Email","description":"Admin contact email"}},"type":"object","required":["tenant_id","company_domain","email"],"title":"SignupRequest"},"SignupResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"vertical_detected":{"type":"string","title":"Vertical Detected"},"starter_pack":{"type":"string","title":"Starter Pack"},"brand_color_hint":{"type":"string","title":"Brand Color Hint"},"brand_name_hint":{"type":"string","title":"Brand Name Hint"}},"type":"object","required":["tenant_id","vertical_detected","starter_pack","brand_color_hint","brand_name_hint"],"title":"SignupResponse"},"SiteSyncRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"site_id":{"type":"string","maxLength":128,"minLength":1,"title":"Site Id"},"batch_ts":{"type":"integer","exclusiveMinimum":0.0,"title":"Batch Ts"},"telemetry":{"additionalProperties":true,"type":"object","title":"Telemetry"}},"type":"object","required":["operator_did","site_id","batch_ts"],"title":"SiteSyncRequest"},"SlashBody":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["agent_id","reason"],"title":"SlashBody"},"SmshVerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"SMSH-Stamp v1 receipt object"},"pubkey_b64url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pubkey B64Url","description":"Override trust anchor Ed25519 public key (base64url, 32 bytes)"},"max_age_seconds":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Age Seconds","description":"Reject receipts older than this many seconds"}},"type":"object","required":["receipt"],"title":"SmshVerifyRequest"},"SnipBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"SnipBody"},"SosFulfillBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"SosFulfillBody"},"SosRequestBody":{"properties":{"needed_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Needed Usdc"},"deadline_sec":{"type":"integer","exclusiveMinimum":0.0,"title":"Deadline Sec"},"reward_share_bps":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Reward Share Bps"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"}},"type":"object","required":["needed_usdc","deadline_sec","reward_share_bps"],"title":"SosRequestBody"},"SpanModel":{"properties":{"text":{"type":"string","maxLength":32000,"minLength":1,"title":"Text"},"label":{"type":"string","maxLength":64,"title":"Label","default":"PUBLIC"}},"type":"object","required":["text"],"title":"SpanModel"},"SpawnFromProposalRequest":{"properties":{"parent_id":{"type":"string","title":"Parent Id","description":"W2..W8 (or MERCHANT..GUARDIAN) the proposal targets."},"signal":{"type":"string","title":"Signal","description":"Signal that produced this proposal, e.g. 'S1_VERTICAL_PRESSURE'."},"action":{"type":"string","title":"Action","description":"Proposal action; only 'spawn' is honored here.","default":"spawn"},"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas","description":"Kit deltas to apply on top of the parent baseline."},"rationale":{"type":"string","title":"Rationale","description":"Plain-language reason from the monitor.","default":""},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day","description":"Estimated USDC/day lift if approved and promoted."},"variant_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Label","description":"Optional human-readable label suffix; auto-generated if omitted."}},"type":"object","required":["parent_id","signal"],"title":"SpawnFromProposalRequest","description":"Body for POST /v1/morph/brood/spawn-from-proposal.\n\nMirrors the shape emitted by spawn_monitor.scan_signals(): an operator\nlooks at the read-only proposals from the :33 ROI Radar cron, decides\none is worth staging, and posts the proposal back here. The variant lands\nas 'proposed' — NEVER auto-approved — so the human approval gate stays on."},"SpawnRequest":{"properties":{"kit_deltas":{"additionalProperties":true,"type":"object","title":"Kit Deltas","description":"Per-variant overrides: tagline, motto, voice, sigil, palette_hex, lead_shape, lead_price_usdc, etc."},"spawn_trigger":{"type":"string","title":"Spawn Trigger","description":"Why this variant was spawned (e.g. 'manual', 'monitor:vertical_pressure')","default":"manual"},"variant_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Label","description":"Optional human-readable label suffix; auto-generated if omitted"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale","description":"Why this variant was suggested (free-form). Persisted on the variant row."},"predicted_lift_usdc_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Lift Usdc Per Day","description":"Predicted incremental USDC/day if this variant is approved."}},"type":"object","title":"SpawnRequest"},"SpinStartRequest":{"properties":{"vertical":{"type":"string","title":"Vertical","description":"One of: banking, healthcare, construction, agent-payments, real-estate, ai-compliance","default":"banking"},"sample_size":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Sample Size","description":"Number of sample receipts to pre-generate","default":5}},"type":"object","title":"SpinStartRequest"},"SpinStartResponse":{"properties":{"spin_session_id":{"type":"string","title":"Spin Session Id"},"vertical":{"type":"string","title":"Vertical"},"vertical_config":{"additionalProperties":true,"type":"object","title":"Vertical Config"},"receipts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Receipts"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["spin_session_id","vertical","vertical_config","receipts","created_at"],"title":"SpinStartResponse"},"StakesClassifyRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt"},"vertical":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vertical"},"rules_stakes_tier":{"type":"string","enum":["volume","mid","premium"],"title":"Rules Stakes Tier","default":"volume"},"monthly_estimate":{"type":"integer","title":"Monthly Estimate","default":0}},"type":"object","required":["prompt"],"title":"StakesClassifyRequest"},"StakesClassifyResponse":{"properties":{"stakes_tier":{"type":"string","enum":["volume","mid","premium"],"title":"Stakes Tier"},"confidence":{"type":"number","title":"Confidence"},"reasoning":{"type":"string","title":"Reasoning"},"method":{"type":"string","enum":["live_ink_quorum","rules_only"],"title":"Method"},"agreement":{"type":"string","enum":["unanimous_with_rules","majority_overrides_rules","quorum_overrides_rules","no_consensus","not_evaluated"],"title":"Agreement"},"votes":{"items":{"$ref":"#/components/schemas/Vote"},"type":"array","title":"Votes"},"rules_stakes_tier":{"type":"string","enum":["volume","mid","premium"],"title":"Rules Stakes Tier"},"rules_disagrees":{"type":"boolean","title":"Rules Disagrees"},"effective_stakes_tier":{"type":"string","enum":["volume","mid","premium"],"title":"Effective Stakes Tier"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["stakes_tier","confidence","reasoning","method","agreement","votes","rules_stakes_tier","rules_disagrees","effective_stakes_tier","generated_at"],"title":"StakesClassifyResponse"},"SubjectInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Product / crop name"},"lot":{"type":"string","title":"Lot","description":"Lot / batch identifier"},"farm_id":{"type":"string","title":"Farm Id","description":"Farm or growing-operation identifier"},"growing_area":{"items":{"type":"number"},"type":"array","maxItems":2,"minItems":2,"title":"Growing Area","description":"[latitude, longitude] decimal degrees"},"harvest_date":{"type":"string","title":"Harvest Date","description":"ISO-8601 harvest date"}},"type":"object","required":["name","lot","farm_id","growing_area","harvest_date"],"title":"SubjectInfo","description":"Subject (produce / farm lot) being certified."},"SwapBody":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"token_in":{"type":"string","title":"Token In"},"token_out":{"type":"string","title":"Token Out"},"chain":{"type":"string","title":"Chain"}},"type":"object","required":["amount","token_in","token_out","chain"],"title":"SwapBody"},"SweepBody":{"properties":{"dry_run":{"type":"boolean","title":"Dry Run","description":"Plan only — do not record","default":true},"broadcast":{"type":"boolean","title":"Broadcast","description":"Broadcast on-chain (requires EARN_SWEEP_AUTODISPATCH=true)","default":false},"threshold_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold Usd","description":"Override default $1.00 threshold"}},"type":"object","title":"SweepBody"},"SyndicateRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"UUID of the asset being syndicated"},"asset_kind":{"$ref":"#/components/schemas/AssetKindEnum","description":"image / video / audio / document"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the syndication partner"},"publisher_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher Did","description":"Original publisher DID"},"capture_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capture Did","description":"Origin capture DID"},"editor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Editor Did","description":"Editor DID if applicable"},"media_hash":{"type":"string","title":"Media Hash","description":"sha256 hex of the media bytes"},"c2pa_manifest_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C2Pa Manifest Hash","description":"sha256 hex of the C2PA manifest"},"ai_content_disclosure":{"type":"boolean","title":"Ai Content Disclosure","description":"Was AI used in generation or alteration?"},"prior_attestation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Attestation Id","description":"Chain pointer to the publish attestation_id"}},"type":"object","required":["asset_id","asset_kind","actor_did","media_hash","ai_content_disclosure"],"title":"SyndicateRequest","description":"Request to attest a syndication with chain pointer to publish."},"TakedownRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"UUID of the asset being taken down"},"asset_kind":{"$ref":"#/components/schemas/AssetKindEnum","description":"image / video / audio / document"},"actor_did":{"type":"string","title":"Actor Did","description":"DID of the party issuing the takedown"},"publisher_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher Did","description":"Original publisher DID"},"capture_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capture Did","description":"Origin capture DID"},"editor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Editor Did","description":"Editor DID if applicable"},"media_hash":{"type":"string","title":"Media Hash","description":"sha256 hex of the media bytes"},"c2pa_manifest_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"C2Pa Manifest Hash","description":"sha256 hex of the C2PA manifest"},"ai_content_disclosure":{"type":"boolean","title":"Ai Content Disclosure","description":"Was AI used in generation or alteration?"},"prior_attestation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prior Attestation Id","description":"Chain pointer to the publish attestation_id"}},"type":"object","required":["asset_id","asset_kind","actor_did","media_hash","ai_content_disclosure"],"title":"TakedownRequest","description":"Request to attest a takedown with chain pointer to publish."},"TaxBulkBody":{"properties":{"tx_hashes":{"items":{"type":"string"},"type":"array","title":"Tx Hashes","description":"Array of transaction hashes/signatures"},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana"}},"type":"object","required":["tx_hashes","chain"],"title":"TaxBulkBody"},"TaxEventBody":{"properties":{"tx_hash":{"type":"string","title":"Tx Hash","description":"Transaction hash (EVM) or signature (Solana)"},"chain":{"type":"string","title":"Chain","description":"base | ethereum | solana"}},"type":"object","required":["tx_hash","chain"],"title":"TaxEventBody"},"TelemetryRequest":{"properties":{"site_did":{"type":"string","maxLength":512,"minLength":10,"title":"Site Did"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"Signed telemetry payload. Recommended fields: hashrate_ths (float), health (str), temp_c (float), energy_kwh (float), workers (list[dict]). All fields are optional; include what the MOS SDK exposes."}},"type":"object","required":["site_did"],"title":"TelemetryRequest","description":"Body for POST /v1/mos/intel/telemetry."},"TerminationAttestRequest":{"properties":{"contract_id":{"type":"string","title":"Contract Id","description":"Contract ID being terminated"},"parties":{"items":{"$ref":"#/components/schemas/ContractParty"},"type":"array","title":"Parties"},"clause_hashes":{"items":{"$ref":"#/components/schemas/ClauseHash"},"type":"array","title":"Clause Hashes"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Termination metadata: termination_reason, effective_date, for_cause, etc."}},"type":"object","required":["contract_id"],"title":"TerminationAttestRequest","description":"Record contract termination."},"TilePrefRequest":{"properties":{"tile_key":{"type":"string","title":"Tile Key","description":"Tile identifier key"},"exposed":{"type":"boolean","title":"Exposed","description":"Whether tile is shown to tenant users"},"public":{"type":"boolean","title":"Public","description":"Whether tile is publicly visible"}},"type":"object","required":["tile_key","exposed","public"],"title":"TilePrefRequest"},"TipJarBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"},"parent_receipt_hash":{"type":"string","title":"Parent Receipt Hash"}},"type":"object","required":["caller_did","amount_usdc","parent_receipt_hash"],"title":"TipJarBody"},"ToolSpec":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"trust_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Trust Score"}},"type":"object","required":["name"],"title":"ToolSpec"},"TopOffCompleteBody":{"properties":{"actual_burn_usdc":{"type":"number","minimum":0.0,"title":"Actual Burn Usdc"}},"type":"object","required":["actual_burn_usdc"],"title":"TopOffCompleteBody"},"TopOffFulfillBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"},"amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["caller_did","amount_usdc"],"title":"TopOffFulfillBody"},"TopOffRequestBody":{"properties":{"needed_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Needed Usdc"},"reason":{"type":"string","title":"Reason"},"parent_receipt_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Receipt Hash"},"refund_unused":{"type":"boolean","title":"Refund Unused","default":true}},"type":"object","required":["needed_usdc","reason"],"title":"TopOffRequestBody"},"TopupIntentRequest":{"properties":{"account_id":{"type":"string","title":"Account Id"},"chain":{"type":"string","title":"Chain","description":"One of: base, ethereum"},"amount_cents":{"type":"integer","minimum":1000.0,"title":"Amount Cents","description":"Amount to top up in USD cents. Minimum 1000 ($10.00)."}},"type":"object","required":["account_id","chain","amount_cents"],"title":"TopupIntentRequest"},"TradeAttestRequest":{"properties":{"trader_did":{"type":"string","minLength":10,"title":"Trader Did","description":"Trader DID in did:hive format."},"firm_did":{"type":"string","minLength":10,"title":"Firm Did","description":"Firm DID in did:hive format (Citadel, Virtu, etc.)"},"algo_id":{"type":"string","maxLength":128,"minLength":1,"title":"Algo Id","description":"Firm-controlled algo identifier."},"order_event_hash":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-fA-F]{64}$","title":"Order Event Hash","description":"SHA-256 hex digest of the FINRA CAT order/trade event payload."},"event_type":{"type":"string","enum":["order_new","order_modify","order_cancel","order_route","order_route_modify","order_route_cancel","trade_execution","trade_break","trade_correction","algo_decision"],"title":"Event Type","description":"FINRA CAT event type."},"venue":{"type":"string","enum":["NYSE","NASDAQ","ARCA","BATS","IEX","EDGX","EDGA","BYX","BX","PSX","MEMX","MIAX","OTHER"],"title":"Venue","description":"Reporting venue (CAT reportable)."},"symbol":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Symbol","description":"Ticker symbol."},"side":{"anyOf":[{"type":"string","enum":["buy","sell","sell_short"]},{"type":"null"}],"title":"Side"},"quantity":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Quantity","description":"Order/trade quantity (shares)."},"price_cents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Price Cents","description":"Order/trade price in USD cents."},"parent_order_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Parent Order Id","description":"Parent CAT order id."},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Free-form metadata dict."}},"type":"object","required":["trader_did","firm_did","algo_id","order_event_hash","event_type","venue"],"title":"TradeAttestRequest"},"TradeAttestResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"trader_did":{"type":"string","title":"Trader Did"},"firm_did":{"type":"string","title":"Firm Did"},"algo_id":{"type":"string","title":"Algo Id"},"order_event_hash":{"type":"string","title":"Order Event Hash"},"event_type":{"type":"string","title":"Event Type"},"venue":{"type":"string","title":"Venue"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"price_usd":{"type":"number","title":"Price Usd"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"}},"type":"object","required":["attestation_id","trader_did","firm_did","algo_id","order_event_hash","event_type","venue","timestamp_iso","price_usd","receipt_envelope"],"title":"TradeAttestResponse"},"TransferRequest":{"properties":{"from_did":{"type":"string","title":"From Did","description":"Sender DID, e.g. did:hive:treasury:0x..."},"to_did":{"type":"string","title":"To Did","description":"Recipient DID"},"asset":{"type":"string","title":"Asset","description":"Asset symbol (USDC / USDT / EURC / PYUSD)"},"chain":{"type":"string","title":"Chain","description":"Settlement chain","default":"base-8453"},"amount":{"type":"string","title":"Amount","description":"Amount as decimal string, e.g. '100000.00'"},"purpose":{"type":"string","maxLength":64,"title":"Purpose","default":"trade-settlement"},"jurisdiction_pair":{"items":{"type":"string"},"type":"array","title":"Jurisdiction Pair"},"compliance_controls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Compliance Controls","description":"Override default 4 controls. None means use defaults."},"memo":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Memo"},"sphere_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sphere Override","description":"Force a specific Sphere tier; otherwise auto-selected by amount."}},"type":"object","required":["from_did","to_did","asset","amount"],"title":"TransferRequest"},"TransferResponse":{"properties":{"transfer_id":{"type":"string","title":"Transfer Id"},"status":{"type":"string","enum":["settled","rejected"],"title":"Status"},"submitted_at":{"type":"string","title":"Submitted At"},"settled_at":{"type":"string","title":"Settled At"},"wall_clock_ms":{"type":"number","title":"Wall Clock Ms"},"off_chain_ms":{"type":"number","title":"Off Chain Ms"},"on_chain_ms":{"type":"number","title":"On Chain Ms"},"transfer":{"$ref":"#/components/schemas/TransferRequest"},"compliance_bundle":{"$ref":"#/components/schemas/ComplianceBundle"},"settlement_envelope":{"$ref":"#/components/schemas/SettlementEnvelope"},"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rejection Reason"}},"type":"object","required":["transfer_id","status","submitted_at","settled_at","wall_clock_ms","off_chain_ms","on_chain_ms","transfer","compliance_bundle","settlement_envelope"],"title":"TransferResponse"},"TrawlerLaunchBody":{"properties":{"operator_did":{"type":"string","title":"Operator Did","description":"DID or 0x address of the operator launching this trawler"},"label":{"type":"string","title":"Label","description":"Human-readable label for this trawler","default":""},"config":{"additionalProperties":true,"type":"object","title":"Config","description":"Trawler config: net_regions[], pot_locations[], net_ttl_sec, pot_ttl_sec, net_budget, pot_budget, attractant, bait, economic_payload_usdc"}},"type":"object","required":["operator_did"],"title":"TrawlerLaunchBody"},"TriggerEvalAttestRequest":{"properties":{"policy_did":{"type":"string","title":"Policy Did","description":"DID of the policy"},"oracle_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oracle Did","description":"DID of the oracle"},"oracle_reading_payload":{"additionalProperties":true,"type":"object","title":"Oracle Reading Payload","description":"Oracle reading payload to evaluate"},"threshold_spec":{"additionalProperties":true,"type":"object","title":"Threshold Spec","description":"Threshold specification to evaluate against"},"event_payload":{"additionalProperties":true,"type":"object","title":"Event Payload","description":"Additional evaluation metadata"}},"type":"object","required":["policy_did","oracle_reading_payload","threshold_spec"],"title":"TriggerEvalAttestRequest","description":"Evaluate threshold against oracle reading and record result."},"TripBody":{"properties":{"caller_did":{"type":"string","title":"Caller Did"}},"type":"object","required":["caller_did"],"title":"TripBody"},"USDCIntentRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"tier":{"type":"string","title":"Tier"}},"type":"object","required":["tenant_id","tier"],"title":"USDCIntentRequest"},"UnsealRequest":{"properties":{"sealed_view":{"additionalProperties":true,"type":"object","title":"Sealed View"},"mlkem_secret_b64":{"type":"string","title":"Mlkem Secret B64"},"x25519_secret_b64":{"type":"string","title":"X25519 Secret B64"}},"type":"object","required":["sealed_view","mlkem_secret_b64","x25519_secret_b64"],"title":"UnsealRequest"},"UrgencyEnum":{"type":"string","enum":["standard","expedited"],"title":"UrgencyEnum"},"UtilityPriceBody":{"properties":{"site_did":{"type":"string","title":"Site Did","description":"Site DID (must be registered via /v1/mos/intel/register)"},"rate_usd_per_kwh":{"type":"number","exclusiveMinimum":0.0,"title":"Rate Usd Per Kwh","description":"Current electricity rate in USD per kWh"},"kwh_per_hour":{"type":"number","exclusiveMinimum":0.0,"title":"Kwh Per Hour","description":"Site's current power draw in kWh/hour"},"hashrate_th_s":{"type":"number","exclusiveMinimum":0.0,"title":"Hashrate Th S","description":"Current site hashrate in TH/s"},"effective_ts":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Effective Ts","description":"Unix timestamp this rate is effective from. Defaults to now."},"site_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Site Signature","description":"Optional DID-signed nonce for payload integrity (verification stub in v0.1)."}},"type":"object","required":["site_did","rate_usd_per_kwh","kwh_per_hour","hashrate_th_s"],"title":"UtilityPriceBody","description":"POST /v1/mos/energy-arb/utility-price\n\nThe site operator pushes their current electricity rate. In v0.1 this is a\nmanual push; v0.2 will integrate automatic utility API polling."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VectorEntry":{"properties":{"k":{"type":"string","maxLength":128,"minLength":1,"title":"K"},"s":{"type":"number","maximum":1.0,"minimum":0.0,"title":"S"}},"type":"object","required":["k","s"],"title":"VectorEntry"},"VectorRequest":{"properties":{"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id","description":"Existing group to compute a vector for."},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label"},"receipts":{"items":{},"type":"array","title":"Receipts","description":"Inline receipts and/or IDs (used when group_id is not given)."},"receipt_ids":{"items":{"type":"string"},"type":"array","title":"Receipt Ids"},"graph":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Graph"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"persist":{"type":"boolean","title":"Persist","description":"If true (and no group_id given), persist the group so the vector is reproducible.","default":true}},"type":"object","title":"VectorRequest"},"VerifyBody":{"properties":{"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"signature_b64":{"type":"string","minLength":8,"title":"Signature B64"},"pubkey_b64":{"type":"string","minLength":8,"title":"Pubkey B64"},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response"}},"type":"object","required":["payload","signature_b64","pubkey_b64"],"title":"VerifyBody"},"VerifyRequestBody":{"properties":{"envelope":{"additionalProperties":true,"type":"object","title":"Envelope"}},"type":"object","required":["envelope"],"title":"VerifyRequestBody"},"VerifySelectionRequest":{"properties":{"proof":{"title":"Proof","description":"Groth16 envelope from /solve.proof_envelope"},"public_inputs":{"items":{},"type":"array","title":"Public Inputs","description":"From /solve.proof_public_inputs"}},"type":"object","required":["proof","public_inputs"],"title":"VerifySelectionRequest"},"VisitEvent":{"properties":{"slug":{"type":"string","maxLength":64,"minLength":4,"title":"Slug"},"u":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"U","description":"?u= tag from URL — primary or fallback identity"},"visitor_session":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Visitor Session","description":"random ID from sessionStorage"},"referrer":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Referrer"},"event":{"type":"string","pattern":"^(open|dwell|scroll|close)$","title":"Event","default":"open"},"dwell_s":{"anyOf":[{"type":"integer","maximum":86400.0,"minimum":0.0},{"type":"null"}],"title":"Dwell S"},"scroll_pct":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Scroll Pct"},"ua":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Ua"}},"type":"object","required":["slug"],"title":"VisitEvent"},"Vote":{"properties":{"model":{"type":"string","title":"Model"},"stakes_tier":{"anyOf":[{"type":"string","enum":["volume","mid","premium"]},{"type":"null"}],"title":"Stakes Tier"},"confidence":{"type":"number","title":"Confidence","default":0.0},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["model"],"title":"Vote"},"WarrantyBreachRequest":{"properties":{"warranty_id":{"type":"string","title":"Warranty Id","description":"Warranty ID to report breach on"},"breach_description":{"type":"string","title":"Breach Description","description":"Description of the breach"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence","description":"Optional evidence dict"}},"type":"object","required":["warranty_id","breach_description"],"title":"WarrantyBreachRequest"},"WarrantyIssueRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID of the warranting agent"},"action_id":{"type":"string","title":"Action Id","description":"Action correlation ID being warranted"},"claim":{"type":"string","title":"Claim","description":"Human-readable warranty claim"},"scope":{"additionalProperties":true,"type":"object","title":"Scope","description":"Scope constraints"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At","description":"ISO-8601 expiry UTC"}},"type":"object","required":["agent_did","action_id","claim"],"title":"WarrantyIssueRequest"},"WisdomRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id","description":"Tenant identifier"},"brand_name":{"type":"string","title":"Brand Name","description":"Organization name"},"company_domain":{"type":"string","title":"Company Domain","description":"Company domain for context","default":""},"vertical":{"type":"string","title":"Vertical","description":"Industry vertical","default":"universal"},"features_enabled":{"items":{"type":"string"},"type":"array","title":"Features Enabled","description":"Already-active features"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Optional specific question"}},"type":"object","required":["tenant_id","brand_name"],"title":"WisdomRequest","description":"Build #43 Wisdom panel request — extended to use Kimi K2.6."},"WisdomResponse":{"properties":{"recommendations":{"title":"Recommendations"},"source":{"type":"string","title":"Source"},"configured":{"type":"boolean","title":"Configured"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["recommendations","source","configured"],"title":"WisdomResponse"},"WithdrawRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"amount_usdc":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Amount Usdc"}},"type":"object","required":["operator_did","amount_usdc"],"title":"WithdrawRequest"},"WorkloadRequest":{"properties":{"gpu_type":{"type":"string","title":"Gpu Type","description":"cpu | rtx_4090 | h100 | a100 | l40s | rtx_3090 | rtx_a6000","default":"cpu"},"cpu_cores":{"type":"integer","minimum":1.0,"title":"Cpu Cores","default":1},"ram_gb":{"type":"integer","minimum":1.0,"title":"Ram Gb","default":4},"duration_hours":{"type":"number","exclusiveMinimum":0.0,"title":"Duration Hours","default":1.0},"budget_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Budget Usd"},"deadline_unix":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Deadline Unix"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"submitter_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submitter Did"}},"type":"object","title":"WorkloadRequest"},"WrapReceiptBody":{"properties":{"vertical":{"type":"string","maxLength":64,"minLength":2,"title":"Vertical","description":"vertical id, e.g. lex-contract, alcoa-agentguard, hipaa-hive"},"event_type":{"type":"string","maxLength":128,"minLength":2,"title":"Event Type","description":"e.g. draft_attest, dosing_attest, consent_attest"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","description":"the original attest input"},"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"the original attest output"},"tenant_did":{"type":"string","maxLength":256,"minLength":3,"title":"Tenant Did"},"counterparty_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty Did"},"price_atomic":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price Atomic"},"partner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partner Id"}},"type":"object","required":["vertical","event_type","payload","receipt","tenant_did"],"title":"WrapReceiptBody","description":"Universal CCACW wrapper. Lets any vertical (LEX, ALCOA, HIPAA, etc.)\ntake its existing attest payload and upgrade it into a CCACW-signed\nreceipt with ML-DSA-65 + partner_id attribution + dual-DID binding.\n\nThe original attest payload is hashed into prompt_hash; the existing\nreceipt is signed as the response. Verticals keep their formats and\ngain CCACW provability in one POST."},"hivemorph__appkits_routes__QuoteBody":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"token_in":{"type":"string","title":"Token In"},"token_out":{"type":"string","title":"Token Out"},"chain_from":{"type":"string","title":"Chain From"},"chain_to":{"type":"string","title":"Chain To"}},"type":"object","required":["amount","token_in","token_out","chain_from","chain_to"],"title":"QuoteBody"},"hivemorph__hive_activation__router__MintRequest":{"properties":{"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes","description":"Requested permission scopes. Validated against the public allowlist; 'activation:mint' is admin-only. Defaults to ['receipts:read', 'x402:quote']."},"usage_limit":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":1.0},{"type":"null"}],"title":"Usage Limit","description":"Optional max number of verify calls this key may serve."},"label":{"type":"string","maxLength":80,"title":"Label","description":"Optional human label.","default":""}},"type":"object","title":"MintRequest","description":"Body for POST /v1/activation/keys (all fields optional)."},"hivemorph__hive_activation__router__VerifyRequest":{"properties":{"key":{"type":"string","title":"Key","description":"The tk_live_ activation key to verify."}},"type":"object","required":["key"],"title":"VerifyRequest"},"hivemorph__hive_afir_stream__routes__VerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"a segment receipt or a sealed session receipt"}},"type":"object","required":["receipt"],"title":"VerifyRequest"},"hivemorph__hive_arb__compute_routes__RouteRequest":{"properties":{"shape":{"type":"string","title":"Shape","description":"HiveMorph shape name (e.g. 'merchant', 'attestor', 'guardian')","examples":["merchant"]},"prompt":{"type":"string","title":"Prompt","description":"User prompt to send to the LLM","examples":["Classify this transaction as legitimate or suspicious."]},"quality_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Tier","description":"Override quality tier: T0_CHEAP | T1_STANDARD | T2_HIGH. If omitted, inferred from shape.","examples":["T1_STANDARD"]},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt","description":"Optional system message prepended to the conversation"},"extra_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra Params","description":"Additional gateway parameters (temperature, max_tokens, etc.)"}},"type":"object","required":["shape","prompt"],"title":"RouteRequest"},"hivemorph__hive_arb__routes__BookRequest":{"properties":{"buy_offer_id":{"type":"string","title":"Buy Offer Id","description":"Bus offer ID of the cheaper (buy-side) offer"},"sell_offer_id":{"type":"string","title":"Sell Offer Id","description":"Bus offer ID of the more expensive (sell-side) offer"}},"type":"object","required":["buy_offer_id","sell_offer_id"],"title":"BookRequest"},"hivemorph__hive_bounty__routes__RegisterBody":{"properties":{"handle":{"type":"string","maxLength":40,"minLength":1,"title":"Handle","description":"X handle e.g. @somebody"},"repo_url":{"type":"string","title":"Repo Url","description":"Public GitHub repo URL of the agent"},"verify_url":{"type":"string","title":"Verify Url","description":"https://thehiveryiq.com/verify/?id=<receipt_id> URL"},"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet","description":"Base 8453 wallet (0x...) — required before payout"},"framework":{"type":"string","title":"Framework","description":"Primary framework: langchain | langgraph | crewai"}},"type":"object","required":["handle","repo_url","verify_url","framework"],"title":"RegisterBody"},"hivemorph__hive_capitolare__routes__SettleRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"sealed":{"type":"boolean","title":"Sealed","default":false},"tx_hash":{"type":"string","title":"Tx Hash","default":""}},"type":"object","required":["session_id"],"title":"SettleRequest"},"hivemorph__hive_capitolare__routes__VerifyRequest":{"properties":{"public_view":{"additionalProperties":true,"type":"object","title":"Public View"},"expected_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Venue"},"sealed_view":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sealed View"}},"type":"object","required":["public_view"],"title":"VerifyRequest"},"hivemorph__hive_clear__models__ChainVerifyRequest":{"properties":{"pa_id":{"type":"string","title":"Pa Id","description":"pa_id to trace the full chain for"}},"type":"object","required":["pa_id"],"title":"ChainVerifyRequest","description":"Request to verify the full lifecycle chain for a PA."},"hivemorph__hive_compute_grid__routes__BookRequest":{"properties":{"auction_id":{"type":"string","title":"Auction Id","description":"Auction id from /solve response"},"provider":{"type":"string","title":"Provider","description":"Chosen provider id (must match auction winner)"},"quote":{"additionalProperties":true,"type":"object","title":"Quote","description":"The chosen Quote dict from /solve"},"deadline_unix":{"type":"integer","exclusiveMinimum":0.0,"title":"Deadline Unix"}},"type":"object","required":["auction_id","provider","quote","deadline_unix"],"title":"BookRequest"},"hivemorph__hive_compute_grid__routes__VerifyRequest":{"properties":{"proof":{"title":"Proof","description":"Groth16 proof envelope (dict or 8-elem list)"},"public_inputs":{"items":{},"type":"array","title":"Public Inputs","description":"Public inputs (BN254 field elements)"},"claim":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Claim","description":"Optional claim metadata"},"proof_system":{"type":"string","title":"Proof System","description":"Proof system identifier","default":"groth16"}},"type":"object","required":["proof","public_inputs"],"title":"VerifyRequest"},"hivemorph__hive_deedlock__models__ChainVerifyRequest":{"properties":{"property_id":{"type":"string","title":"Property Id"},"buyer_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Buyer Did"},"seller_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seller Did"},"require_recorded":{"type":"boolean","title":"Require Recorded","description":"Require RECORDED state to consider chain complete","default":true}},"type":"object","required":["property_id"],"title":"ChainVerifyRequest","description":"Verify the full transaction chain for a property — returns the\nordered receipt chain and whether the state machine is valid."},"hivemorph__hive_designer__routes__MintRequest":{"properties":{"spec":{"additionalProperties":true,"type":"object","title":"Spec"},"publisher_address":{"type":"string","maxLength":64,"minLength":42,"title":"Publisher Address"},"eip712_signature":{"type":"string","minLength":10,"title":"Eip712 Signature"}},"type":"object","required":["spec","publisher_address","eip712_signature"],"title":"MintRequest"},"hivemorph__hive_earn__routes__RegisterBody":{"properties":{"agent_did":{"type":"string","title":"Agent Did","description":"DID or 0x address of the registering earner"},"attribution_url":{"type":"string","title":"Attribution Url","description":"Optional public URL for attribution badge","default":""},"surfaces":{"items":{"type":"string"},"type":"array","title":"Surfaces","description":"Surface IDs the earner intends to provide"},"payout_address":{"type":"string","title":"Payout Address","description":"Base USDC EVM address (0x...) for payouts"},"attribution_referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution Referrer","description":"Referrer DID — set ONCE at register-time"}},"type":"object","required":["agent_did","surfaces","payout_address"],"title":"RegisterBody"},"hivemorph__hive_evaluator__routes__AttestRequest":{"properties":{"provider":{"type":"string","title":"Provider","description":"Provider address posting the attestation."},"deliverable":{"type":"string","title":"Deliverable","description":"bytes32 deliverable commitment from the provider."},"extra":{"additionalProperties":true,"type":"object","title":"Extra","description":"Optional payload merged into the verdict job_payload (e.g. {'red_flag': true})."}},"type":"object","required":["provider","deliverable"],"title":"AttestRequest"},"hivemorph__hive_insurance__routes__QuoteBody":{"properties":{"protocol":{"type":"string","title":"Protocol","description":"Protocol / product identifier (e.g. 'aave-v3', 'lido', or the productId from /products)"},"cover_amount_usd":{"type":"number","maximum":1000000000.0,"exclusiveMinimum":0.0,"title":"Cover Amount Usd","description":"Notional coverage in USD"},"duration_days":{"type":"integer","maximum":365.0,"exclusiveMinimum":0.0,"title":"Duration Days","description":"Coverage duration in days"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Provider key. If omitted, quote is routed to all providers and the array of responses is returned. One of: nexus_mutual, sherlock, risk_harbor, insurace."}},"type":"object","required":["protocol","cover_amount_usd","duration_days"],"title":"QuoteBody"},"hivemorph__hive_law__insurance_routes__ContractBody":{"properties":{"insured_did":{"type":"string","title":"Insured Did"},"insurer_did":{"type":"string","title":"Insurer Did"},"claims_adjuster_agent_did":{"type":"string","title":"Claims Adjuster Agent Did"},"reinsurer_did":{"type":"string","title":"Reinsurer Did","default":""},"repair_vendor_did":{"type":"string","title":"Repair Vendor Did","default":""},"country_iso":{"type":"string","maxLength":2,"minLength":2,"title":"Country Iso"},"region":{"type":"string","title":"Region"},"regulatory_regime":{"type":"string","title":"Regulatory Regime","default":""},"policy_id":{"type":"string","title":"Policy Id"},"line_of_business":{"type":"string","title":"Line Of Business"},"coverage_limit_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Coverage Limit Usdc"},"deductible_usdc":{"type":"number","minimum":0.0,"title":"Deductible Usdc"},"exclusions":{"items":{"type":"string"},"type":"array","title":"Exclusions"},"effective_at":{"type":"number","title":"Effective At","default":0.0},"expires_at":{"type":"number","title":"Expires At","default":0.0},"claim_id":{"type":"string","title":"Claim Id"},"claim_type":{"type":"string","title":"Claim Type"},"incident_date":{"type":"number","title":"Incident Date"},"claimed_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Claimed Amount Usdc"},"evidence_refs":{"items":{"type":"string"},"type":"array","title":"Evidence Refs"},"description":{"type":"string","title":"Description","default":""},"insurer_bond_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Insurer Bond Usdc"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["insured_did","insurer_did","claims_adjuster_agent_did","country_iso","region","policy_id","line_of_business","coverage_limit_usdc","deductible_usdc","claim_id","claim_type","incident_date","claimed_amount_usdc","insurer_bond_usdc"],"title":"ContractBody"},"hivemorph__hive_law__insurance_routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"filer_did":{"type":"string","title":"Filer Did"},"adjuster_proposed_usdc":{"type":"number","title":"Adjuster Proposed Usdc","default":0.0},"adjuster_denied":{"type":"boolean","title":"Adjuster Denied","default":false},"denial_reason_claimed":{"type":"string","title":"Denial Reason Claimed","default":""},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","filer_did"],"title":"DisputeBody"},"hivemorph__hive_law__routes__ContractBody":{"properties":{"shipper_did":{"type":"string","title":"Shipper Did"},"broker_did":{"type":"string","title":"Broker Did"},"carrier_did":{"type":"string","title":"Carrier Did"},"consignee_did":{"type":"string","title":"Consignee Did"},"country_iso":{"type":"string","maxLength":2,"minLength":2,"title":"Country Iso"},"region":{"type":"string","title":"Region"},"lane_origin":{"type":"string","title":"Lane Origin"},"lane_dest":{"type":"string","title":"Lane Dest"},"pickup_window_start":{"type":"number","title":"Pickup Window Start"},"pickup_window_end":{"type":"number","title":"Pickup Window End"},"delivery_window_start":{"type":"number","title":"Delivery Window Start"},"delivery_window_end":{"type":"number","title":"Delivery Window End"},"freight_class":{"type":"string","title":"Freight Class"},"weight_lb":{"type":"number","exclusiveMinimum":0.0,"title":"Weight Lb"},"dims_in":{"items":{"type":"number"},"type":"array","maxItems":3,"minItems":3,"title":"Dims In"},"declared_value_usd":{"type":"number","minimum":0.0,"title":"Declared Value Usd"},"agreed_rate_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Agreed Rate Usdc"},"bond_amount_usdc":{"type":"number","exclusiveMinimum":0.0,"title":"Bond Amount Usdc"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["shipper_did","broker_did","carrier_did","consignee_did","country_iso","region","lane_origin","lane_dest","pickup_window_start","pickup_window_end","delivery_window_start","delivery_window_end","freight_class","weight_lb","dims_in","declared_value_usd","agreed_rate_usdc","bond_amount_usdc"],"title":"ContractBody"},"hivemorph__hive_law__routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"dispute_condition":{"type":"string","title":"Dispute Condition"},"filer_did":{"type":"string","title":"Filer Did"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","dispute_condition","filer_did"],"title":"DisputeBody"},"hivemorph__hive_mark__routes__AttestRequest":{"properties":{"brand_owner_did":{"type":"string","title":"Brand Owner Did","description":"DID of the brand owner attesting first use"},"mark_text":{"type":"string","maxLength":512,"minLength":1,"title":"Mark Text","description":"The trademark string"},"use_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Use Url","description":"URL where the mark appears"},"use_type":{"anyOf":[{"type":"string","enum":["website","social-post","product-shipment","ad-campaign","other"]},{"type":"null"}],"title":"Use Type","default":"other"},"evidence_hash":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Evidence Hash","description":"SHA-256 hex of screenshot/asset"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["brand_owner_did","mark_text"],"title":"AttestRequest"},"hivemorph__hive_media_origin__routes__VerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"A full M.O.R. receipt object"}},"type":"object","required":["receipt"],"title":"VerifyRequest"},"hivemorph__hive_mining__orchestrate__RegisterRequest":{"properties":{"operator_did":{"type":"string","maxLength":256,"minLength":3,"title":"Operator Did"},"mos_endpoint":{"type":"string","minLength":7,"title":"Mos Endpoint"},"sites":{"items":{"type":"string"},"type":"array","title":"Sites"},"wallet_addr":{"type":"string","title":"Wallet Addr"}},"type":"object","required":["operator_did","mos_endpoint","wallet_addr"],"title":"RegisterRequest"},"hivemorph__hive_mining__routes__BookRequest":{"properties":{"worker_id":{"type":"string","minLength":1,"title":"Worker Id"},"hashrate_th_s":{"type":"number","exclusiveMinimum":0.0,"title":"Hashrate Th S"},"duration_minutes":{"type":"integer","maximum":43200.0,"exclusiveMinimum":0.0,"title":"Duration Minutes"},"payer_address":{"type":"string","title":"Payer Address"},"settle_asset":{"type":"string","title":"Settle Asset","default":"USDC"}},"type":"object","required":["worker_id","hashrate_th_s","duration_minutes","payer_address"],"title":"BookRequest"},"hivemorph__hive_mining__routes__RouteRequest":{"properties":{"energy_cost_usdc_per_kwh":{"type":"number","maximum":2.0,"exclusiveMinimum":0.0,"title":"Energy Cost Usdc Per Kwh"},"region":{"type":"string","title":"Region","default":"any"},"fleet_size_th_s":{"type":"number","maximum":10000000.0,"exclusiveMinimum":0.0,"title":"Fleet Size Th S"}},"type":"object","required":["energy_cost_usdc_per_kwh","fleet_size_th_s"],"title":"RouteRequest"},"hivemorph__hive_morso__routes__ClassifyRequest":{"properties":{"sealed_parent":{"$ref":"#/components/schemas/SealedParentIn"},"excerpt":{"$ref":"#/components/schemas/ExcerptIn"}},"type":"object","required":["sealed_parent","excerpt"],"title":"ClassifyRequest"},"hivemorph__hive_morso__routes__VerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"A full MoRSo receipt object"}},"type":"object","required":["receipt"],"title":"VerifyRequest"},"hivemorph__hive_newsshield__models__ChainVerifyRequest":{"properties":{"asset_id":{"type":"string","title":"Asset Id","description":"asset_id to trace the full lifecycle chain for"}},"type":"object","required":["asset_id"],"title":"ChainVerifyRequest","description":"Request to verify the full lifecycle chain for an asset."},"hivemorph__hive_prov__routes__VerifyReq":{"properties":{"method":{"type":"string","title":"Method","description":"HTTP method that was signed"},"path":{"type":"string","title":"Path","description":"URL path that was signed"},"body_b64u":{"type":"string","title":"Body B64U","description":"Base64url-encoded response body bytes","default":""},"ts":{"type":"integer","title":"Ts","description":"Unix timestamp from X-Hive-Prov-Ts"},"sig_b64u":{"type":"string","title":"Sig B64U","description":"Signature from X-Hive-Prov-Sig"}},"type":"object","required":["method","path","ts","sig_b64u"],"title":"VerifyReq"},"hivemorph__hive_r10__routes__VerifyReq":{"properties":{"commitment_id":{"type":"string","maxLength":64,"minLength":4,"title":"Commitment Id"},"opening":{"additionalProperties":true,"type":"object","title":"Opening","description":"An Opening envelope as returned by /open"},"expected_rubric_root":{"anyOf":[{"type":"string","maxLength":256,"minLength":4},{"type":"null"}],"title":"Expected Rubric Root"}},"type":"object","required":["commitment_id","opening"],"title":"VerifyReq"},"hivemorph__hive_r3__routes__VerifyReq":{"properties":{"envelope":{"additionalProperties":true,"type":"object","title":"Envelope"}},"type":"object","required":["envelope"],"title":"VerifyReq"},"hivemorph__hive_r6__routes__WriteReq":{"properties":{"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"operator_did":{"type":"string","maxLength":200,"minLength":3,"title":"Operator Did"},"kind":{"type":"string","maxLength":40,"minLength":1,"title":"Kind"},"scope":{"type":"string","maxLength":40,"minLength":1,"title":"Scope","default":"operator"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"tags":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Tags"},"hktn_refs":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Hktn Refs"},"provenance":{"additionalProperties":true,"type":"object","title":"Provenance"},"expires_at":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["agent_did","operator_did","kind"],"title":"WriteReq"},"hivemorph__hive_r8__routes__WriteReq":{"properties":{"wid":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Wid"},"phase":{"type":"string","maxLength":40,"minLength":1,"title":"Phase"},"agent_did":{"type":"string","maxLength":200,"minLength":3,"title":"Agent Did"},"operator_did":{"type":"string","maxLength":200,"minLength":3,"title":"Operator Did"},"state":{"additionalProperties":true,"type":"object","title":"State"},"rubric_hash":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Rubric Hash"},"policy_version":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Policy Version"},"delegation_jti":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Delegation Jti"},"hktn_refs":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Hktn Refs"},"receipt_refs":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Receipt Refs"},"artifact_refs":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Artifact Refs"},"note":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Note"}},"type":"object","required":["phase","agent_did","operator_did"],"title":"WriteReq"},"hivemorph__hive_r9__routes__VerifyReq":{"properties":{"witness":{"additionalProperties":true,"type":"object","title":"Witness","description":"An inclusion witness as returned by /inclusion"}},"type":"object","required":["witness"],"title":"VerifyReq"},"hivemorph__hive_smsh___judge_routes_patch__JudgeRequest":{"properties":{"text":{"type":"string","title":"Text","description":"The prompt text to judge for span importance."},"max_spans":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Max Spans","description":"Maximum number of spans to segment into. Default 60.","default":60},"model":{"type":"string","title":"Model","description":"Model alias for the judge. 'auto' uses mistral-7b (cheapest). Options: mistral-7b, llama-3-8b, gemini-2-0-flash, gpt-4o-mini, qwen-2-5-72b, mixtral-8x7b, llama-3-70b, claude-3-5-haiku, claude-3-5-sonnet, gpt-4o, claude-3-opus.","default":"auto"}},"type":"object","required":["text"],"title":"JudgeRequest"},"hivemorph__hive_smsh___pq_routes_patch__VerifyRequest":{"properties":{"message_b64":{"type":"string","title":"Message B64","description":"Base64-encoded message"},"sig_b64":{"type":"string","title":"Sig B64","description":"Base64-encoded ML-DSA-65 signature"},"pk_b64":{"type":"string","title":"Pk B64","description":"Base64-encoded ML-DSA-65 public key"}},"type":"object","required":["message_b64","sig_b64","pk_b64"],"title":"VerifyRequest"},"hivemorph__hive_smsh___pq_routes_patch__VerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"alg":{"type":"string","title":"Alg"},"fips":{"type":"string","title":"Fips"},"backend":{"type":"string","title":"Backend"}},"type":"object","required":["valid","alg","fips","backend"],"title":"VerifyResponse"},"hivemorph__hive_smsh__routes__CompressRequest":{"properties":{"text":{"type":"string","title":"Text","description":"Prompt text to compress."},"mode":{"type":"string","title":"Mode","description":"Compression mode.","default":"smsh-std"},"fidelity_target":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fidelity Target","description":"If set (0.0-1.0), run inference on both raw and compressed, judge fidelity. If measured fidelity < target, response includes fallback='raw'."},"turn_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Turn Index","description":"Conversation turn index for smsh-v1 mode (0 = single-turn, >=2 = multi-turn cap 2.5x). Ignored by legacy modes.","default":0}},"type":"object","required":["text"],"title":"CompressRequest"},"hivemorph__hive_smsh__routes__JudgeRequest":{"properties":{"text":{"type":"string","title":"Text","description":"Text to score by clause importance."},"target_ratio":{"type":"number","title":"Target Ratio","description":"Target keep fraction (0.0-1.0).","default":0.5},"model":{"type":"string","title":"Model","description":"Judge model ID.","default":"gpt-4o-mini"}},"type":"object","required":["text"],"title":"JudgeRequest"},"hivemorph__hive_trade_finance__routes__DisputeBody":{"properties":{"reason":{"type":"string","title":"Reason","description":"Free-form dispute reason"},"evidence_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Uri","description":"Optional link to evidence"}},"type":"object","required":["reason"],"title":"DisputeBody"},"hivemorph__hive_tradefinance__routes__ContractBody":{"properties":{"importer_did":{"type":"string","title":"Importer Did"},"exporter_did":{"type":"string","title":"Exporter Did"},"freight_forwarder_did":{"type":"string","title":"Freight Forwarder Did"},"bank_guarantor_did":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Guarantor Did","default":""},"origin_country":{"type":"string","maxLength":2,"minLength":2,"title":"Origin Country"},"destination_country":{"type":"string","maxLength":2,"minLength":2,"title":"Destination Country"},"incoterm":{"type":"string","title":"Incoterm"},"origin_port":{"type":"string","title":"Origin Port"},"destination_port":{"type":"string","title":"Destination Port"},"hs_code":{"type":"string","title":"Hs Code"},"goods_description":{"type":"string","title":"Goods Description"},"quantity":{"type":"number","exclusiveMinimum":0.0,"title":"Quantity"},"unit":{"type":"string","title":"Unit"},"unit_value_usd":{"type":"number","minimum":0.0,"title":"Unit Value Usd"},"total_value_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Total Value Usd"},"contract_value_usd":{"type":"number","exclusiveMinimum":0.0,"title":"Contract Value Usd"},"settle_currency":{"type":"string","title":"Settle Currency","default":"USDC"},"settle_chain":{"type":"string","title":"Settle Chain","default":"base"},"payment_schedule":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Payment Schedule"},"pickup_window_start":{"type":"number","title":"Pickup Window Start"},"pickup_window_end":{"type":"number","title":"Pickup Window End"},"delivery_window_start":{"type":"number","title":"Delivery Window Start"},"delivery_window_end":{"type":"number","title":"Delivery Window End"},"bond_amount_usdc":{"type":"number","minimum":0.0,"title":"Bond Amount Usdc","default":0.0},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["importer_did","exporter_did","freight_forwarder_did","origin_country","destination_country","incoterm","origin_port","destination_port","hs_code","goods_description","quantity","unit","unit_value_usd","total_value_usd","contract_value_usd","pickup_window_start","pickup_window_end","delivery_window_start","delivery_window_end"],"title":"ContractBody"},"hivemorph__hive_tradefinance__routes__DisputeBody":{"properties":{"dispute_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dispute Id"},"contract_id":{"type":"string","title":"Contract Id"},"dispute_condition":{"type":"string","title":"Dispute Condition"},"filer_did":{"type":"string","title":"Filer Did"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"}},"type":"object","required":["contract_id","dispute_condition","filer_did"],"title":"DisputeBody"},"hivemorph__hive_tradeguard__models__VerifyResponse":{"properties":{"attestation_id":{"type":"string","title":"Attestation Id"},"trader_did":{"type":"string","title":"Trader Did"},"firm_did":{"type":"string","title":"Firm Did"},"algo_id":{"type":"string","title":"Algo Id"},"order_event_hash":{"type":"string","title":"Order Event Hash"},"event_type":{"type":"string","title":"Event Type"},"venue":{"type":"string","title":"Venue"},"timestamp_iso":{"type":"string","title":"Timestamp Iso"},"receipt_envelope":{"additionalProperties":true,"type":"object","title":"Receipt Envelope"},"verification":{"additionalProperties":true,"type":"object","title":"Verification"}},"type":"object","required":["attestation_id","trader_did","firm_did","algo_id","order_event_hash","event_type","venue","timestamp_iso","receipt_envelope","verification"],"title":"VerifyResponse"},"hivemorph__mos__intel__RegisterRequest":{"properties":{"site_did":{"type":"string","maxLength":512,"minLength":10,"title":"Site Did","description":"The site DID (did:key:z6Mk... or similar)."},"operator_name":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Operator Name","description":"Optional human-readable operator name."},"machine_count":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Machine Count","description":"Number of machines at this site. Informational in v0.1."}},"type":"object","required":["site_did"],"title":"RegisterRequest","description":"Body for POST /v1/mos/intel/register."},"hivemorph__server__SettleRequest":{"properties":{"reservation_id":{"type":"string","title":"Reservation Id","description":"2PC reservation ID from the offer token"}},"type":"object","required":["reservation_id"],"title":"SettleRequest"},"hivemorph__trail_routes__DisputeBody":{"properties":{"disputer_did":{"type":"string","title":"Disputer Did"},"reason":{"type":"string","title":"Reason"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["disputer_did","reason"],"title":"DisputeBody"},"hivemorph__xcalibur__echo_routes__CompressRequest":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"The prompt text to compress."},"target_ratio":{"type":"number","title":"Target Ratio","description":"Target length-reduction ratio in (0, 1). The compressed prompt must be at most this fraction of the original token count. Default 0.6 (≤60%% of original).","default":0.6},"min_preservation":{"type":"number","title":"Min Preservation","description":"Minimum surrogate preservation score [0, 1]. Gradient-free mutation search keeps drops only if score stays at or above this threshold. Default 0.85.","default":0.85}},"type":"object","required":["prompt"],"title":"CompressRequest"},"hivemorph__xcalibur__echo_routes__VerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt","description":"The receipt object returned by /compress."},"compressed_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compressed Prompt","description":"If provided, verifies that sha3_256(compressed_prompt) matches receipt.compressed_hash. Also enables tamper detection."}},"type":"object","required":["receipt"],"title":"VerifyRequest"},"hivemorph__xcalibur__echo_routes__VerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"checks":{"additionalProperties":true,"type":"object","title":"Checks"}},"type":"object","required":["valid","checks"],"title":"VerifyResponse"},"hivemorph__xcalibur__membrane_routes__VerifyRequest":{"properties":{"receipt":{"additionalProperties":true,"type":"object","title":"Receipt"}},"type":"object","required":["receipt"],"title":"VerifyRequest"},"hivemorph__xcalibur__membrane_v2_routes__ClassifyRequest":{"properties":{"text":{"type":"string","minLength":1,"title":"Text","description":"Text to classify for safety/injection"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold","description":"Decision threshold for unsafe classification (default 0.5)","default":0.5},"weights":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Weights","description":"Per-candidate weights (must sum to ~1.0). Keys: toxic_bert, deberta_pi, membrane_v1, keyword_heuristic. Uses calibrated defaults if omitted."}},"type":"object","required":["text"],"title":"ClassifyRequest"},"hivemorph__xcalibur__verify_v2_routes__AttestRequest":{"properties":{"chunk":{"type":"string","minLength":1,"title":"Chunk","description":"The data chunk to attest, as a UTF-8 string (hex-encode binary)."},"corpus_root":{"type":"string","title":"Corpus Root","description":"Expected Merkle root (hex) of the corpus."},"expected_path":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Expected Path","description":"Merkle inclusion path. Each element: {\"sibling\": \"<hex>\", \"position\": \"left\"|\"right\"}. Empty list means leaf IS the root (single-element corpus)."},"signature_hex":{"type":"string","title":"Signature Hex","description":"Signer's PQ signature over chunk (hex)."},"signer_pubkey_hex":{"type":"string","title":"Signer Pubkey Hex","description":"Signer's PQ public key (hex)."},"alg":{"type":"string","title":"Alg","description":"PQ signature algorithm used by signer. Default: ML-DSA-65.","default":"ML-DSA-65"},"run_slhdsa":{"type":"boolean","title":"Run Slhdsa","description":"Include SLH-DSA cross-family witness in ensemble (slower but stronger).","default":true}},"type":"object","required":["chunk","corpus_root","signature_hex","signer_pubkey_hex"],"title":"AttestRequest"}}}}