{"openapi":"3.1.0","info":{"title":"AgentToolbox catalog","version":"1.0.0","description":"One registry for HTTP, MCP and HTML. Current active product count: 4. Prices and availability are per product."},"servers":[{"url":"https://agi.agenttoolbox2026.workers.dev"}],"paths":{"/v1/products":{"get":{"operationId":"listProducts","summary":"Find products; active only by default.","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"status","in":"query","schema":{"type":"string","enum":["active","validation","retired","all"],"default":"active"}}],"responses":{"200":{"description":"Catalog. Empty products means no match.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}":{"get":{"operationId":"getProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"responses":{"200":{"description":"Versioned contract, including retired metadata.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/invoke":{"post":{"operationId":"invokeProduct","description":"Paid HTTP uses x402 v2 exact USDC on Base. Direct minimum-price calls need no quote or preparation; omit payment_amount_atomic and use the disclosed minimum as max_charge_usdc_atomic. Higher optional amounts and prepared results require a quote. All product outcomes validate before settlement. Reuse identical body/key/authorization for replay within 24 hours. Retired returns 410; unresolved settlement requires reconciliation, never a new authorization. Unsigned bounded probes receive 402 before JSON/input validation and do no product work. Signed requests validate before execution. Live payment remains unverified.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload only when explicitly required by the product."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},"max_charge_usdc_atomic":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},{"type":"integer","minimum":0,"maximum":9007199254740991}],"description":"Caller spending cap. Canonical decimal string recommended; safe integer numbers accepted for compatibility. Does not select an amount."},"agent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Optional random UUID pseudonym (e.g. crypto.randomUUID()); not authenticated identity. Omit if unavailable."},"review_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 hex of caller-kept atbr_ secret (32 random bytes). Bound to this paid request; never send the raw secret here."},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","max_charge_usdc_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Completed validated result and payment receipt.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required only for configured paid products; see PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"discoverProductPayment","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"discoverProductPaymentHeaders","description":"Same read-only challenge status and headers as GET, without a response body.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/runs/{id}/outcome":{"post":{"operationId":"reportOutcome","description":"Self-reported usefulness for a completed run. Does not trigger, prove or reverse payments.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"outcome":{"type":"string","enum":["success","failure","unverifiable"]}},"required":["outcome"],"additionalProperties":false}}}},"responses":{"200":{"description":"Idempotent outcome acknowledgment.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/feedback":{"post":{"operationId":"leaveFeedback","description":"Bounded, private-to-owner self-reported feedback. Optional rating, outcome, helpfulness, task and message. Possession of an execution ID links to a matching server record, not identity. No payment effect or public feedback listing. Do not include secrets. At least one feedback field is required.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product_id":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"version":{"type":"string","maxLength":32,"pattern":"^\\d+\\.\\d+\\.\\d+$"},"reference":{"type":"object","properties":{"kind":{"type":"string","enum":["example","purchase","run"]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["kind","id"],"additionalProperties":false},"rating":{"type":"integer","minimum":1,"maximum":5},"outcome":{"type":"string","enum":["success","failure","unverifiable"]},"helpful":{"type":"boolean"},"task_description":{"type":"string","minLength":1,"maxLength":1000},"message":{"type":"string","minLength":1,"maxLength":2000}},"required":["product_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Feedback acknowledgment with explicit linkage evidence.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp":{"post":{"summary":"MCP Streamable HTTP JSON-RPC; use an MCP client.","responses":{"200":{"description":"MCP response.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/x402":{"get":{"summary":"x402scan discovery version 1; absolute paid URLs and server-owned payment configuration. Payment transport remains x402 v2.","responses":{"200":{"description":"Configured payable routes only; empty when not configured.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/health":{"get":{"responses":{"200":{"description":"Liveness only, not a payment or database readiness guarantee.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/products/docs-pack/example":{"get":{"summary":"Run the fixed public example for free; no arbitrary inputs or purchase recorded.","description":"Returns a private example_id for feedback linkage. Optional Idempotency-Key permits one execution/replay for 24 hours. HEAD performs no execution.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}}],"responses":{"200":{"description":"Real Docs Pack output for the documented example.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/stats":{"get":{"summary":"Lifetime paid purchases, including repeats; not unique or verified agent identities.","responses":{"200":{"description":"Only completed live, non-synthetic purchases. No private metrics exposed.","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/prepare":{"post":{"operationId":"prepareProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}},{"name":"X-Preparation-Capability","in":"header","required":false,"schema":{"type":"string"},"description":"Required for preparation and prepared quotes. Private atbp_ capability, never in URLs."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"prepare_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."}},"required":["version","input","request_id","prepare_secret_hash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Durable bounded preview or quote; no settlement.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/quote":{"post":{"operationId":"quoteProduct","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}},{"name":"X-Preparation-Capability","in":"header","required":false,"schema":{"type":"string"},"description":"Required for preparation and prepared quotes. Private atbp_ capability, never in URLs."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","payment_amount_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Durable bounded preview or quote; no settlement.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/criteria":{"get":{"operationId":"getProductCriteria","description":"Exact success contract: hash canonical_json as UTF-8 with no trailing newline and compare sha256. The named canonicalization profile explains scalar encoding and recursive key sorting. Includes product/version, criteria, input/output schemas and limits. Pin with success_contract_sha256 in quote/invoke. No usefulness or certification guarantee.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"responses":{"200":{"description":"Product/version, criteria, limits, canonicalization, canonical_json and sha256.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/examples":{"get":{"operationId":"getProductExamples","description":"Free first-party offline fixtures: exact inputs, mocked source/RPC responses, expected checks and failure cases. No target fetch, invocation, payment or customer proof.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"responses":{"200":{"description":"Static independently checkable test cases and supported preview scope.","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/402index-verify.txt":{"get":{"summary":"Public 402 Index domain verification hash, only when configured. Never exposes the private verification token.","responses":{"200":{"description":"64 lowercase hex SHA-256 characters.","content":{"text/plain":{"schema":{"type":"string","pattern":"^[0-9a-f]{64}$"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/creator-terms":{"get":{"operationId":"getCreatorTerms","responses":{"200":{"description":"Frozen promotion terms and request budgets.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/referral-terms":{"get":{"operationId":"getReferralTerms","responses":{"200":{"description":"Frozen first-party-only 1% terms plus current owner-reviewed payout operations; no automatic transfers.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/referrals":{"post":{"operationId":"registerReferral","description":"Create a capability-controlled referral account. Reusing the same capability returns the same account. No wallet ownership or distinct-agent identity is verified. No transfer.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"terms_version":{"type":"string","const":"first-party-referrals-2026-10-07.v1"}},"required":["terms_version"],"additionalProperties":false}}}},"responses":{"200":{"description":"Public referral code and frozen terms.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/referrals/me":{"get":{"operationId":"getReferral","description":"Read private exact accrual and payout balances using the original capability. Requesting a payout does not transfer money; owner review and finalized receipt evidence are required.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"responses":{"200":{"description":"Frozen account terms, current payout operations and receipt-based balances.","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tool-submissions":{"post":{"operationId":"submitTool","description":"Private inert metadata only. Never fetched, executed or automatically published. Exact free-promotion terms must be accepted; retain identical request_id/body/capability for replay. No fee or transfer.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"creator_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"terms_version":{"type":"string","const":"creator-promo-2026-10-07.v1"},"proposal":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"summary":{"type":"string","minLength":1,"maxLength":1000},"endpoint_url":{"type":"string","maxLength":800,"description":"HTTPS proposal URL without credentials, query, fragment, explicit ports or local/IP hosts. Never fetched."},"input_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."},"output_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."}},"required":["name","summary","endpoint_url","input_schema","output_schema"],"additionalProperties":false}},"required":["request_id","creator_secret_hash","terms_version","proposal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private status and frozen terms, with no financial transfer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorSubmission"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tool-submissions/{id}":{"get":{"operationId":"getToolSubmission","description":"Read your private submission and its review decision with the original capability.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"responses":{"200":{"description":"Private proposal/status and decision for matching capability only.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorSubmission"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/creator-tools/{tool_id}":{"get":{"operationId":"getCreatorTool","description":"Private approved metadata/head and paginated immutable history. Original capability required; unknown/unapproved tools share the same 403. Metadata versions do not change installed execution or terms.","parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","pattern":"^creator-[0-9a-f-]{36}$"}},{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$"}}],"responses":{"200":{"description":"Approved metadata, original terms and next_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorTool"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/creator-tools/{tool_id}/updates":{"post":{"operationId":"submitToolUpdate","description":"Private inert versioned proposal for an approved tool. Original capability, base version and head revision required. Owner approval atomically advances only metadata; pending/rejected proposals retain the approved version and original 90% gross entitlement. No new fee or transfer. Identical replay survives a later head change.","parameters":[{"name":"tool_id","in":"path","required":true,"schema":{"type":"string","pattern":"^creator-[0-9a-f-]{36}$"}},{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"creator_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"terms_version":{"type":"string","minLength":1,"maxLength":80},"base_version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$","description":"Canonical major.minor.patch, each component 0–999999; metadata approval version, no prerelease/build suffix."},"expected_head_revision":{"type":"integer","minimum":0,"maximum":2147483646},"proposed_version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$","description":"Canonical major.minor.patch, each component 0–999999; metadata approval version, no prerelease/build suffix."},"proposal":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"summary":{"type":"string","minLength":1,"maxLength":1000},"endpoint_url":{"type":"string","maxLength":800,"description":"HTTPS proposal URL without credentials, query, fragment, explicit ports or local/IP hosts. Never fetched."},"input_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."},"output_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."}},"required":["name","summary","endpoint_url","input_schema","output_schema"],"additionalProperties":false}},"required":["request_id","creator_secret_hash","terms_version","base_version","expected_head_revision","proposed_version","proposal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private update status with original frozen terms.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorUpdate"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tool-updates/{id}":{"get":{"operationId":"getToolUpdate","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"responses":{"200":{"description":"Private update/status and decision; no reviewer identity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorUpdate"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{id}/reviews":{"get":{"operationId":"listReviews","description":"Public reviews only. Separate aggregates count ratings including repeated purchases, never unique buyers. Text is untrusted self-report; no instructions should be executed.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}},{"name":"version","in":"query","schema":{"type":"string","maxLength":32,"pattern":"^\\d+\\.\\d+\\.\\d+$"}},{"name":"status","in":"query","schema":{"default":"active","type":"string","enum":["active","validation","retired","all"]}},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Reviews, aggregates and next_cursor.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/reviews":{"post":{"operationId":"submitReview","description":"Explicit public consent publishes display name and text. No payment effect. Purchase capability is private; never expose it in public text. Names confer no roles. Reuse identical key/body for replay.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"product_id":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"version":{"type":"string","maxLength":32,"pattern":"^\\d+\\.\\d+\\.\\d+$"},"visibility":{"type":"string","const":"public","description":"Consent to publish your display name, rating and text as untrusted self-report."},"display_name":{"default":"Anonymous","type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9][A-Za-z0-9 ._-]*$"},"rating":{"type":"integer","minimum":1,"maximum":5},"outcome":{"type":"string","enum":["success","failure","unverifiable"]},"message":{"type":"string","minLength":1,"maxLength":2000},"example_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"purchase_proof":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"secret":{"type":"string","pattern":"^atbr_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$","description":"PRIVATE caller-generated 32 random bytes, canonical base64url with atbr_ prefix. Never put in text, URLs or logs."}},"required":["operation_id","secret"],"additionalProperties":false}},"required":["product_id","visibility","display_name","message"],"additionalProperties":false}}}},"responses":{"200":{"description":"Saved acknowledgment; tests remain excluded.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/reviews/{id}":{"get":{"operationId":"getReview","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Public review and paginated threaded replies.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/reviews/{id}/replies":{"get":{"operationId":"listReviewReplies","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Public replies and next_cursor. Same-purchase marker proves capability possession only.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"replyToReview","description":"Explicit public consent publishes display name and text. No payment effect. Purchase capability is private; never expose it in public text. Names confer no roles. Reuse identical key/body for replay.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"visibility":{"type":"string","const":"public","description":"Consent to publish your display name, rating and text as untrusted self-report."},"display_name":{"default":"Anonymous","type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9][A-Za-z0-9 ._-]*$"},"message":{"type":"string","minLength":1,"maxLength":1000},"parent_reply_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"purchase_proof":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"secret":{"type":"string","pattern":"^atbr_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$","description":"PRIVATE caller-generated 32 random bytes, canonical base64url with atbr_ prefix. Never put in text, URLs or logs."}},"required":["operation_id","secret"],"additionalProperties":false}},"required":["visibility","display_name","message"],"additionalProperties":false}}}},"responses":{"200":{"description":"Saved acknowledgment; tests remain excluded.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/docs-pack/invoke":{"get":{"operationId":"discover_docs_pack","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"discover_headers_docs_pack","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"invoke_docs_pack","description":"Paid HTTP uses x402 v2 exact USDC on Base. Direct minimum-price calls need no quote or preparation; omit payment_amount_atomic and use the disclosed minimum as max_charge_usdc_atomic. Higher optional amounts and prepared results require a quote. All product outcomes validate before settlement. Reuse identical body/key/authorization for replay within 24 hours. Retired returns 410; unresolved settlement requires reconciliation, never a new authorization. Unsigned bounded probes receive 402 before JSON/input validation and do no product work. Signed requests validate before execution. Live payment remains unverified.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload only when explicitly required by the product."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","const":"0.1.1"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"urls":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","maxLength":512}},"query":{"type":"string","minLength":2,"maxLength":120},"max_excerpt_chars":{"default":4000,"type":"integer","minimum":1000,"maximum":6000}},"required":["urls","query","max_excerpt_chars"],"additionalProperties":false},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum. Product minimum: 10000. Must equal the exact quoted/signed amount."},"max_charge_usdc_atomic":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},{"type":"integer","minimum":0,"maximum":9007199254740991}],"description":"Caller spending cap. Canonical decimal string recommended; safe integer numbers accepted for compatibility. Does not select an amount."},"agent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Optional random UUID pseudonym (e.g. crypto.randomUUID()); not authenticated identity. Omit if unavailable."},"review_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 hex of caller-kept atbr_ secret (32 random bytes). Bound to this paid request; never send the raw secret here."},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","max_charge_usdc_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Completed validated result and payment receipt.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required only for configured paid products; see PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"buyer_chosen","currency":"USD","minimum":"0.01","decimals":6,"business_maximum":null}}}},"/v1/products/quote-proof/invoke":{"get":{"operationId":"discover_quote_proof","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"discover_headers_quote_proof","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"invoke_quote_proof","description":"Paid HTTP uses x402 v2 exact USDC on Base. Direct minimum-price calls need no quote or preparation; omit payment_amount_atomic and use the disclosed minimum as max_charge_usdc_atomic. Higher optional amounts and prepared results require a quote. All product outcomes validate before settlement. Reuse identical body/key/authorization for replay within 24 hours. Retired returns 410; unresolved settlement requires reconciliation, never a new authorization. Unsigned bounded probes receive 402 before JSON/input validation and do no product work. Signed requests validate before execution. Live payment remains unverified.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload only when explicitly required by the product."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","const":"0.1.1"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"urls":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","maxLength":512}},"quotes":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"source_index":{"type":"integer","minimum":0,"maximum":4},"quote":{"type":"string","minLength":1,"maxLength":512}},"required":["source_index","quote"],"additionalProperties":false}}},"required":["urls","quotes"],"additionalProperties":false},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum. Product minimum: 10000. Must equal the exact quoted/signed amount."},"max_charge_usdc_atomic":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},{"type":"integer","minimum":0,"maximum":9007199254740991}],"description":"Caller spending cap. Canonical decimal string recommended; safe integer numbers accepted for compatibility. Does not select an amount."},"agent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Optional random UUID pseudonym (e.g. crypto.randomUUID()); not authenticated identity. Omit if unavailable."},"review_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 hex of caller-kept atbr_ secret (32 random bytes). Bound to this paid request; never send the raw secret here."},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","max_charge_usdc_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Completed validated result and payment receipt.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required only for configured paid products; see PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"buyer_chosen","currency":"USD","minimum":"0.01","decimals":6,"business_maximum":null}}}},"/v1/products/contract-cases/invoke":{"get":{"operationId":"discover_contract_cases","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"discover_headers_contract_cases","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"invoke_contract_cases","description":"Paid HTTP uses x402 v2 exact USDC on Base. Direct minimum-price calls need no quote or preparation; omit payment_amount_atomic and use the disclosed minimum as max_charge_usdc_atomic. Higher optional amounts and prepared results require a quote. All product outcomes validate before settlement. Reuse identical body/key/authorization for replay within 24 hours. Retired returns 410; unresolved settlement requires reconciliation, never a new authorization. Unsigned bounded probes receive 402 before JSON/input validation and do no product work. Signed requests validate before execution. Live payment remains unverified.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload only when explicitly required by the product."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","const":"0.1.1"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Explicit $schema=https://json-schema.org/draft/2020-12/schema required. Bounded subset; every schema node needs a single type. No references, patterns, formats or composition."},"valid_example":{},"max_cases":{"default":12,"type":"integer","minimum":2,"maximum":24}},"required":["schema","valid_example","max_cases"],"additionalProperties":false},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum. Product minimum: 10000. Must equal the exact quoted/signed amount."},"max_charge_usdc_atomic":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},{"type":"integer","minimum":0,"maximum":9007199254740991}],"description":"Caller spending cap. Canonical decimal string recommended; safe integer numbers accepted for compatibility. Does not select an amount."},"agent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Optional random UUID pseudonym (e.g. crypto.randomUUID()); not authenticated identity. Omit if unavailable."},"review_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 hex of caller-kept atbr_ secret (32 random bytes). Bound to this paid request; never send the raw secret here."},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","max_charge_usdc_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Completed validated result and payment receipt.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required only for configured paid products; see PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"buyer_chosen","currency":"USD","minimum":"0.01","decimals":6,"business_maximum":null}}}},"/v1/products/mcp-wirecheck/invoke":{"get":{"operationId":"discover_mcp_wirecheck","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"head":{"operationId":"discover_headers_mcp_wirecheck","description":"Read-only minimum-price x402 v2 challenge. Ignores payment signatures, performs no product work and creates no quote or payment. Use POST to invoke. Returns canonical payment_requirements_pin and contract_pins.","parameters":[],"responses":{"402":{"description":"PAYMENT-REQUIRED header plus payment, contract_pins and payment_requirements_pin.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"invoke_mcp_wirecheck","description":"Paid HTTP uses x402 v2 exact USDC on Base. Direct minimum-price calls need no quote or preparation; omit payment_amount_atomic and use the disclosed minimum as max_charge_usdc_atomic. Higher optional amounts and prepared results require a quote. All product outcomes validate before settlement. Reuse identical body/key/authorization for replay within 24 hours. Retired returns 410; unresolved settlement requires reconciliation, never a new authorization. Unsigned bounded probes receive 402 before JSON/input validation and do no product work. Signed requests validate before execution. Live payment remains unverified.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload only when explicitly required by the product."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","const":"0.1.1"},"input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"endpoint":{"type":"string","maxLength":256,"pattern":"^https:\\/\\/[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.workers\\.dev\\/mcp\\/?$"},"protocol_versions":{"default":["2025-11-25","2026-07-28"],"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["2025-11-25","2026-07-28"]}},"authority":{"type":"string","const":"I own this endpoint or am authorized to request its anonymous read-only MCP discovery."}},"required":["endpoint","protocol_versions","authority"],"additionalProperties":false},"prepared_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"payment_amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum. Product minimum: 10000. Must equal the exact quoted/signed amount."},"max_charge_usdc_atomic":{"anyOf":[{"type":"string","pattern":"^(0|[1-9][0-9]{0,77})$","description":"Canonical decimal USDC atomic-unit string (6 decimals). Protocol uint256 maximum 115792089237316195423570985008687907853269984665640564039457584007913129639935. No business maximum."},{"type":"integer","minimum":0,"maximum":9007199254740991}],"description":"Caller spending cap. Canonical decimal string recommended; safe integer numbers accepted for compatibility. Does not select an amount."},"agent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Optional random UUID pseudonym (e.g. crypto.randomUUID()); not authenticated identity. Omit if unavailable."},"review_secret_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 hex of caller-kept atbr_ secret (32 random bytes). Bound to this paid request; never send the raw secret here."},"success_contract_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the published canonical success contract. Mismatch prevents new work or payment. Quotes inherit their stored success pin even when this field is omitted."},"payment_requirements_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Optional SHA-256 of the complete canonical PaymentRequirements object under agenttoolbox-json-v1. Exact string/address case is significant."}},"required":["version","max_charge_usdc_atomic"],"additionalProperties":false,"oneOf":[{"required":["input"],"not":{"required":["prepared_id"]}},{"required":["prepared_id"],"not":{"required":["input"]}}]}}}},"responses":{"200":{"description":"Completed validated result and payment receipt.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required only for configured paid products; see PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Explicit error; no raw input or operational details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"buyer_chosen","currency":"USD","minimum":"0.01","decimals":6,"business_maximum":null}}}},"/v1/creators/me/payout-wallet":{"get":{"operationId":"getCreatorPayoutWallet","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$"}}],"responses":{"200":{"description":"Current destination and private paginated history.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"wallet":{"anyOf":[{"type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false},{"type":"null"}]},"history":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["api_version","wallet","history","next_cursor"],"additionalProperties":false}}}},"400":{"description":"Bounded request rejected; no transfer performed."},"403":{"description":"Bounded request rejected; no transfer performed."},"409":{"description":"Bounded request rejected; no transfer performed."},"413":{"description":"Bounded request rejected; no transfer performed."},"415":{"description":"Bounded request rejected; no transfer performed."},"429":{"description":"Bounded request rejected; no transfer performed."},"503":{"description":"Bounded request rejected; no transfer performed."}}},"post":{"operationId":"claimCreatorPayoutWallet","description":"Private creator capability required. No payment authorization or transfer. Separate ownership proof and owner approval; EOA only, ERC-1271 unsupported.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"expected_revision":{"type":"integer","minimum":0,"maximum":2147483646},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"}},"required":["request_id","expected_revision","network","address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private creator wallet result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Bounded request rejected; no transfer performed."},"403":{"description":"Bounded request rejected; no transfer performed."},"409":{"description":"Bounded request rejected; no transfer performed."},"413":{"description":"Bounded request rejected; no transfer performed."},"415":{"description":"Bounded request rejected; no transfer performed."},"429":{"description":"Bounded request rejected; no transfer performed."},"503":{"description":"Bounded request rejected; no transfer performed."}}}},"/v1/creators/me/payout-wallet/challenge":{"post":{"operationId":"createCreatorWalletChallenge","description":"Private creator capability required. No payment authorization or transfer. Separate ownership proof and owner approval; EOA only, ERC-1271 unsupported.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"claim_revision":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["request_id","claim_revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private creator wallet result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"address":{"type":"string"},"message":{"type":"string"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false},"payment_effect":{"type":"string","const":"none"}},"required":["challenge_id","claim_revision","address","message","expires_at","method","erc1271_supported","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Bounded request rejected; no transfer performed."},"403":{"description":"Bounded request rejected; no transfer performed."},"409":{"description":"Bounded request rejected; no transfer performed."},"413":{"description":"Bounded request rejected; no transfer performed."},"415":{"description":"Bounded request rejected; no transfer performed."},"429":{"description":"Bounded request rejected; no transfer performed."},"503":{"description":"Bounded request rejected; no transfer performed."}}}},"/v1/creators/me/payout-wallet/verify":{"post":{"operationId":"verifyCreatorWallet","description":"Private creator capability required. No payment authorization or transfer. Separate ownership proof and owner approval; EOA only, ERC-1271 unsupported.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]{130}$"}},"required":["challenge_id","signature"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private creator wallet result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Bounded request rejected; no transfer performed."},"403":{"description":"Bounded request rejected; no transfer performed."},"409":{"description":"Bounded request rejected; no transfer performed."},"413":{"description":"Bounded request rejected; no transfer performed."},"415":{"description":"Bounded request rejected; no transfer performed."},"429":{"description":"Bounded request rejected; no transfer performed."},"503":{"description":"Bounded request rejected; no transfer performed."}}}},"/v1/creator-tools/{tool_id}/earnings":{"get":{"operationId":"getCreatorEarnings","description":"Exact cumulative Base USDC amounts; fail closed when the complete 5000-row bound is exceeded. No creator-cost deductions or transfer initiation.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"tool_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"responses":{"200":{"description":"Private gross accrual, carry, confirmed payouts and held reservations.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"tool_id":{"type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"share_bps":{"type":"number","const":9000},"revenue_basis":{"type":"string","const":"gross"},"gross_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"accrued_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fractional_atom_numerator":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fractional_atom_denominator":{"type":"string","const":"10"},"confirmed_paid_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"reserved_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"available_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"receipt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"payout_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"execution_status":{"type":"string","enum":["installed_adapter","metadata_only_not_earning"]},"receipt_basis":{"type":"string","const":"facilitator_confirmed_not_independently_reconciled"},"payout_basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"},"fees":{"type":"string","const":"platform_share_only; no creator deductions"},"transfers_enabled":{"type":"boolean","const":false},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","tool_id","network","asset","share_bps","revenue_basis","gross_atomic","accrued_atomic","fractional_atom_numerator","fractional_atom_denominator","confirmed_paid_atomic","reserved_atomic","available_atomic","receipt_count","payout_count","execution_status","receipt_basis","payout_basis","fees","transfers_enabled","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Bounded request rejected; no transfer performed."},"403":{"description":"Bounded request rejected; no transfer performed."},"409":{"description":"Bounded request rejected; no transfer performed."},"413":{"description":"Bounded request rejected; no transfer performed."},"415":{"description":"Bounded request rejected; no transfer performed."},"429":{"description":"Bounded request rejected; no transfer performed."},"503":{"description":"Bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/payout-wallet":{"get":{"operationId":"getReferralPayoutWallet","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$"}}],"responses":{"200":{"description":"Private destination and paginated history.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"wallet":{"anyOf":[{"type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false},{"type":"null"}]},"history":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["api_version","wallet","history","next_cursor"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}},"post":{"operationId":"claimReferralPayoutWallet","description":"Private beneficiary capability required. Acceptance initiates no transfer; ownership proof, owner approval and external signature remain separate.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"expected_revision":{"type":"integer","minimum":0,"maximum":2147483646},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"}},"required":["request_id","expected_revision","network","address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private beneficiary result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/payout-wallet/challenge":{"post":{"operationId":"createReferralWalletChallenge","description":"Private beneficiary capability required. Acceptance initiates no transfer; ownership proof, owner approval and external signature remain separate.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"claim_revision":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["request_id","claim_revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private beneficiary result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"address":{"type":"string"},"message":{"type":"string"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false},"payment_effect":{"type":"string","const":"none"}},"required":["challenge_id","claim_revision","address","message","expires_at","method","erc1271_supported","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/payout-wallet/verify":{"post":{"operationId":"verifyReferralWallet","description":"Private beneficiary capability required. Acceptance initiates no transfer; ownership proof, owner approval and external signature remain separate.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"challenge_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]{130}$"}},"required":["challenge_id","signature"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private beneficiary result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"network":{"type":"string","const":"eip155:8453"},"address":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"ownership_status":{"type":"string","enum":["unverified","eoa_signature_verified"]},"ownership_proof":{"anyOf":[{"type":"object","properties":{"verified_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"method":{"type":"string","const":"eoa_erc191"},"erc1271_supported":{"type":"boolean","const":false}},"required":["verified_at","method","erc1271_supported"],"additionalProperties":false},{"type":"null"}]},"owner_approval":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","const":"pending"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"approved"},"approved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["status","approved_at"],"additionalProperties":false}]},"payment_effect":{"type":"string","const":"none"}},"required":["claim_id","revision","network","address","created_at","ownership_status","ownership_proof","owner_approval","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/earnings":{"get":{"operationId":"getReferralEarnings","description":"Exact first-party 100 bps gross referral earnings. Complete bounded accounting fails closed on overflow. Platform funds gas separately.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"responses":{"200":{"description":"Accrual, fractional carry, confirmed payouts, reservations and availability.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"referral_code":{"type":"string","pattern":"^ref_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Public referral code returned by registration. First-party tools only; preserve it in the original invoke body on every replay."},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"terms_version":{"type":"string"},"share_bps":{"type":"number","const":100},"revenue_basis":{"type":"string","const":"gross"},"gross_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"accrued_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fractional_atom_numerator":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"fractional_atom_denominator":{"type":"string","const":"10000"},"confirmed_paid_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"reserved_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"available_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"receipt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"payout_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"receipt_basis":{"type":"string","const":"facilitator_confirmed_not_independently_reconciled"},"payout_basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"},"fees":{"type":"string","const":"platform funds gas separately; no referral deductions"},"transfers_enabled":{"type":"boolean","const":false},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","referral_code","network","asset","terms_version","share_bps","revenue_basis","gross_atomic","accrued_atomic","fractional_atom_numerator","fractional_atom_denominator","confirmed_paid_atomic","reserved_atomic","available_atomic","receipt_count","payout_count","receipt_basis","payout_basis","fees","transfers_enabled","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/creator-tools/{tool_id}/payout-requests":{"get":{"operationId":"listCreatorPayoutRequests","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"tool_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,512}$"}}],"responses":{"200":{"description":"Private bounded payout request history.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"requests":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","requests","next_cursor","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}},"post":{"operationId":"requestCreatorPayout","description":"Private beneficiary capability required. Acceptance initiates no transfer; ownership proof, owner approval and external signature remain separate.","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"tool_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^creator-[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":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"amount_atomic":{"type":"string","pattern":"^[1-9][0-9]{0,77}$"},"claim_revision":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["request_id","amount_atomic","claim_revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private beneficiary result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/creator-tools/{tool_id}/payout-requests/{request_id}":{"get":{"operationId":"getCreatorPayoutRequest","parameters":[{"name":"X-Creator-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbc_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Client-generated 32-byte private capability controls private status and future approved-tool metadata/update proposals. SHA-256 commitment only is stored. Never put it in a URL or proposal. No recovery or rotation is available; capability control does not verify wallet or identity."},{"name":"tool_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},{"name":"request_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Private request with its permanent payout link, when reserved.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/payout-requests":{"get":{"operationId":"listReferralPayoutRequests","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."},{"name":"limit","in":"query","schema":{"default":10,"type":"integer","minimum":1,"maximum":20}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,512}$"}}],"responses":{"200":{"description":"Private bounded payout request history.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"requests":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","requests","next_cursor","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}},"post":{"operationId":"requestReferralPayout","description":"Private beneficiary capability required. Acceptance initiates no transfer; ownership proof, owner approval and external signature remain separate.","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"amount_atomic":{"type":"string","pattern":"^[1-9][0-9]{0,77}$"},"claim_revision":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["request_id","amount_atomic","claim_revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Private beneficiary result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}},"/v1/referrals/me/payout-requests/{request_id}":{"get":{"operationId":"getReferralPayoutRequest","parameters":[{"name":"X-Referral-Capability","in":"header","required":true,"schema":{"type":"string","pattern":"^atbf_[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$"},"description":"Private client-generated capability; never share it with a buyer or include it in a URL. Only the returned referral_code is public."},{"name":"request_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Private request with its permanent payout link, when reserved.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"api_version":{"type":"string","const":"1"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"beneficiary_kind":{"type":"string","enum":["creator","referral"]},"subject_id":{"type":"string"},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"network":{"type":"string","const":"eip155:8453"},"asset":{"type":"string"},"claim_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"claim_revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"state":{"anyOf":[{"type":"string","const":"requested"},{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]}]},"payout":{"anyOf":[{"type":"object","properties":{"payout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"batch_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["reserved","awaiting_owner","submitted","unknown","paid","cancelled"]},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"amount_atomic":{"type":"string","pattern":"^(0|[1-9][0-9]*)$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"receipt":{"anyOf":[{"type":"object","properties":{"transaction_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"block_number":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"log_index":{"type":"string","maxLength":66,"pattern":"^0x(?:0|[1-9a-f][0-9a-f]*)$"},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"basis":{"type":"string","const":"finalized_canonical_base_usdc_transfer"}},"required":["transaction_hash","block_hash","block_number","log_index","checked_at","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["payout_id","batch_id","state","revision","amount_atomic","created_at","receipt"],"additionalProperties":false},{"type":"null"}]},"payment_effect":{"type":"string","const":"none"}},"required":["api_version","request_id","beneficiary_kind","subject_id","amount_atomic","network","asset","claim_id","claim_revision","created_at","state","payout","payment_effect"],"additionalProperties":false}}}},"400":{"description":"Private bounded request rejected; no transfer performed."},"403":{"description":"Private bounded request rejected; no transfer performed."},"404":{"description":"Private bounded request rejected; no transfer performed."},"409":{"description":"Private bounded request rejected; no transfer performed."},"413":{"description":"Private bounded request rejected; no transfer performed."},"415":{"description":"Private bounded request rejected; no transfer performed."},"429":{"description":"Private bounded request rejected; no transfer performed."},"503":{"description":"Private bounded request rejected; no transfer performed."}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}}}},"CreatorProposal":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"summary":{"type":"string","minLength":1,"maxLength":1000},"endpoint_url":{"type":"string","maxLength":800,"description":"HTTPS proposal URL without credentials, query, fragment, explicit ports or local/IP hosts. Never fetched."},"input_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."},"output_schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Private untrusted proposed JSON Schema, at most 4000 UTF-8 bytes; not executed or accepted as a platform contract."}},"required":["name","summary","endpoint_url","input_schema","output_schema"],"additionalProperties":false},"CreatorFrozenTerms":{"type":"object","additionalProperties":false,"required":["terms_version","currency","network","asset","decimals","list_fee_atomic","discount_bps","charged_fee_atomic","paid_fee_atomic","share_bps","revenue_basis","duration","deductions","rejection_refund","promotion","transfers_enabled","approval_effect","identity","recovery"],"properties":{"terms_version":{"type":"string"},"currency":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"list_fee_atomic":{"type":"string"},"discount_bps":{"type":"integer"},"charged_fee_atomic":{"type":"string"},"paid_fee_atomic":{"type":"string"},"share_bps":{"type":"integer"},"revenue_basis":{"type":"string"},"duration":{"type":"string"},"deductions":{"type":"string"},"rejection_refund":{"type":"string"},"promotion":{"type":"string"},"transfers_enabled":{"type":"boolean"},"approval_effect":{"type":"string"},"identity":{"type":"string"},"recovery":{"type":"string"}}},"CreatorDecision":{"type":"object","additionalProperties":false,"required":["decision","reason","created_at"],"properties":{"decision":{"type":"string","enum":["approved","rejected"]},"reason":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"CreatorSubmission":{"type":"object","additionalProperties":false,"required":["api_version","payment_effect","transfers_enabled","tool_id","state","revision","proposal","terms","decision","created_at","submission_id","refund_due_atomic","publication"],"properties":{"api_version":{"type":"string","const":"1"},"payment_effect":{"type":"string","const":"none"},"transfers_enabled":{"type":"boolean","const":false},"tool_id":{"type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"state":{"type":"string","enum":["pending","approved","rejected"],"description":"pending: await owner review; rejected: read the decision; approved: initial submissions may use the approved-tool API, updates advance metadata only. Publication/execution requires separate adapter review."},"revision":{"type":"integer","enum":[0,1]},"proposal":{"$ref":"#/components/schemas/CreatorProposal"},"terms":{"$ref":"#/components/schemas/CreatorFrozenTerms"},"decision":{"anyOf":[{"$ref":"#/components/schemas/CreatorDecision"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"submission_id":{"type":"string","format":"uuid"},"refund_due_atomic":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)$"},"publication":{"type":"string","const":"not_published_by_submission"}}},"CreatorUpdate":{"type":"object","additionalProperties":false,"required":["api_version","payment_effect","transfers_enabled","tool_id","state","revision","proposal","terms","decision","created_at","update_id","base_version","expected_head_revision","proposed_version","approval_effect"],"properties":{"api_version":{"type":"string","const":"1"},"payment_effect":{"type":"string","const":"none"},"transfers_enabled":{"type":"boolean","const":false},"tool_id":{"type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"state":{"type":"string","enum":["pending","approved","rejected"],"description":"pending: await owner review; rejected: read the decision; approved: initial submissions may use the approved-tool API, updates advance metadata only. Publication/execution requires separate adapter review."},"revision":{"type":"integer","enum":[0,1]},"proposal":{"$ref":"#/components/schemas/CreatorProposal"},"terms":{"$ref":"#/components/schemas/CreatorFrozenTerms"},"decision":{"anyOf":[{"$ref":"#/components/schemas/CreatorDecision"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"update_id":{"type":"string","format":"uuid"},"base_version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$"},"expected_head_revision":{"type":"integer","minimum":0,"maximum":2147483646},"proposed_version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$"},"approval_effect":{"type":"string","const":"metadata_only"}}},"CreatorTool":{"type":"object","additionalProperties":false,"required":["api_version","payment_effect","transfers_enabled","tool_id","current_version","head_revision","proposal","terms","entitlement","history","next_cursor","approval_effect","installed_execution"],"properties":{"api_version":{"type":"string","const":"1"},"payment_effect":{"type":"string","const":"none"},"transfers_enabled":{"type":"boolean","const":false},"tool_id":{"type":"string","pattern":"^creator-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"current_version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$"},"head_revision":{"type":"integer","minimum":0},"proposal":{"$ref":"#/components/schemas/CreatorProposal"},"terms":{"$ref":"#/components/schemas/CreatorFrozenTerms"},"entitlement":{"type":"object","additionalProperties":false,"required":["share_bps","revenue_basis"],"properties":{"share_bps":{"type":"integer","const":9000},"revenue_basis":{"type":"string","const":"gross"}}},"history":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["version","approved_revision","proposal","approved_at"],"properties":{"version":{"type":"string","pattern":"^(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})\\.(0|[1-9][0-9]{0,5})$"},"approved_revision":{"type":"integer","minimum":0},"proposal":{"$ref":"#/components/schemas/CreatorProposal"},"approved_at":{"type":"string","format":"date-time"}}}},"next_cursor":{"type":["string","null"],"maxLength":256},"approval_effect":{"type":"string","const":"metadata_only"},"installed_execution":{"type":"string","const":"separately_reviewed; metadata approval never changes an adapter"}}}}},"x-catalog-version":"2026-10-08.1"}