{"openapi":"3.1.0","info":{"title":"Suede Agent Studio public agent API","version":"0.1.0","description":"Public catalog, discovery documents, portable templates, and machine-run endpoints for agents published from Suede Agent Studio. Priced live runs use x402; explicit dry-runs and free agents can run without payment.","contact":{"name":"Suede Agent Studio support","email":"support@suedeai.ai","url":"https://agents.suedeai.ai/contact"}},"servers":[{"url":"https://agents.suedeai.ai"}],"paths":{"/api/catalog":{"get":{"operationId":"listPublishedAgents","summary":"List currently published agents","responses":{"200":{"description":"Current public catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/x402":{"get":{"operationId":"getX402Index","summary":"Read current x402 payment discovery","responses":{"200":{"description":"x402 discovery index for published agents."},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/.well-known/agent-card.json":{"get":{"operationId":"getStudioAgentCard","summary":"Read the root agent and capability card","responses":{"200":{"description":"Current published-agent capability card."},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agents/{agent}/.well-known/agent-card":{"get":{"operationId":"getPublishedAgentCard","summary":"Read one published agent's capability card","parameters":[{"name":"agent","in":"path","required":true,"description":"Published agent id or slug.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Capability, provider, and pricing details."},"404":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agents/{agent}/.well-known/x402":{"get":{"operationId":"getPublishedAgentX402","summary":"Read one published agent's x402 terms","parameters":[{"name":"agent","in":"path","required":true,"description":"Published agent id or slug.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Current x402 payment requirements."},"404":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agents/{agent}/a2a":{"get":{"operationId":"getPublishedAgentA2a","summary":"Read one published agent's A2A descriptor","parameters":[{"name":"agent","in":"path","required":true,"description":"Published agent id or slug.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Current A2A run skill descriptor."},"404":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agents/{agent}/template":{"get":{"operationId":"downloadPublishedAgentTemplate","summary":"Download one published agent's portable template","parameters":[{"name":"agent","in":"path","required":true,"description":"Published agent id or slug.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Portable flow, run client, and README bundle.","headers":{"Content-Disposition":{"schema":{"type":"string"},"description":"Attachment filename for the JSON bundle."}}},"404":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agents/{agent}/run":{"post":{"operationId":"runPublishedAgent","summary":"Run one published agent","description":"Send an input object. Set dryRun true for the explicit non-settling preview path. A priced live run without a valid X-PAYMENT header responds with HTTP 402 and current payment requirements.","parameters":[{"name":"agent","in":"path","required":true,"description":"Published agent id or slug.","schema":{"type":"string","minLength":1}},{"name":"X-PAYMENT","in":"header","required":false,"description":"x402 payment payload for a priced live run.","schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRequest"}}}},"responses":{"200":{"description":"Run completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResult"}}}},"400":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required for a priced live run."},"404":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error"],"additionalProperties":true},"Catalog":{"type":"object","properties":{"service":{"type":"string"},"description":{"type":"string"},"site":{"type":"string","format":"uri"},"count":{"type":"integer","minimum":0},"agents":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["service","site","count","agents"]},"RunRequest":{"type":"object","properties":{"input":{"type":"object","additionalProperties":true},"runVariables":{"type":"object","additionalProperties":true},"dryRun":{"type":"boolean"}},"additionalProperties":true},"RunResult":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["done","error"]},"totalCostUsdc":{"type":"number"},"outputs":{"type":"object","additionalProperties":true},"settled":{"type":"boolean"},"relayed":{"type":"boolean"},"transaction":{"type":"string"},"payer":{"type":"string"}},"required":["runId","status","totalCostUsdc","outputs","settled"],"additionalProperties":false}}}}