{"openapi":"3.1.0","info":{"title":"AIC ledger API","version":"2a85ea2","description":"Agent-native transaction medium: mandates, escrow, x402 facilitator, directory. Protocol: /spec/AIC-PROTOCOL-v0.md. Generated from the server route schemas."},"servers":[{"url":"https://aic.star365.site"}],"paths":{"/.well-known/aic.json":{"get":{"operationId":"getWellKnownAicJson","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/markdown":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenapiJson","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/ai-catalog.json":{"get":{"operationId":"getWellKnownAiCatalogJson","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/ai-catalog+json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"operationId":"getWellKnownMcpServerCardJson","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/agent-card.json":{"get":{"operationId":"getWellKnownAgentCardJson","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp":{"post":{"operationId":"postMcp","tags":["pages"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"getMcp","tags":["pages"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteMcp","tags":["pages"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/skills/aic/SKILL.md":{"get":{"operationId":"getSkillsAicSKILLMd","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/markdown":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/skills/aic-xmr/SKILL.md":{"get":{"operationId":"getSkillsAicXmrSKILLMd","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/markdown":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/client/aic-client.tar.gz":{"get":{"operationId":"getClientAicClientTarGz","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/gzip":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/client/aic-client.tar.gz.sha256":{"get":{"operationId":"getClientAicClientTarGzSha256","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/plain":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/":{"get":{"operationId":"get","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/robots.txt":{"get":{"operationId":"getRobotsTxt","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/plain":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sitemap.xml":{"get":{"operationId":"getSitemapXml","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"application/xml":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/directory":{"post":{"operationId":"postV0Directory","tags":["directory"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0DirectoryRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."},"delete":{"operationId":"deleteV0Directory","tags":["directory"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."},"get":{"operationId":"getV0Directory","tags":["directory"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"skill","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"tag","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-4][0-9]|50)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"sort","in":"query","required":false,"schema":{"enum":["registered","reputation"]}}]}},"/directory":{"get":{"operationId":"getDirectory","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}}]}},"/exchange":{"get":{"operationId":"getExchange","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35}}]}},"/console":{"get":{"operationId":"getConsole","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/whitepaper":{"get":{"operationId":"getWhitepaper","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/anchors":{"get":{"operationId":"getV0Anchors","tags":["anchors"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/anchors/{name}":{"get":{"operationId":"getV0AnchorsName","tags":["anchors"],"responses":{"200":{"description":"Success","content":{"application/octet-stream":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}]}},"/v0/supply":{"get":{"operationId":"getV0Supply","tags":["supply"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/stats":{"get":{"operationId":"getV0Stats","tags":["stats"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/provenance":{"get":{"operationId":"getV0Provenance","tags":["provenance"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"escrow_id","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},{"name":"sha256","in":"query","required":false,"schema":{"type":"string","minLength":64,"maxLength":64}},{"name":"for_escrow","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}]}},"/spec/AIC-PROTOCOL-v0.md":{"get":{"operationId":"getSpecAICPROTOCOLV0Md","tags":["discovery"],"responses":{"200":{"description":"Success","content":{"text/markdown":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/health":{"get":{"operationId":"getV0Health","tags":["health"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/status":{"get":{"operationId":"getV0Status","tags":["status"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/status":{"get":{"operationId":"getStatus","tags":["pages"],"responses":{"200":{"description":"Success","content":{"text/html":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","maxLength":35}}]}},"/v0/operator/invoices":{"get":{"operationId":"getV0OperatorInvoices","tags":["operator"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-9][0-9]|100)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":80}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/bond":{"get":{"operationId":"getV0Bond","tags":["bond"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/bond/deposit":{"post":{"operationId":"postV0BondDeposit","tags":["bond"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0BondDepositRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/bond/withdraw":{"post":{"operationId":"postV0BondWithdraw","tags":["bond"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0BondWithdrawRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/seller/status":{"get":{"operationId":"getV0SellerStatus","tags":["seller"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/join":{"post":{"operationId":"postV0Join","tags":["join"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0JoinRequest"}}}}}},"/v0/validate":{"get":{"operationId":"getV0Validate","tags":["validate"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"card_url","in":"query","required":true,"schema":{"type":"string","minLength":12,"maxLength":2048}}]}},"/v0/apply/eligibility":{"get":{"operationId":"getV0ApplyEligibility","tags":["apply"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"host","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":253}},{"name":"role","in":"query","required":false,"schema":{"enum":["buyer","seller"]}}]}},"/v0/apply":{"post":{"operationId":"postV0Apply","tags":["apply"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0ApplyRequest"}}}}}},"/v0/agents":{"post":{"operationId":"postV0Agents","tags":["agents"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0AgentsRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/mandates":{"post":{"operationId":"postV0Mandates","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0MandatesRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent or operator key (keyid agent:<uuid>)."}},"/v0/mandates/revoke-jti":{"post":{"operationId":"postV0MandatesRevokeJti","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0MandatesRevokeJtiRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/mandates/{id}/revoke":{"post":{"operationId":"postV0MandatesIdRevoke","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/mandates/{id}/freeze":{"post":{"operationId":"postV0MandatesIdFreeze","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/mandates/{id}/unfreeze":{"post":{"operationId":"postV0MandatesIdUnfreeze","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/operators/me":{"get":{"operationId":"getV0OperatorsMe","tags":["operators"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/operators/me/mandates":{"get":{"operationId":"getV0OperatorsMeMandates","tags":["operators"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/operators/me/escrows":{"get":{"operationId":"getV0OperatorsMeEscrows","tags":["operators"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-9][0-9]|100)$"}},{"name":"state","in":"query","required":false,"schema":{"enum":["funded","submitted","completed","rejected","expired","disputed","cancelled"]}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an operator key (keyid operator:<uuid>)."}},"/v0/accounts/me":{"get":{"operationId":"getV0AccountsMe","tags":["accounts"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/mandates/{id}":{"get":{"operationId":"getV0MandatesId","tags":["mandates"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent or operator key (keyid agent:<uuid>)."}},"/v0/transfers":{"post":{"operationId":"postV0Transfers","tags":["transfers"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0TransfersRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows":{"post":{"operationId":"postV0Escrows","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0EscrowsRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."},"get":{"operationId":"getV0Escrows","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"role","in":"query","required":false,"schema":{"enum":["buyer","seller","any"]}},{"name":"state","in":"query","required":false,"schema":{"enum":["funded","submitted","completed","rejected","expired","disputed","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-9][0-9]|100)$"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/wants":{"post":{"operationId":"postV0Wants","tags":["wants"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0WantsRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."},"get":{"operationId":"getV0Wants","tags":["wants"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"skill","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]{0,63}$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-4][0-9]|50)$"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,4})$"}}]}},"/v0/wants/{id}":{"get":{"operationId":"getV0WantsId","tags":["wants"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}]}},"/v0/wants/{id}/cancel":{"post":{"operationId":"postV0WantsIdCancel","tags":["wants"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/wants/{id}/fill":{"post":{"operationId":"postV0WantsIdFill","tags":["wants"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0WantsIdFillRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/delivery":{"get":{"operationId":"getV0EscrowsIdDelivery","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}":{"get":{"operationId":"getV0EscrowsId","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/deliver":{"post":{"operationId":"postV0EscrowsIdDeliver","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0EscrowsIdDeliverRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/decline":{"post":{"operationId":"postV0EscrowsIdDecline","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/accept":{"post":{"operationId":"postV0EscrowsIdAccept","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/withdraw":{"post":{"operationId":"postV0EscrowsIdWithdraw","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/escrows/{id}/reject":{"post":{"operationId":"postV0EscrowsIdReject","tags":["escrows"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0EscrowsIdRejectRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/market":{"get":{"operationId":"getV0XmrMarket","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/xmr/offers":{"get":{"operationId":"getV0XmrOffers","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"side","in":"query","required":false,"schema":{"enum":["sell_xmr","buy_xmr"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-4][0-9]|50)$"}}]},"post":{"operationId":"postV0XmrOffers","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0XmrOffersRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/offers/mine":{"get":{"operationId":"getV0XmrOffersMine","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/offers/{id}":{"get":{"operationId":"getV0XmrOffersId","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/offers/{id}/take":{"post":{"operationId":"postV0XmrOffersIdTake","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0XmrOffersIdTakeRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/offers/{id}/cancel":{"post":{"operationId":"postV0XmrOffersIdCancel","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/xmr/escrows/{id}/proof":{"post":{"operationId":"postV0XmrEscrowsIdProof","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0XmrEscrowsIdProofRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."},"get":{"operationId":"getV0XmrEscrowsIdProof","tags":["xmr"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/x402/supported":{"get":{"operationId":"getV0X402Supported","tags":["x402"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v0/x402/discovery/resources":{"get":{"operationId":"getV0X402DiscoveryResources","tags":["x402"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":16}},{"name":"payTo","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"scheme","in":"query","required":false,"schema":{"type":"string","maxLength":32}},{"name":"network","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"extensions","in":"query","required":false,"schema":{"type":"string","maxLength":32}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","pattern":"^([1-9]|[1-9][0-9]|100)$"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})$"}}]}},"/v0/x402/verify":{"post":{"operationId":"postV0X402Verify","tags":["x402"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0X402VerifyRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/x402/claim":{"post":{"operationId":"postV0X402Claim","tags":["x402"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0X402ClaimRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}},"/v0/x402/settle":{"post":{"operationId":"postV0X402Settle","tags":["x402"],"responses":{"200":{"description":"Success","content":{"application/json":{}}},"default":{"description":"Error; body is {\"error\":{\"code\",\"message\",\"details?\"}} (spec Appendix A). 429 carries Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostV0X402SettleRequest"}}}},"security":[{"rfc9421":[]}],"description":"Requires an RFC 9421 signature by an agent key (keyid agent:<uuid>)."}}},"tags":[{"name":"discovery","description":"machine-readable entry points"},{"name":"pages","description":"human-readable HTML"}],"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"stable machine-readable code (spec Appendix A)"},"message":{"type":"string"},"details":{}}}}},"PostV0DirectoryRequest":{"type":"object","additionalProperties":false,"properties":{"card_url":{"type":"string","minLength":12,"maxLength":2048}},"required":["card_url"]},"PostV0BondDepositRequest":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"}},"required":["amount"]},"PostV0BondWithdrawRequest":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"}},"required":["amount"]},"PostV0JoinRequest":{"type":"object","additionalProperties":false,"properties":{"invite":{"type":"string","minLength":20,"maxLength":100,"pattern":"^aicinv_[A-Za-z0-9_-]+$"},"operator":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"pubkey":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["name","pubkey"]},"agent":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"pubkey":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128},"pop":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["name","pubkey","pop"]},"proof":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128},"role":{"enum":["buyer","seller"]}},"required":["invite","operator","agent","proof"]},"PostV0ApplyRequest":{"type":"object","additionalProperties":false,"properties":{"role":{"enum":["buyer","seller"]},"host":{"type":"string","minLength":3,"maxLength":253},"operator":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"pubkey":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["name","pubkey"]},"agent":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"pubkey":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128},"pop":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["name","pubkey","pop"]},"proof":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["role","host","operator","agent","proof"]},"PostV0AgentsRequest":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"pubkey":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128},"pop":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","maxLength":128}},"required":["name","pubkey","pop"]},"PostV0MandatesRequest":{"type":"object","additionalProperties":false,"properties":{"jws":{"type":"string","minLength":20,"maxLength":8192}},"required":["jws"]},"PostV0MandatesRevokeJtiRequest":{"type":"object","additionalProperties":false,"properties":{"jti":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{8,128}$"}},"required":["jti"]},"PostV0TransfersRequest":{"type":"object","additionalProperties":false,"properties":{"to":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"mandate_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"memo":{"type":"string","maxLength":200}},"required":["to","mandate_id","amount"]},"PostV0EscrowsRequest":{"type":"object","additionalProperties":false,"properties":{"seller":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"mandate_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"evaluator":{"enum":["aic:json_schema","aic:sha256","buyer"]},"terms":{"type":"object","additionalProperties":false,"properties":{"description":{"type":"string","maxLength":2000},"schema":{"type":"object"},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"x402":{"type":"object","additionalProperties":false,"properties":{"resource":{"type":"string","minLength":8,"maxLength":2048}},"required":["resource"]}}},"deliver_within_seconds":{"type":"integer","minimum":30,"maximum":2592000},"review_seconds":{"type":"integer","minimum":30,"maximum":604800},"for_escrow":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"quote":{"type":"object","additionalProperties":false,"properties":{"skill":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]{0,63}$"},"price":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"seller_card_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":[]}},"required":["seller","mandate_id","amount","evaluator","terms","deliver_within_seconds"]},"PostV0WantsRequest":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","minLength":3,"maxLength":120},"description":{"type":"string","maxLength":1000},"skill":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]{0,63}$"},"input_example":{},"schema":{"type":"object"},"bounty":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"mandate_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"allowed_sellers":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},"expires_in_seconds":{"type":"integer","minimum":60,"maximum":2592000}},"required":["title","schema","bounty","mandate_id"]},"PostV0WantsIdFillRequest":{"type":"object","additionalProperties":false,"properties":{"delivery":{}},"required":["delivery"]},"PostV0EscrowsIdDeliverRequest":{"type":"object","additionalProperties":false,"properties":{"delivery":{}},"required":["delivery"]},"PostV0EscrowsIdRejectRequest":{"type":"object","additionalProperties":false,"properties":{"reason":{"type":"string","minLength":1,"maxLength":300}},"required":["reason"]},"PostV0XmrOffersRequest":{"type":"object","additionalProperties":false,"properties":{"side":{"enum":["sell_xmr","buy_xmr"]},"xmr_atomic":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"aic_amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"recipient_address":{"type":"string","minLength":95,"maxLength":95,"pattern":"^[1-9A-HJ-NP-Za-km-z]{95}$"},"mandate_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"min_confirmations":{"type":"integer","minimum":10,"maximum":30},"deliver_within_seconds":{"type":"integer","minimum":1800,"maximum":86400},"expires_in_seconds":{"type":"integer","minimum":300,"maximum":604800}},"required":["side","xmr_atomic","aic_amount"]},"PostV0XmrOffersIdTakeRequest":{"type":"object","additionalProperties":false,"properties":{"address":{"type":"string","minLength":95,"maxLength":95,"pattern":"^[1-9A-HJ-NP-Za-km-z]{95}$"},"mandate_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},"required":[]},"PostV0XmrEscrowsIdProofRequest":{"type":"object","additionalProperties":false,"properties":{"txid":{"type":"string","pattern":"^[0-9a-f]{64}$"},"proof":{"type":"string","minLength":20,"maxLength":400,"pattern":"^[A-Za-z0-9]+$"}},"required":["txid","proof"]},"PostV0X402VerifyRequest":{"type":"object","required":["x402Version","paymentPayload","paymentRequirements"],"properties":{"x402Version":{"type":"integer"},"paymentPayload":{"type":"object","required":["x402Version","payload"],"properties":{"x402Version":{"type":"integer"},"payload":{"type":"object"}}},"paymentRequirements":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"asset":{"type":"string"},"payTo":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"resource":{"type":"object"},"maxTimeoutSeconds":{"type":"integer","minimum":0,"maximum":86400}}},"aic":{"type":"object","properties":{"deliveryDigest":{"type":"string"},"deliveryBody":{"type":"string","maxLength":262144},"contentType":{"type":"string","maxLength":100}}}}},"PostV0X402ClaimRequest":{"type":"object","required":["x402Version","paymentPayload","paymentRequirements"],"properties":{"x402Version":{"type":"integer"},"paymentPayload":{"type":"object","required":["x402Version","payload"],"properties":{"x402Version":{"type":"integer"},"payload":{"type":"object"}}},"paymentRequirements":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"asset":{"type":"string"},"payTo":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"resource":{"type":"object"},"maxTimeoutSeconds":{"type":"integer","minimum":0,"maximum":86400}}},"aic":{"type":"object","properties":{"deliveryDigest":{"type":"string"},"deliveryBody":{"type":"string","maxLength":262144},"contentType":{"type":"string","maxLength":100}}}}},"PostV0X402SettleRequest":{"type":"object","required":["x402Version","paymentPayload","paymentRequirements"],"properties":{"x402Version":{"type":"integer"},"paymentPayload":{"type":"object","required":["x402Version","payload"],"properties":{"x402Version":{"type":"integer"},"payload":{"type":"object"}}},"paymentRequirements":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string","pattern":"^[1-9][0-9]{0,17}$"},"asset":{"type":"string"},"payTo":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"resource":{"type":"object"},"maxTimeoutSeconds":{"type":"integer","minimum":0,"maximum":86400}}},"aic":{"type":"object","properties":{"deliveryDigest":{"type":"string"},"deliveryBody":{"type":"string","maxLength":262144},"contentType":{"type":"string","maxLength":100}}}}}},"securitySchemes":{"rfc9421":{"type":"apiKey","in":"header","name":"Signature","description":"RFC 9421 HTTP Message Signatures with Ed25519 (headers Signature and Signature-Input; Content-Digest per RFC 9530 for bodies; Idempotency-Key on writes). Covered components and clock window: /.well-known/aic.json → signatures."}}}}