{"openapi":"3.1.0","info":{"title":"TasksAI agent workflow delivery","description":"Versioned workflow instructions and input/output contracts. Buyers inspect and select an exact offer, then apply the purchased package in their own workspace. The service does not generate completed tasks or collect client documents.","version":"1.0.0","x-guidance":"Search and previews are free. Choose an exact immutable offer. Paid delivery contains workflow instructions and local input/output contracts; your agent performs the task. Keep client documents in your workspace. Inspect capabilities, price, license and limitations before payment. Retry the same proof after uncertain results; do not authorize another payment. Use the returned recovery credential within the published window.","contact":{"email":"hello@realtortasksai.com"}},"paths":{"/v1/agent/search":{"post":{"summary":"Find eligible workflow offers without payment","operationId":"search_route_v1_agent_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/skills/{skill_id}":{"get":{"summary":"Inspect local input/output contracts and exact offers","operationId":"skill_route_v1_agent_skills__skill_id__get","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/offers/{offer_id}":{"get":{"summary":"Read the immutable package price and license","operationId":"offer_route_v1_agent_offers__offer_id__get","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/offers/{offer_id}/package":{"get":{"summary":"Purchase or recover exact workflow instructions","operationId":"package_route_v1_agent_offers__offer_id__package_get","parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","title":"Offer Id"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryEnvelope"}}}},"402":{"description":"x402 v2 payment challenge; no paid content"},"403":{"description":"Invalid recovery credential"},"409":{"description":"Payment or idempotency conflict"},"410":{"description":"Withdrawn offer or expired recovery"},"503":{"description":"Disabled or pending reconciliation"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/purchases/{purchase_id}":{"get":{"summary":"Recover original package with buyer-bound credential","operationId":"recovery_route_v1_agent_purchases__purchase_id__get","parameters":[{"name":"purchase_id","in":"path","required":true,"schema":{"type":"string","title":"Purchase Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryEnvelope"}}}},"403":{"description":"Buyer recovery proof required"},"410":{"description":"Recovery expired"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent/openapi.json":{"get":{"summary":"Read agent-only OpenAPI 3.1 and exact offer payment metadata","operationId":"spec_route_v1_agent_openapi_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/agent/offers/realtor-seller-offers-p1-price1-testnet-v2/package":{"get":{"summary":"Purchase or recover exact workflow instructions","operationId":"purchase_realtor_seller_offers_p1_price1_testnet_v2","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryEnvelope"}}}},"402":{"description":"x402 v2 payment challenge; no paid content"},"403":{"description":"Invalid recovery credential"},"409":{"description":"Payment or idempotency conflict"},"410":{"description":"Withdrawn offer or expired recovery"},"503":{"description":"Disabled or pending reconciliation"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.050000"},"protocols":[{"x402":{}}]},"x-bazaar":{"info":{"input":{"type":"http","method":"GET"},"output":{"type":"json","example":{"package":{"execution_mode":"buyer_workspace"},"receipt":{"delivery":"workflow_package"}}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","additionalProperties":false}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}}},"/v1/agent/offers/realtor-closing-readiness-p1-price1-testnet-v2/package":{"get":{"summary":"Purchase or recover exact workflow instructions","operationId":"purchase_realtor_closing_readiness_p1_price1_testnet_v2","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment-Signature"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryEnvelope"}}}},"402":{"description":"x402 v2 payment challenge; no paid content"},"403":{"description":"Invalid recovery credential"},"409":{"description":"Payment or idempotency conflict"},"410":{"description":"Withdrawn offer or expired recovery"},"503":{"description":"Disabled or pending reconciliation"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.050000"},"protocols":[{"x402":{}}]},"x-bazaar":{"info":{"input":{"type":"http","method":"GET"},"output":{"type":"json","example":{"package":{"execution_mode":"buyer_workspace"},"receipt":{"delivery":"workflow_package"}}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","additionalProperties":false}},"required":["type","method"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}}}},"components":{"schemas":{"DeliveredPackage":{"properties":{"skill_id":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,119}$","title":"Skill Id"},"product_id":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,119}$","title":"Product Id"},"skill_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$","title":"Skill Version"},"package_revision":{"type":"integer","minimum":1.0,"title":"Package Revision"},"package_contract_version":{"type":"string","const":"1.0","title":"Package Contract Version","default":"1.0"},"execution_mode":{"type":"string","const":"buyer_workspace","title":"Execution Mode","default":"buyer_workspace"},"language":{"type":"string","maxLength":20,"minLength":2,"title":"Language","default":"en"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description"},"capabilities":{"items":{"type":"string"},"type":"array","maxItems":30,"minItems":1,"title":"Capabilities"},"limitations":{"items":{"type":"string"},"type":"array","maxItems":30,"minItems":1,"title":"Limitations"},"task_inputs":{"items":{"$ref":"#/components/schemas/LocalInput"},"type":"array","maxItems":50,"minItems":1,"title":"Task Inputs"},"output_contract":{"$ref":"#/components/schemas/OutputContract"},"source_policy":{"$ref":"#/components/schemas/SourcePolicy"},"license_revision":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,119}$","title":"License Revision"},"license_text":{"type":"string","maxLength":20000,"minLength":1,"title":"License Text"},"instructions":{"type":"string","title":"Instructions","description":"Entire exact approved workflow; apply in buyer workspace."},"preamble":{"type":"string","title":"Preamble","description":"Exact approved safety preamble; read before applying the instructions."},"source_content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Source Content Sha256"},"preamble_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Preamble Sha256"},"canonicalization":{"type":"string","const":"tasksai-json-v1","title":"Canonicalization"},"payload_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Payload Sha256"}},"additionalProperties":false,"type":"object","required":["skill_id","product_id","skill_version","package_revision","title","description","capabilities","limitations","task_inputs","output_contract","source_policy","license_revision","license_text","instructions","preamble","source_content_sha256","preamble_sha256","canonicalization","payload_sha256"],"title":"DeliveredPackage"},"DeliveryEnvelope":{"properties":{"package":{"$ref":"#/components/schemas/DeliveredPackage"},"receipt":{"$ref":"#/components/schemas/Receipt"},"recovery_token":{"type":"string","title":"Recovery Token","description":"Private bounded recovery credential; contains no spending authority."}},"additionalProperties":false,"type":"object","required":["package","receipt","recovery_token"],"title":"DeliveryEnvelope"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LocalInput":{"properties":{"key":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,119}$","title":"Key"},"label":{"type":"string","maxLength":200,"minLength":1,"title":"Label"},"type":{"type":"string","enum":["text","date","local_document_collection","source_collection","number","choice"],"title":"Type"},"requirement":{"type":"string","enum":["required","conditional","optional","evaluate_in_context"],"title":"Requirement"},"condition":{"anyOf":[{"type":"string","maxLength":1500},{"type":"null"}],"title":"Condition"},"source_reference":{"type":"string","maxLength":300,"minLength":1,"title":"Source Reference"},"sensitivity":{"type":"string","enum":["general","confidential","restricted"],"title":"Sensitivity"},"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description"}},"additionalProperties":false,"type":"object","required":["key","label","type","requirement","source_reference","sensitivity","description"],"title":"LocalInput"},"OfferResponse":{"properties":{"offer_id":{"type":"string","title":"Offer Id"},"payload_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Payload Sha256"},"price":{"$ref":"#/components/schemas/Price"},"network":{"type":"string","title":"Network"},"asset":{"type":"string","title":"Asset"},"pay_to":{"type":"string","title":"Pay To"},"terms_revision":{"type":"string","title":"Terms Revision"},"terms":{"type":"string","title":"Terms"},"recovery_days":{"type":"integer","title":"Recovery Days"},"purchase_url":{"type":"string","title":"Purchase Url"},"withdrawn":{"type":"boolean","title":"Withdrawn"}},"additionalProperties":false,"type":"object","required":["offer_id","payload_sha256","price","network","asset","pay_to","terms_revision","terms","recovery_days","purchase_url","withdrawn"],"title":"OfferResponse"},"OutputContract":{"properties":{"audience":{"type":"string","maxLength":300,"minLength":1,"title":"Audience"},"formats":{"items":{"type":"string","enum":["structured_text","docx","xlsx"]},"type":"array","maxItems":3,"minItems":1,"title":"Formats"},"required_sections":{"items":{"type":"string"},"type":"array","maxItems":30,"minItems":1,"title":"Required Sections"},"table_columns":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Table Columns"},"calculation_rules":{"items":{"type":"string"},"type":"array","title":"Calculation Rules"},"missing_information":{"type":"string","maxLength":2000,"minLength":1,"title":"Missing Information"},"review_status":{"type":"string","const":"draft_for_professional_review","title":"Review Status"},"statuses":{"items":{"type":"string","enum":["completed_draft","partial_draft","needs_input","handoff","refused"]},"type":"array","title":"Statuses"}},"additionalProperties":false,"type":"object","required":["audience","formats","required_sections","missing_information","review_status","statuses"],"title":"OutputContract"},"Price":{"properties":{"currency":{"type":"string","title":"Currency","description":"Explicit token currency."},"atomic_amount":{"type":"string","pattern":"^[1-9][0-9]*$","title":"Atomic Amount","description":"Integer token atomic units; never a floating point amount."},"asset_decimals":{"type":"integer","maximum":36.0,"minimum":0.0,"title":"Asset Decimals","description":"Decimals of the configured asset."},"amount":{"type":"string","title":"Amount","description":"Exact display amount derived from atomic units."}},"additionalProperties":false,"type":"object","required":["currency","atomic_amount","asset_decimals","amount"],"title":"Price"},"Receipt":{"properties":{"purchase_id":{"type":"string","title":"Purchase Id"},"offer_id":{"type":"string","title":"Offer Id"},"payload_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Payload Sha256"},"currency":{"type":"string","title":"Currency"},"atomic_amount":{"type":"string","title":"Atomic Amount"},"asset_decimals":{"type":"integer","title":"Asset Decimals"},"network":{"type":"string","title":"Network"},"asset":{"type":"string","title":"Asset"},"payer":{"type":"string","title":"Payer"},"payment_reference":{"type":"string","title":"Payment Reference"},"settled_at":{"type":"integer","title":"Settled At"},"recovery_expires_at":{"type":"integer","title":"Recovery Expires At"},"delivery":{"type":"string","const":"workflow_package","title":"Delivery"},"task_completion":{"type":"string","const":"not_performed_by_api","title":"Task Completion"}},"additionalProperties":false,"type":"object","required":["purchase_id","offer_id","payload_sha256","currency","atomic_amount","asset_decimals","network","asset","payer","payment_reference","settled_at","recovery_expires_at","delivery","task_completion"],"title":"Receipt"},"SearchRequest":{"properties":{"product_id":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,119}$","title":"Product Id","description":"Product identifier, such as realtor."},"task_summary":{"type":"string","maxLength":300,"minLength":3,"title":"Task Summary","description":"General task only. Omit names, addresses and identifying details."},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","description":"Maximum free results; default five.","default":5},"offset":{"type":"integer","maximum":10000.0,"minimum":0.0,"title":"Offset","description":"Pagination offset.","default":0}},"additionalProperties":false,"type":"object","required":["product_id","task_summary"],"title":"SearchRequest"},"SourcePolicy":{"properties":{"mode":{"type":"string","enum":["neutral_draft_only","reviewed_snapshot"],"title":"Mode"},"coverage":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Coverage"},"live_research":{"type":"string","const":"unavailable","title":"Live Research","default":"unavailable"},"customer_data_in_lookup":{"type":"boolean","const":false,"title":"Customer Data In Lookup","default":false},"limitations":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Limitations"}},"additionalProperties":false,"type":"object","required":["mode","limitations"],"title":"SourcePolicy"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"https://tasksai-agent-commerce-10437713249.us-central1.run.app"}],"externalDocs":{"url":"https://tasksai-agent-commerce-10437713249.us-central1.run.app/agent-guide"}}