Source: https://www.puesto.dev/docs/api/meta/get-the-openapi-specification
Markdown source: https://www.puesto.dev/docs/api/meta/get-the-openapi-specification.md
Description: Returns the public OpenAPI 3.1 document describing every endpoint, as JSON. Use it to generate typed clients, import the API into explorers like Postman or Bruno, or point AI agents and tooling at the API. Publicly accessible — no API key required.

# Get the OpenAPI specification

`GET /api/v1/openapi.json`

Returns the public OpenAPI 3.1 document describing every endpoint, as JSON. Use it to generate typed clients, import the API into explorers like Postman or Bruno, or point AI agents and tooling at the API. Publicly accessible — no API key required.

## Response

The OpenAPI 3.1 document.

## Authentication

Send your secret API key (prefixed `sk_`) as a bearer token in the `Authorization` header. See [Authentication](https://www.puesto.dev/docs/authentication.md).

## Errors

Errors use the RFC 7807 `application/problem+json` format. See [Errors](https://www.puesto.dev/docs/errors.md).

## Example request

```bash
curl -X GET "https://www.puesto.dev/api/v1/openapi.json" \
  -H "Authorization: Bearer sk_your_key_here"
```

Full spec: https://www.puesto.dev/api/v1/openapi.json