{"openapi":"3.1.1","info":{"title":"Zeopilot Partner API","version":"1.0.0-beta","description":"Private, read-only beta contract. Disabled by default. Uses owner-reviewed exports, not direct real-time customer database access. Availability requires separate owner provisioning."},"servers":[{"url":"https://zeopilot.com/api/v1","description":"Production activation is not enabled by this documentation."}],"security":[{"PartnerToken":[]}],"paths":{"/websites":{"get":{"operationId":"websites","summary":"Read websites from a reviewed export","description":"Invite-only beta. Required scope: websites:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"websites:read","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}},"/websites/{websiteId}/status":{"get":{"operationId":"websites_site_status","summary":"Read status from a reviewed export","description":"Invite-only beta. Required scope: websites:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"websites:read","parameters":[{"name":"websiteId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}},"/websites/{websiteId}/incidents":{"get":{"operationId":"websites_site_incidents","summary":"Read incidents from a reviewed export","description":"Invite-only beta. Required scope: incidents:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"incidents:read","parameters":[{"name":"websiteId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}},"/websites/{websiteId}/proposals":{"get":{"operationId":"websites_site_proposals","summary":"Read proposals from a reviewed export","description":"Invite-only beta. Required scope: proposals:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"proposals:read","parameters":[{"name":"websiteId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}},"/websites/{websiteId}/evidence":{"get":{"operationId":"websites_site_evidence","summary":"Read evidence from a reviewed export","description":"Invite-only beta. Required scope: evidence:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"evidence:read","parameters":[{"name":"websiteId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}},"/websites/{websiteId}/events":{"get":{"operationId":"websites_site_events","summary":"Read events from a reviewed export","description":"Invite-only beta. Required scope: events:read. Results are restricted to credential workspace and website grants. No live browser or AI jobs are started.","x-required-scope":"events:read","parameters":[{"name":"websiteId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Authorized reviewed data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid, expired or revoked credential"},"403":{"description":"Missing scope"},"404":{"description":"Unavailable or unauthorized resource"},"413":{"description":"Response too large"},"429":{"description":"Rate or concurrency limit"},"503":{"description":"Data or audit store unavailable"}}}}},"components":{"securitySchemes":{"PartnerToken":{"type":"http","scheme":"bearer","bearerFormat":"zp_partner_<64 lowercase hex characters>","description":"Expiring, revocable grant scoped to one tenant and an explicit website list. Never include tokens in URLs."}},"schemas":{"ReadResponse":{"type":"object","required":["requestId","version","source","observedAt","readOnly","data","pagination"],"properties":{"requestId":{"type":"string","format":"uuid"},"version":{"const":"1-beta"},"source":{"enum":["fixture","reviewed-export"]},"observedAt":{"type":"string","format":"date-time"},"readOnly":{"const":true},"data":{"type":"array","maxItems":50,"items":{"type":"object"}},"pagination":{"type":"object","properties":{"offset":{"type":"integer"},"limit":{"type":"integer"},"nextOffset":{"type":["integer","null"]}}}}}}}}