Sandbox Contractor Agent REST API

{"openapi":"3.1.0","info":{"title":"A2A Autonomous Trader Agent","version":"0.1.0"},"paths":{"/.well-known/agent-card.json":{"get":{"summary":"Agent Card","operationId":"agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Card  Well Known Agent Card Json Get"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Agent Card Alias","operationId":"agent_card_alias__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Card Alias  Well Known Agent Json Get"}}}}}}},"/.well-known/agents.json":{"get":{"summary":"Agents Manifest","operationId":"agents_manifest__well_known_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents Manifest  Well Known Agents Json Get"}}}}}}},"/.well-known/402index-verify.txt":{"get":{"summary":"Well Known 402Index Verify","description":"Serve the 402index.io domain-ownership proof.\n\n402index grants instant approval to our pending x402 listings when the\nhash it issued is served here. The hash lives in a data file so it can be\nrefreshed on re-verification without a code change. A specific route (not\na catch-all) so it never shadows /.well-known/x402.json et al.","operationId":"well_known_402index_verify__well_known_402index_verify_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Well Known 402Index Verify  Well Known 402Index Verify Txt Get"}}}}}}},"/.well-known/x402.json":{"get":{"summary":"X402 Discovery","description":"Advertise x402 pay-per-call endpoints + classic invoice rail.\n\nOnly what is deliverable right now: a listing that promises skills the\noffline model cannot run just sends buyers into a 503.","operationId":"x402_discovery__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response X402 Discovery  Well Known X402 Json Get"}}}}}}},"/x402/{skill}":{"post":{"summary":"X402 Pay Per Call","description":"HTTP x402 gate: Challenge → Sign → Retry → Settle for contractor skills.\n\nWithout PAYMENT-SIGNATURE → 402 + PAYMENT-REQUIRED.\nWith valid signature → settle, create A2A task (marked paid), return receipt + artifact.","operationId":"x402_pay_per_call_x402__skill__post","parameters":[{"name":"skill","in":"path","required":true,"schema":{"type":"string","title":"Skill"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response X402 Pay Per Call X402  Skill  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks":{"post":{"summary":"Create Task","operationId":"create_task_v1_tasks_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Task V1 Tasks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"List Tasks","operationId":"list_tasks_v1_tasks_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Tasks V1 Tasks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks/{task_id}":{"get":{"summary":"Get Task","operationId":"get_task_v1_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Task V1 Tasks  Task Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tasks/{task_id}/mark-paid":{"post":{"summary":"Mark Paid","operationId":"mark_paid_v1_tasks__task_id__mark_paid_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MarkPaidRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark Paid V1 Tasks  Task Id  Mark Paid Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payments/webhook/{provider}":{"post":{"summary":"Payment Webhook","operationId":"payment_webhook_v1_payments_webhook__provider__post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Payment Webhook V1 Payments Webhook  Provider  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a2a":{"post":{"summary":"Jsonrpc","operationId":"jsonrpc_a2a_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Jsonrpc A2A Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Healthz Healthz Get"}}}}}}},"/healthz.earn.superteam":{"get":{"summary":"Healthz Earn Superteam","operationId":"healthz_earn_superteam_healthz_earn_superteam_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Healthz Earn Superteam Healthz Earn Superteam Get"}}}}}}},"/v1/metrics":{"get":{"summary":"Metrics","operationId":"metrics_v1_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Metrics V1 Metrics Get"}}}}}}},"/v1/leads":{"post":{"summary":"Create Public Lead","operationId":"create_public_lead_v1_leads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicLeadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Public Lead V1 Leads Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/showcase/zeroclaw":{"get":{"summary":"Zeroclaw Showcase","operationId":"zeroclaw_showcase_showcase_zeroclaw_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/showcase/zeroclaw/one-pager":{"get":{"summary":"Zeroclaw One Pager","operationId":"zeroclaw_one_pager_showcase_zeroclaw_one_pager_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/showcase/zeroclaw/readme":{"get":{"summary":"Zeroclaw Readme","operationId":"zeroclaw_readme_showcase_zeroclaw_readme_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/showcase/zeroclaw/video-shot-list":{"get":{"summary":"Zeroclaw Video Shot List","operationId":"zeroclaw_video_shot_list_showcase_zeroclaw_video_shot_list_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/showcase/zeroclaw/artifacts.zip":{"get":{"summary":"Zeroclaw Artifacts Zip","operationId":"zeroclaw_artifacts_zip_showcase_zeroclaw_artifacts_zip_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"CreateTaskRequest":{"properties":{"skill":{"type":"string","title":"Skill","default":"inference.complete"},"input":{"title":"Input"},"client_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Task Id"}},"type":"object","title":"CreateTaskRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MarkPaidRequest":{"properties":{"tx_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Ref"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","title":"MarkPaidRequest"},"PublicLeadRequest":{"properties":{"contact":{"type":"string","maxLength":240,"minLength":3,"title":"Contact"},"brief":{"type":"string","maxLength":8000,"minLength":12,"title":"Brief"},"skill":{"type":"string","maxLength":80,"title":"Skill","default":"code.review"},"budget_usd":{"anyOf":[{"type":"number","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Budget Usd"},"source":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Source","default":"public_hire_form"}},"type":"object","required":["contact","brief"],"title":"PublicLeadRequest"},"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"}}}}