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

# OpenAPI Spec

> Download the OpenAPI 3.1 specification for the Bota API

The Bota API provides a complete [OpenAPI 3.1](https://spec.openapis.org/oas/v3.1.0) specification that you can use with any API tool or to generate client SDKs.

## Download

<Card title="openapi.json" icon="file-code" href="/api-reference/openapi.json">
  OpenAPI 3.1 specification — 31 endpoints across End Users, Devices, Recordings, Uploads, Transcriptions, and Summaries.
</Card>

## Import into API Tools

The spec can be imported directly into:

* **[Postman](/api-reference/postman)** — interactive testing and collection management
* **[Insomnia](https://insomnia.rest)** — REST client with OpenAPI import
* **[Bruno](https://www.usebruno.com)** — open-source API client
* **[Hoppscotch](https://hoppscotch.io)** — web-based API platform

## Generate Client SDKs

Generate typed clients in your language using [openapi-generator](https://openapi-generator.tech):

<CodeGroup>
  ```bash TypeScript theme={null}
  openapi-generator generate \
    -i openapi.json \
    -g typescript-fetch \
    -o ./bota-sdk-ts
  ```

  ```bash Python theme={null}
  openapi-generator generate \
    -i openapi.json \
    -g python \
    -o ./bota-sdk-python
  ```

  ```bash Go theme={null}
  openapi-generator generate \
    -i openapi.json \
    -g go \
    -o ./bota-sdk-go
  ```
</CodeGroup>

## Spec Coverage

The specification includes all public API endpoints:

| Resource       | Endpoints                                                                               |
| -------------- | --------------------------------------------------------------------------------------- |
| End Users      | 5 (create, list, get, update, delete)                                                   |
| Devices        | 12 (register, list, get, state, update, bind, unbind, heartbeat, wifi-config, commands) |
| Recordings     | 5 (create, finalize, list, get, delete)                                                 |
| Uploads        | 3 (upload URL, download URL, complete)                                                  |
| Transcriptions | 3 (create, list, get)                                                                   |
| Summaries      | 3 (create, list, get)                                                                   |