API
API reference
Use Potion's versioned JSON APIs with request IDs, cursor pagination, idempotency, and safe errors.
The Potion API is rooted at https://api.potion.sh/v1. Interactive OpenAPI documentation is available from the API deployment at /openapi.
Conventions
Responses include a request ID. Collections use opaque cursor pagination with bounded limits. Retriable mutations accept a validated idempotency key. Errors return stable public codes without stack traces or database details.
curl --silent 'https://api.potion.sh/v1/public/artifacts?limit=20'Respect rate-limit responses and apply bounded exponential backoff. Do not retry validation or authorization failures.