API Reference

Build on Petunia.

For MVP launch, Petunia’s APIs are used primarily by the product itself and a small set of partner integrations. Public, self-serve API access is coming soon.

Docs available
Public API: Coming soon
Swagger UI: Signed-in / internal
Interactive API explorer
Signed-in
Swagger UI is available inside the app environment for internal + partner use.

Note: API docs and many endpoints require an authenticated session or partner access.

Public API
Coming soon
We’re productizing a stable public API (keys, scopes, quotas, versioning). If you need early access, contact us—happy to set up a partner integration.
Integration patterns

The real “how we do integrations” guide (logging, retries, auth, testing).

Webhooks

Webhooks are the preferred integration surface for many providers (signature auth + idempotency).

OpenAPI specs

Download the current OpenAPI specs (YAML). These reflect current implementation best-effort and evolve as we harden the public API.

Reality check (so this stays accurate)
  • - Public API keys: Coming soon (self-serve access, scopes, quotas, stable versioning).
  • - Partner integrations: Available by request.
  • - Webhooks: In use today (signature-auth, idempotent handling).