{"openapi":"3.1.0","info":{"title":"Agent Store Sandbox API","version":"0.3.0","description":"Mock transactions only. PAP guest MCP preview; signed-in purchasing disabled. ACP endpoint preview, not a conformance claim."},"servers":[{"url":"https://agent-store-sandbox.agent-store-2ba49950.workers.dev"}],"paths":{"/v1/catalog":{"get":{"summary":"Sandbox /v1/catalog","security":[{"bearer":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"supplier","in":"query","schema":{"type":"string"}},{"name":"include_mock","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/imports/{id}/publish":{"post":{"summary":"Sandbox /v1/imports/{id}/publish","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"approved":{"const":true},"rights_scope":{"type":"string"},"evidence_urls":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","format":"uri"}}},"required":["approved","rights_scope","evidence_urls"],"additionalProperties":false}}}}}},"/v1/imports/{id}/unpublish":{"post":{"summary":"Sandbox /v1/imports/{id}/unpublish","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/search":{"post":{"summary":"Sandbox /v1/search","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"gtin":{"type":"string"},"brand":{"type":"string"},"model":{"type":"string"},"unit_quantity":{"type":"integer","minimum":1,"maximum":100},"variant":{"type":"object","additionalProperties":{"type":"string"}}},"required":[],"additionalProperties":false}}}}}},"/v1/quotes":{"post":{"summary":"Sandbox /v1/quotes","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100},"destination":{"type":"object","properties":{"country":{"const":"US"},"postal_code":{"type":"string"}},"required":["country","postal_code"],"additionalProperties":false}},"required":["product_id","quantity","destination"],"additionalProperties":false}}}}}},"/v1/authorizations":{"post":{"summary":"Sandbox /v1/authorizations","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires authorize scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string"},"max_total":{"type":"integer","minimum":1},"approved":{"const":true}},"required":["quote_id","max_total","approved"],"additionalProperties":false}}}}}},"/v1/orders":{"post":{"summary":"Sandbox /v1/orders","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string"},"authorization_id":{"type":"string"},"payment_token":{"const":"mock_payment_authorized"}},"required":["quote_id","authorization_id","payment_token"],"additionalProperties":false}}}}}},"/v1/orders/{id}":{"get":{"summary":"Sandbox /v1/orders/{id}","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/orders/{id}/track":{"get":{"summary":"Sandbox /v1/orders/{id}/track","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/orders/{id}/cancel":{"post":{"summary":"Sandbox /v1/orders/{id}/cancel","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/orders/{id}/returns":{"post":{"summary":"Sandbox /v1/orders/{id}/returns","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"],"additionalProperties":false}}}}}},"/v1/ingest":{"post":{"summary":"Sandbox /v1/ingest","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object"}}},"required":["items"],"additionalProperties":false}}}}}},"/v1/imports":{"post":{"summary":"Sandbox /v1/imports","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"supplier":{"type":"string"},"format":{"enum":["json","csv"]},"items":{"type":"array","maxItems":100,"items":{"type":"object"}},"content":{"type":"string","maxLength":60000},"columns":{"type":"object","additionalProperties":{"type":"string"}},"source_ref":{"type":"string"}},"required":["supplier"],"additionalProperties":false}}}}}},"/v1/imports/preview":{"post":{"summary":"Sandbox /v1/imports/preview","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"supplier":{"type":"string"},"format":{"enum":["json","csv"]},"items":{"type":"array","maxItems":100,"items":{"type":"object"}},"content":{"type":"string","maxLength":60000},"columns":{"type":"object","additionalProperties":{"type":"string"}},"source_ref":{"type":"string"}},"required":["supplier"],"additionalProperties":false}}}}}},"/v1/imports/{id}":{"get":{"summary":"Sandbox /v1/imports/{id}","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/supplier-onboarding":{"post":{"summary":"Sandbox /v1/supplier-onboarding","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"supplier":{"type":"string"},"stage":{"enum":["requested","documents_received","resale_review","sandbox_ready"]},"evidence_urls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":20}},"required":["supplier","stage","evidence_urls"],"additionalProperties":false}}}}}},"/v1/suppliers":{"get":{"summary":"Sandbox /v1/suppliers","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/v1/audit":{"get":{"summary":"Sandbox /v1/audit","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires admin scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}},"/checkout_sessions":{"post":{"summary":"Sandbox /checkout_sessions","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100}},"required":["id","quantity"],"additionalProperties":false}},"fulfillment_address":{"type":"object","properties":{"country":{"const":"US"},"postal_code":{"type":"string"}},"required":["country","postal_code"],"additionalProperties":false}},"required":["items","fulfillment_address"],"additionalProperties":false}}}}}},"/checkout_sessions/{id}":{"get":{"summary":"Sandbox /checkout_sessions/{id}","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires read scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}},"post":{"summary":"Update sandbox checkout","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100}},"required":["id","quantity"],"additionalProperties":false}},"fulfillment_address":{"type":"object","properties":{"country":{"const":"US"},"postal_code":{"type":"string"}},"required":["country","postal_code"],"additionalProperties":false}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Updated"}}}},"/checkout_sessions/{id}/complete":{"post":{"summary":"Sandbox /checkout_sessions/{id}/complete","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorization_id":{"type":"string"},"payment_data":{"type":"object","properties":{"provider":{"const":"mock"},"token":{"const":"mock_payment_authorized"}},"required":["provider","token"],"additionalProperties":false}},"required":["authorization_id","payment_data"],"additionalProperties":false}}}}}},"/checkout_sessions/{id}/cancel":{"post":{"summary":"Sandbox /checkout_sessions/{id}/cancel","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"403":{"description":"Requires write scope"},"409":{"description":"Conflict"},"422":{"description":"Business rule rejected"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}}}