{"openapi":"3.1.0","info":{"title":"AgentOS ASP","version":"1.0.0","description":"Wallet-isolated OKX x402 REST services. The first successful paid business operation returns the no-expiry bearer token at no additional cost. AgentPhone recordings are not collected or exposed."},"servers":[{"url":"https://api.hostbyme.online"}],"externalDocs":{"description":"Agent operating guide","url":"/docs"},"paths":{"/api/v1":{"get":{"summary":"Discover services, fixed prices, and guide links","responses":{"200":{"description":"Service catalog"}},"x-agentos-service-id":"discovery.api","x-agentos-fixed-price":"free","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#discovery"}},"/api/v1/services":{"get":{"summary":"List the canonical AgentOS service catalog","responses":{"200":{"description":"Canonical service catalog"}},"x-agentos-service-id":"discovery.services","x-agentos-fixed-price":"free","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#service-catalog"}},"/api/v1/services/{serviceId}":{"get":{"summary":"Get one canonical AgentOS service","parameters":[{"in":"path","name":"serviceId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Service record"},"404":{"description":"Unknown service ID"}}}},"/api/v1/email/mailboxes":{"post":{"summary":"Create a real Resend-backed mailbox","security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"localPart":{"type":"string","description":"Mailbox local part"},"displayName":{"type":"string"},"outboundSignature":{"type":"string"}},"required":["localPart"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.25 USDT","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.mailbox.create","x-agentos-start-here":true,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/email/mailboxes/query":{"get":{"summary":"List owned mailboxes","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.mailbox.list","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/email/mailboxes/update":{"post":{"summary":"Update one owned mailbox","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"mailboxId":{"type":"string"},"displayName":{"type":"string"},"outboundSignature":{"type":"string"},"active":{"type":"boolean"}},"required":["mailboxId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.01 USDT","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.mailbox.update","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/email/mailboxes/delete":{"post":{"summary":"Delete one owned mailbox","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"mailboxId":{"type":"string"}},"required":["mailboxId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.01 USDT","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.mailbox.delete","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/email/messages/send":{"post":{"summary":"Send a real email through Resend","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"mailboxId":{"type":"string"},"to":{"type":"array","items":{"type":"string","format":"email"}},"cc":{"type":"array","items":{"type":"string","format":"email"}},"bcc":{"type":"array","items":{"type":"string","format":"email"}},"subject":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"}},"required":["mailboxId","to","subject","text"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.02 USDT","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.message.send","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/email/messages/query":{"get":{"summary":"Query owned email messages","security":[{"bearerAuth":[]}],"parameters":[{"in":"query","name":"mailboxId","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"messageId","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#email-flow","x-agentos-service-id":"email.message.query","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/phone/purchase-us-number-30-days":{"post":{"summary":"Purchase a US AgentPhone number for 30 days","security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"agentName":{"type":"string"},"agentWebhookUrl":{"type":"string","format":"uri","pattern":"^https://"},"areaCode":{"type":"string","pattern":"^[0-9]{3}$"},"description":{"type":"string"},"beginMessage":{"type":"string"},"voice":{"type":"string"},"language":{"type":"string"}},"required":["agentName","agentWebhookUrl"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"5.00 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.number.us.30d","x-agentos-start-here":true,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/purchase-canada-number-30-days":{"post":{"summary":"Purchase a Canadian AgentPhone number for 30 days","security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"agentName":{"type":"string"},"agentWebhookUrl":{"type":"string","format":"uri","pattern":"^https://"},"areaCode":{"type":"string","pattern":"^[0-9]{3}$"},"description":{"type":"string"},"beginMessage":{"type":"string"},"voice":{"type":"string"},"language":{"type":"string"}},"required":["agentName","agentWebhookUrl"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"5.00 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.number.ca.30d","x-agentos-start-here":true,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/renew-number-30-days":{"post":{"summary":"Renew one active number for another 30 days","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phoneNumberId":{"type":"string","format":"uuid"}},"required":["phoneNumberId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"5.00 USDT","x-agentos-guide":"/docs#number-renewal","x-agentos-service-id":"phone.number.renew.30d","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/call-1-minute":{"post":{"summary":"Start an outbound call authorized for up to 60 connected seconds","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phoneNumberId":{"type":"string","format":"uuid"},"toNumber":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"initialGreeting":{"type":"string"}},"required":["phoneNumberId","toNumber"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.30 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.outbound.1m","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/call-5-minutes":{"post":{"summary":"Start an outbound call authorized for up to 300 connected seconds","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phoneNumberId":{"type":"string","format":"uuid"},"toNumber":{"type":"string","pattern":"^\\+[1-9][0-9]{6,14}$"},"initialGreeting":{"type":"string"}},"required":["phoneNumberId","toNumber"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"1.50 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.outbound.5m","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/extend-call-1-minute":{"post":{"summary":"Extend an active answered call by 60 seconds","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"callId":{"type":"string","format":"uuid"}},"required":["callId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"0.30 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.extend.1m","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/add-inbound-minutes-10":{"post":{"summary":"Add 600 inbound seconds to an owned active number","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}},{"in":"header","name":"PAYMENT-SIGNATURE","required":false,"schema":{"type":"string"},"description":"Absent on the challenge request; required on the paid replay."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phoneNumberId":{"type":"string","format":"uuid"}},"required":["phoneNumberId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"3.00 USDT","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.inbound.add.10m","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":true}},"/api/v1/phone/release-number":{"post":{"summary":"Irreversibly release one owned AgentPhone number","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phoneNumberId":{"type":"string","format":"uuid"},"confirmRelease":{"type":"boolean","const":true}},"required":["phoneNumberId","confirmRelease"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#number-renewal","x-agentos-service-id":"phone.number.release","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/phone/numbers":{"get":{"summary":"List owned phone numbers and entitlement state","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.number.list","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/phone/calls/{callId}":{"get":{"summary":"Read one owned call","security":[{"bearerAuth":[]}],"parameters":[{"in":"path","name":"callId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.get","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/phone/calls/{callId}/transcript":{"get":{"summary":"Read the transcript for one owned call","security":[{"bearerAuth":[]}],"parameters":[{"in":"path","name":"callId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#phone-flow","x-agentos-service-id":"phone.call.transcript","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/events":{"get":{"summary":"Replay pending durable events","security":[{"bearerAuth":[]}],"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs"}},"/api/v1/events/realtime-token":{"get":{"summary":"Get a short-lived RLS-scoped Realtime JWT and replay pending events","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#websocket-protocol","x-agentos-service-id":"events.realtime-token","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false}},"/api/v1/events/list":{"post":{"summary":"List durable events with tenant-scoped filters and cursor pagination","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["pending","delivered","acknowledged","expired","failed"]},"types":{"type":"array","items":{"type":"string"}},"agentId":{"type":"string"},"service":{"type":"string"},"resourceId":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}},"required":[]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-service-id":"events.list","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#event-delivery"}},"/api/v1/events/get":{"post":{"summary":"Get one tenant-owned durable event","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"eventId":{"type":"string","format":"uuid"}},"required":["eventId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-service-id":"events.get","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#event-delivery"}},"/api/v1/events/ack":{"post":{"summary":"Idempotently acknowledge one tenant-owned durable event","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"eventId":{"type":"string","format":"uuid"}},"required":["eventId"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-service-id":"events.ack","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#event-delivery"}},"/api/v1/events/ack-all":{"post":{"summary":"Acknowledge matching tenant events up to an explicit cutoff","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"before":{"type":"string","format":"date-time"},"types":{"type":"array","items":{"type":"string"}},"service":{"type":"string"}},"required":["before"]}}}},"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free","x-agentos-service-id":"events.ack-all","x-agentos-start-here":false,"x-agentos-available":true,"x-agentos-register-on-okx":false,"x-agentos-guide":"/docs#event-delivery"}},"/api/v1/events/{eventId}/acknowledge":{"post":{"summary":"Acknowledge a durably handled event","security":[{"bearerAuth":[]}],"parameters":[{"in":"path","name":"eventId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Operation completed"},"201":{"description":"Operation completed"},"400":{"description":"Invalid request"},"401":{"description":"Bearer token missing or invalid"},"402":{"description":"OKX x402 payment required","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"Conflict or idempotency conflict"},"428":{"description":"ONBOARDING_REQUIRED; no payment was settled"},"502":{"description":"Real provider operation failed"},"503":{"description":"Required provider or infrastructure configuration unavailable"}},"x-agentos-fixed-price":"free"}},"/api/v1/domains/register":{"post":{"summary":"Disabled until fixed per-TLD services and stable Namecheap egress are configured","deprecated":true,"responses":{"503":{"description":"Service intentionally not listed"}},"x-agentos-fixed-price":"free","x-agentos-guide":"/docs#domain-flow","x-agentos-service-id":"domain.register","x-agentos-start-here":true,"x-agentos-available":false,"x-agentos-register-on-okx":false}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque at_v1 token"}}},"x-agentos-guides":{"docs":"/docs","llms":"/llms.txt","openapi":"/openapi.json"}}