> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodisc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Base URL, conventions, and the three endpoints that make up the Kodisc API.

The Kodisc public API has three endpoints. They live under `/api/v2/` on the production host and authenticate with a Bearer token.

```
https://kodisc.com/api/v2
```

<Card title="OpenAPI spec" icon="file-code" href="https://docs.kodisc.com/openapi.yaml">
  Download the full OpenAPI 3.1 spec that powers this reference.
</Card>

## Endpoints

| Method | Path                                                           | Purpose                                          |
| ------ | -------------------------------------------------------------- | ------------------------------------------------ |
| `POST` | [`/api/v2/render`](/api-reference/endpoint/enqueue-render)     | Enqueue a render job                             |
| `GET`  | [`/api/v2/render/{jobId}`](/api-reference/endpoint/get-render) | Poll a job's status and result                   |
| `GET`  | [`/api/v2/me`](/api-reference/endpoint/get-me)                 | Inspect the authenticated key and credit balance |

## Conventions

* **Authentication.** Every request requires `Authorization: Bearer kdsc_live_…`. See [Authentication](/authentication).
* **Content type.** Requests and responses are JSON. Always send `Content-Type: application/json` on `POST`.
* **Timestamps.** All timestamps are ISO 8601 in UTC, e.g. `2026-04-28T17:14:02.118Z`.
* **IDs.** Treat all IDs (`jobId`, `keyId`, `userId`) as opaque strings.
* **Versioning.** This is `v2`. Breaking changes ship as `v3` at a new path; the existing `/api/v2/*` surface stays stable.
* **Errors.** Non-`2xx` responses always include an `error` field. See [Errors](/errors).