{"openapi":"3.1.0","info":{"title":"Patchr Protocol API","version":"0.1.0","summary":"Agentic economy infrastructure contract for external apps, services, and agents."},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://api.patchr.co","description":"Patchr production API"}],"tags":[{"name":"runtime","description":"Runtime health and configuration."},{"name":"contract","description":"Machine-readable Patchr contracts."},{"name":"mcp","description":"MCP JSON-RPC transport for external agents."},{"name":"a2a","description":"Agent-to-agent envelope contracts."},{"name":"security","description":"Policy evaluation for mandate sessions and capability grants."},{"name":"tools","description":""},{"name":"sandbox","description":"Deterministic benchmark traces for developer playgrounds."},{"name":"orchestrator","description":"Live developer orchestration across Patchr domains."},{"name":"benchmarks","description":"Local benchmark evidence and claim labels."},{"name":"events","description":"External integration event outbox, subscriptions, and delivery attempts."},{"name":"agents","description":"Agent lifecycle and capability discovery."},{"name":"bridge","description":"External connector registry, scope, and preflight contracts."},{"name":"channels","description":"Persistent conversation state across provider touchpoints."},{"name":"proxy","description":"Human-in-the-loop suspend and resume contracts."},{"name":"tasks","description":"Task lifecycle."},{"name":"cases","description":"Formal case workspaces, deadlines, stakeholders, timelines, and evidence bundle exports."},{"name":"workflows","description":"Use-case-first workflow templates."},{"name":"resolve","description":"Resolve decisions and evidence."},{"name":"hunt","description":"Discovery and telemetry ranking."},{"name":"mandates","description":"Mandate registration and verification."},{"name":"pay","description":"PAY settlement and receipts."},{"name":"audit","description":"Evidence, proof-of-value, and receipt verification."},{"name":"signals","description":"Community signal ingestion and task launch."}],"paths":{"/healthz":{"get":{"operationId":"healthz","summary":"Return Picux runtime health.","tags":["runtime"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/runtime":{"get":{"operationId":"runtimeSummary","summary":"Return runtime configuration summary.","tags":["runtime"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/status":{"get":{"operationId":"apiStatus","summary":"Return public Picux API status.","tags":["runtime"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openapi.json":{"get":{"operationId":"openapiSpec","summary":"Return the OpenAPI contract.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/contract":{"get":{"operationId":"contractSummary","summary":"Return a compact Picux contract summary.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/manifest":{"get":{"operationId":"integrationManifest","summary":"Return the Picux integration manifest.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/protocol-map":{"get":{"operationId":"protocolMap","summary":"Return the agent-readable Picux protocol map.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/handshake":{"post":{"operationId":"integrationHandshake","summary":"Validate an external Picux integration handshake.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/schemas":{"get":{"operationId":"schemaCatalog","summary":"List Picux JSON Schema contracts.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/schemas/{schemaId}":{"get":{"operationId":"getSchema","summary":"Fetch a Picux JSON Schema contract.","tags":["contract"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"schemaId","in":"path","required":true,"schema":{"type":"string"}}]}},"/mcp":{"post":{"operationId":"mcpRpc","summary":"Handle MCP JSON-RPC tool calls.","tags":["mcp"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/a2a/contract":{"get":{"operationId":"a2aContract","summary":"Return the A2A envelope contract.","tags":["a2a"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/security/policy/evaluate":{"post":{"operationId":"evaluatePolicy","summary":"Evaluate mandate-session and capability-grant policy.","tags":["security"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/compliance/outreach/evaluate":{"post":{"operationId":"evaluateOutreachCompliance","summary":"Evaluate lawful basis, consent, suppression, and auditability before outreach.","tags":["security"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/security/secrets/check":{"post":{"operationId":"checkSecrets","summary":"Validate scoped secret references without exposing secret values.","tags":["security"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/nlp":{"post":{"operationId":"nlpTool","summary":"Classify a raw user query, detect follow-up context, and select Picux domain routing.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/imageReader":{"post":{"operationId":"imageReader","summary":"Read image attachments and return query-relevant evidence signals.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/browserReader":{"post":{"operationId":"browserReader","summary":"Prepare or execute headless browser source reads for HUNT and RESOLVE.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/map":{"post":{"operationId":"mapTool","summary":"Search source-bound local places for HUNT and RESOLVE using Google Places/Maps or an adapter-neutral fallback.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/chainTrace":{"post":{"operationId":"chainTraceTool","summary":"Trace blockchain transactions through explorer or analytics evidence and prepare recovery assessment.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tools/portalBrowser":{"post":{"operationId":"portalBrowser","summary":"Run a fail-closed authenticated portal action and return proof-ready artifacts.","tags":["tools"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/sandbox/midnight-arbitrage":{"post":{"operationId":"runSandbox","summary":"Run the deterministic Midnight Arbitrage sandbox.","tags":["sandbox"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/orchestrator/run":{"post":{"operationId":"runOrchestrator","summary":"Run Picux orchestration across HUNT, RESOLVE, BRIDGE, PROXY, and PAY from a user request.","tags":["orchestrator"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/benchmarks/local":{"post":{"operationId":"runBenchmark","summary":"Run local protocol benchmark evidence.","tags":["benchmarks"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/a2a/envelopes":{"post":{"operationId":"createA2AEnvelope","summary":"Create an A2A delegation envelope.","tags":["a2a"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listA2AEnvelopes","summary":"List durable A2A envelopes.","tags":["a2a"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/a2a/envelopes/{msgId}":{"get":{"operationId":"getA2AEnvelope","summary":"Fetch a durable A2A envelope.","tags":["a2a"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"msgId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/a2a/envelopes/{msgId}/update":{"post":{"operationId":"updateA2AEnvelope","summary":"Update durable A2A envelope delivery status.","tags":["a2a"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"msgId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/events":{"post":{"operationId":"recordEvent","summary":"Record an integration event.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listEvents","summary":"List integration event outbox records.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/events/{eventId}":{"get":{"operationId":"getEvent","summary":"Fetch an integration event.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/events/{eventId}/ack":{"post":{"operationId":"ackEvent","summary":"Acknowledge an integration event.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-subscriptions":{"post":{"operationId":"createEventSubscription","summary":"Register an external event subscription.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listEventSubscriptions","summary":"List external event subscriptions.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/event-subscriptions/{subId}":{"get":{"operationId":"getEventSubscription","summary":"Fetch an external event subscription.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/event-subscriptions/{subId}/update":{"post":{"operationId":"updateEventSubscription","summary":"Update an external event subscription.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries":{"post":{"operationId":"createEventDelivery","summary":"Create an external event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listEventDeliveries","summary":"List external event delivery attempts.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/event-deliveries/stats":{"get":{"operationId":"eventDeliveryStats","summary":"Summarize external event delivery queue health.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/event-deliveries/ready":{"get":{"operationId":"eventDeliveryReady","summary":"List claimable event delivery attempts without claiming them.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/event-deliveries/{deliveryId}":{"get":{"operationId":"getEventDelivery","summary":"Fetch an external event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/event-deliveries/{deliveryId}/chain":{"get":{"operationId":"eventDeliveryChain","summary":"Fetch retry lineage for an event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/event-deliveries/claim":{"post":{"operationId":"claimEventDelivery","summary":"Claim the next queued event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/claimBatch":{"post":{"operationId":"claimEventDeliveries","summary":"Claim a batch of ready event delivery attempts.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/sweep":{"post":{"operationId":"sweepEventDeliveryLeases","summary":"Sweep expired event delivery leases back to queued.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/retry":{"post":{"operationId":"retryEventDelivery","summary":"Retry a failed or canceled event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/fail":{"post":{"operationId":"failEventDelivery","summary":"Fail an event delivery attempt and optionally schedule its retry.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/complete":{"post":{"operationId":"completeEventDelivery","summary":"Complete a claimed event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/cancel":{"post":{"operationId":"cancelEventDelivery","summary":"Cancel an event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/lease":{"post":{"operationId":"renewEventDeliveryLease","summary":"Renew a claimed event delivery lease.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/release":{"post":{"operationId":"releaseEventDelivery","summary":"Release a claimed event delivery attempt back to queued.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/event-deliveries/{deliveryId}/update":{"post":{"operationId":"updateEventDelivery","summary":"Update an external event delivery attempt.","tags":["events"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/agents":{"get":{"operationId":"listAgents","summary":"List registered external agents.","tags":["agents"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"registerAgent","summary":"Register an external agent card.","tags":["agents"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/agents/{agentId}":{"get":{"operationId":"getAgent","summary":"Fetch a registered external agent.","tags":["agents"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/agents/match":{"post":{"operationId":"matchAgents","summary":"Match agents by domain and capabilities.","tags":["agents"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/agents/delegate":{"post":{"operationId":"delegateAgent","summary":"Create an A2A delegation plan.","tags":["agents"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connectors":{"get":{"operationId":"listConnectors","summary":"List registered BRIDGE connectors.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"registerConnector","summary":"Register a BRIDGE connector with scoped credential references.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connectors/ready":{"get":{"operationId":"listReadyConnectors","summary":"List Picux ready-made BRIDGE connector templates.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/connectors/{connectorId}":{"get":{"operationId":"getConnector","summary":"Fetch a registered BRIDGE connector.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/connectors/ready/install":{"post":{"operationId":"installReadyConnectors","summary":"Install Picux ready-made BRIDGE connector templates into the active connector registry.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connection-sessions":{"post":{"operationId":"createBridgeConnectionSession","summary":"Create a scoped BRIDGE connection session for client-owned adapter credentials and callbacks.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listBridgeConnectionSessions","summary":"List scoped BRIDGE connection sessions.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/connection-sessions/{sessionId}":{"get":{"operationId":"getBridgeConnectionSession","summary":"Fetch a scoped BRIDGE connection session.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/connection-sessions/{sessionId}/revoke":{"post":{"operationId":"revokeBridgeConnectionSession","summary":"Revoke a scoped BRIDGE connection session.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/actions":{"post":{"operationId":"createBridgeAction","summary":"Queue an adapter-neutral BRIDGE provider action and attach it to channel state.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listBridgeActions","summary":"List adapter-neutral BRIDGE provider actions.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/actions/{actionId}":{"get":{"operationId":"getBridgeAction","summary":"Fetch an adapter-neutral BRIDGE provider action.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/actions/{actionId}/update":{"post":{"operationId":"updateBridgeAction","summary":"Update BRIDGE provider action status, response, proof, or error state.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/actions/{actionId}/run":{"post":{"operationId":"runBridgeAction","summary":"Run a BRIDGE provider action through a Picux-hosted adapter or dispatch it to a client-hosted adapter.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/channels/threads":{"post":{"operationId":"createChannelThread","summary":"Create or upsert a durable cross-channel conversation thread.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listChannelThreads","summary":"List durable cross-channel conversation threads.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/channels/threads/{threadId}":{"get":{"operationId":"getChannelThread","summary":"Fetch a durable cross-channel conversation thread.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"threadId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/channels/threads/{threadId}/timeline":{"get":{"operationId":"channelThreadTimeline","summary":"Fetch a unified channel thread timeline across touchpoints, provider actions, and callbacks.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"threadId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/channels/touchpoints":{"post":{"operationId":"recordTouchpoint","summary":"Record an inbound, outbound, or internal touchpoint on a channel thread.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listTouchpoints","summary":"List channel touchpoints by thread, case, conversation, provider, or status.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/channels/touchpoints/{touchpointId}":{"get":{"operationId":"getTouchpoint","summary":"Fetch a channel touchpoint.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"touchpointId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/channels/callbacks":{"post":{"operationId":"ingestProviderCallback","summary":"Ingest a provider callback and reconcile it into channel state.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listProviderCallbacks","summary":"List normalized provider callbacks.","tags":["channels"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/sessions":{"post":{"operationId":"createPortalSession","summary":"Create a credential-reference-backed authenticated portal session.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listPortalSessions","summary":"List authenticated portal sessions.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/sessions/{portalSessionId}":{"get":{"operationId":"getPortalSession","summary":"Fetch an authenticated portal session.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"portalSessionId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/portal/sessions/{portalSessionId}/preflight":{"post":{"operationId":"preflightPortalSession","summary":"Check portal session credential, MFA, and target-scope readiness before authenticated browser work starts.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"portalSessionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/portal/actions":{"post":{"operationId":"createPortalAction","summary":"Create an authenticated portal action for record retrieval, form submission, or recovery steps.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listPortalActions","summary":"List authenticated portal actions.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/actions/{portalActionId}":{"get":{"operationId":"getPortalAction","summary":"Fetch an authenticated portal action.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"portalActionId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/portal/templates":{"get":{"operationId":"listPortalActionTemplates","summary":"List reusable authenticated portal action templates.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/templates/{templateId}":{"get":{"operationId":"getPortalActionTemplate","summary":"Fetch a reusable authenticated portal action template.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/portal/playbooks":{"get":{"operationId":"listPortalPlaybooks","summary":"List merchant, carrier, and utility portal recovery playbooks.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/playbooks/{playbookId}":{"get":{"operationId":"getPortalPlaybook","summary":"Fetch a portal recovery playbook.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/bridge/portal/playbooks/{playbookId}/instantiate":{"post":{"operationId":"instantiatePortalPlaybook","summary":"Instantiate a portal recovery playbook into queued portal actions.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/portal/actions/{portalActionId}/run":{"post":{"operationId":"runPortalAction","summary":"Run an authenticated portal action through the PortalBrowser tool.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"portalActionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connectors/match":{"post":{"operationId":"matchConnectors","summary":"Match BRIDGE connectors by capability and credential scope.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connectors/{connectorId}/preflight":{"post":{"operationId":"preflightConnector","summary":"Preflight a BRIDGE connector action with policy, scope, and secret checks.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/bridge/connectors/{connectorId}/update":{"post":{"operationId":"updateConnector","summary":"Update BRIDGE connector status or scope metadata.","tags":["bridge"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"connectorId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/proxy/missions":{"get":{"operationId":"listProxyMissions","summary":"List PROXY human-in-the-loop missions.","tags":["proxy"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createProxyMission","summary":"Request human intervention and suspend RESOLVE until PROXY returns an outcome.","tags":["proxy"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/proxy/missions/{proxyId}":{"get":{"operationId":"getProxyMission","summary":"Fetch a PROXY human-in-the-loop mission.","tags":["proxy"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"proxyId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/proxy/missions/{proxyId}/outcome":{"post":{"operationId":"submitProxyMissionOutcome","summary":"Submit a PROXY outcome for a known mission.","tags":["proxy"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"proxyId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/proxy/outcomes":{"post":{"operationId":"submitProxyOutcome","summary":"Submit a PROXY outcome by proxy, request, provider, or connector callback reference.","tags":["proxy"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tasks":{"get":{"operationId":"listTasks","summary":"List Picux protocol tasks.","tags":["tasks"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createTask","summary":"Create a Picux protocol task.","tags":["tasks"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tasks/{taskId}":{"get":{"operationId":"getTask","summary":"Fetch a Picux protocol task.","tags":["tasks"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/tasks/{taskId}/update":{"post":{"operationId":"updateTask","summary":"Update a Picux protocol task.","tags":["tasks"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases":{"get":{"operationId":"listCases","summary":"List formal Picux case workspaces.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createCase","summary":"Create or upsert a formal Picux case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}":{"get":{"operationId":"getCase","summary":"Fetch a formal Picux case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/cases/{caseId}/update":{"post":{"operationId":"updateCase","summary":"Update case workspace status, metadata, or collaboration state.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/stakeholders":{"post":{"operationId":"addCaseStakeholder","summary":"Add a stakeholder to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/deadlines":{"post":{"operationId":"addCaseDeadline","summary":"Add a deadline to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/deadlines/review":{"post":{"operationId":"reviewCaseDeadlines","summary":"Review case deadlines and mark overdue open deadlines as missed.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/actions":{"post":{"operationId":"addCaseAction","summary":"Add a stakeholder-oriented action item to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listCaseActions","summary":"List stakeholder-oriented action items for a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/cases/{caseId}/actions/{actionId}/update":{"post":{"operationId":"updateCaseAction","summary":"Update a case action item status, owner, due date, or refs.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/events":{"post":{"operationId":"addCaseEvent","summary":"Append a status timeline event to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/timeline":{"get":{"operationId":"caseTimeline","summary":"Fetch a case workspace status timeline.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/cases/{caseId}/evidence":{"post":{"operationId":"addCaseEvidence","summary":"Attach evidence references to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/{caseId}/notes":{"post":{"operationId":"addCaseNote","summary":"Add a collaboration note to a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listCaseNotes","summary":"List collaboration notes for a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/cases/{caseId}/export":{"post":{"operationId":"exportCaseBundle","summary":"Export a portable evidence bundle for a case workspace.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"caseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/cases/ops/review":{"post":{"operationId":"reviewCaseOps","summary":"Review team work queues, SLA risk, and enterprise admin controls across cases.","tags":["cases"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/workflows/templates":{"get":{"operationId":"listWorkflowTemplates","summary":"List Picux flagship workflow templates.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/workflows/templates/{templateId}":{"get":{"operationId":"getWorkflowTemplate","summary":"Fetch a Picux workflow template.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/workflows/templates/{templateId}/run":{"post":{"operationId":"runWorkflowTemplate","summary":"Run a Picux workflow template.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/workflows/demos":{"get":{"operationId":"listWorkflowDemos","summary":"List proof-led public demo workflows.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/workflows/demos/{demoId}":{"get":{"operationId":"getWorkflowDemo","summary":"Fetch a proof-led public demo workflow.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"demoId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/workflows/demos/{demoId}/run":{"post":{"operationId":"runWorkflowDemo","summary":"Run a proof-led workflow demo.","tags":["workflows"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"demoId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/resolve/recovery/templates":{"get":{"operationId":"listRecoveryTemplates","summary":"List Resolve recovery templates for crypto and bank-transfer cases.","tags":["resolve"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/resolve/recovery/templates/{templateId}":{"get":{"operationId":"getRecoveryTemplate","summary":"Fetch a Resolve recovery template.","tags":["resolve"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/hunt/discover":{"post":{"operationId":"huntDiscover","summary":"Discover and rank HUNT telemetry.","tags":["hunt"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/resolve/scamTriage":{"post":{"operationId":"resolveScamTriage","summary":"Run Resolve scam and dispute triage.","tags":["resolve"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/tasks/{taskId}/resolve":{"post":{"operationId":"resolveTask","summary":"Resolve evidence for a Picux task.","tags":["resolve"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/mandates":{"get":{"operationId":"listMandates","summary":"List Picux mandate records.","tags":["mandates"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createMandate","summary":"Register a Picux mandate.","tags":["mandates"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/mandates/{mandateId}":{"get":{"operationId":"getMandate","summary":"Fetch a Picux mandate record.","tags":["mandates"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"mandateId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/mandates/{mandateId}/verify":{"post":{"operationId":"verifyMandate","summary":"Verify a Picux mandate.","tags":["mandates"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"mandateId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/rails":{"get":{"operationId":"listPayRails","summary":"List Picux PAY machine-payment rails.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pay/rails/{railId}":{"get":{"operationId":"getPayRail","summary":"Fetch a Picux PAY machine-payment rail.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"railId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/pay/challenges":{"post":{"operationId":"createPaymentChallenge","summary":"Create a machine-payment challenge for a protected resource.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/challenges/{challengeId}/verify":{"post":{"operationId":"verifyPaymentChallenge","summary":"Verify a machine-payment credential for a PAY challenge.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/sessions":{"post":{"operationId":"createPaymentSession","summary":"Create a bounded machine-payment session.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/sessions/{sessionId}/authorize":{"post":{"operationId":"authorizePaymentSession","summary":"Authorize a machine-payment session.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/sessions/{sessionId}/consume":{"post":{"operationId":"consumePaymentSession","summary":"Record usage against a machine-payment session.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/sessions/{sessionId}/close":{"post":{"operationId":"closePaymentSession","summary":"Close a machine-payment session.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/local/resources/{resourceId}":{"post":{"operationId":"runLocalPaidResource","summary":"Run a local paid resource through the Picux PAY 402 loop.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"resourceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows":{"post":{"operationId":"createEscrow","summary":"Create a Picux PAY escrow.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}},"get":{"operationId":"listEscrows","summary":"List Picux PAY escrow records.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pay/escrows/{escrowId}":{"get":{"operationId":"getEscrow","summary":"Fetch a Picux PAY escrow record.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/pay/escrows/{escrowId}/update":{"post":{"operationId":"updateEscrow","summary":"Update a Picux PAY escrow record.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows/{escrowId}/fund":{"post":{"operationId":"fundEscrow","summary":"Mark a Picux PAY escrow as funded.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows/{escrowId}/proof":{"post":{"operationId":"submitEscrowProof","summary":"Attach proof-of-utility evidence to a Picux PAY escrow.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows/{escrowId}/settle":{"post":{"operationId":"settleEscrow","summary":"Settle a Picux PAY escrow after proof verification.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows/{escrowId}/refund":{"post":{"operationId":"refundEscrow","summary":"Refund a Picux PAY escrow.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/escrows/{escrowId}/dispute":{"post":{"operationId":"disputeEscrow","summary":"Open a dispute against a Picux PAY escrow.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/adapters/contract":{"get":{"operationId":"settlementAdapterContract","summary":"Return the Picux PAY settlement adapter contract.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pay/adapters":{"get":{"operationId":"listPayAdapters","summary":"List Picux PAY rail adapter scaffolds.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pay/adapters/{adapterId}":{"get":{"operationId":"getPayAdapter","summary":"Fetch a Picux PAY rail adapter scaffold.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"adapterId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/pay/adapters/{adapterId}/invoke":{"post":{"operationId":"invokePayAdapter","summary":"Invoke a concrete Picux PAY rail adapter action.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"adapterId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/reputation":{"get":{"operationId":"listReputationCards","summary":"List PAY reputation cards.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"updateReputationCard","summary":"Update a PAY reputation card.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/reputation/{cardId}":{"get":{"operationId":"getReputationCard","summary":"Fetch a PAY reputation card.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"cardId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/pay/prepare":{"post":{"operationId":"prepareSettlement","summary":"Prepare a PAY settlement instruction for an external adapter.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/pay/settle":{"post":{"operationId":"settle","summary":"Settle a Picux PAY request.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/receipts":{"get":{"operationId":"listReceipts","summary":"List settlement receipts.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/receipts/{receiptId}":{"get":{"operationId":"getReceipt","summary":"Fetch a settlement receipt.","tags":["pay"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/audit/proofPacks/{packId}":{"get":{"operationId":"getProofPack","summary":"Fetch a portable proof pack.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"packId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/audit/proofPacks":{"get":{"operationId":"listProofPacks","summary":"List portable proof packs.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createProofPack","summary":"Create a shareable proof pack from evidence, decisions, and outcomes.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/audit/evidence/{artifactId}":{"get":{"operationId":"getEvidence","summary":"Fetch a recorded evidence artifact.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/audit/evidence":{"get":{"operationId":"listEvidence","summary":"List evidence artifacts.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"recordEvidence","summary":"Record a content-addressed evidence artifact.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/audit/pov/{povId}":{"get":{"operationId":"getPov","summary":"Fetch a proof-of-value record.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"povId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/audit/pov":{"get":{"operationId":"listPov","summary":"List proof-of-value records.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"recordPov","summary":"Record a proof-of-value chain entry.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/audit/receipts/verify":{"post":{"operationId":"verifyReceipt","summary":"Verify a PAY receipt against proof-of-value.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/audit/chain/verify":{"post":{"operationId":"verifyChain","summary":"Verify proof-of-value chain continuity.","tags":["audit"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/signals/community":{"get":{"operationId":"listCommunitySignals","summary":"List durable community signal records.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"communitySignal","summary":"Ingest a community signal.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/signals/community/{signalId}":{"get":{"operationId":"getCommunitySignal","summary":"Fetch a durable community signal record.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"signalId","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/signals/community/analyze":{"post":{"operationId":"analyzeCommunitySignal","summary":"Analyze a community signal.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/signals/community/launch-task":{"post":{"operationId":"launchCommunityTask","summary":"Launch an approval-gated task from a community signal.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnyObject"}}}}}},"/v1/signals/community/entities":{"get":{"operationId":"communityEntities","summary":"List community signal entities.","tags":["signals"],"responses":{"200":{"description":"Patchr response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ok"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AnyObject":{"type":"object","additionalProperties":true},"Ok":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}},"additionalProperties":true},"Error":{"type":"object","required":["ok","error"],"properties":{"ok":{"const":false},"error":{"type":"string"}},"additionalProperties":true}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}