HTTP API

Use the HTTP API when you need raw HTTP, use a language other than JavaScript or TypeScript, or need an operation that the SDK does not cover.

Hosted uses this base URL:

https://app.openpo.st/api/v1

For self-hosting, append /api/v1 to the public OpenPost origin.

Start here

1. Authenticate and select a workspace
2. Create and publish content
3. Upload media
4. Handle revisions, retries, and jobs

Contract and reference

The API reference is generated from the current OpenAPI contract. It lists every path, body, response, parameter, and required header. These guides explain common workflows and do not replace that reference.

Download the contract from /openapi.json to generate a client. Do not copy request or response schemas into your integration because those copies drift when the API changes.