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

# OpenAPI Specification

> Download the OpenAPI 3.1 specification and generate client libraries for the Cuadra AI API.

## Try the API Playground

1. Navigate to any endpoint page (e.g., [Create Chat](/api-reference/endpoints/chats/create-or-continue-chat))
2. Click **Try it** in the request panel
3. Enter your Bearer token
4. Modify parameters and send the request

<Info>
  The playground makes real API requests. Use a test model to avoid consuming production credits.
</Info>

***

## Download OpenAPI Specification

The OpenAPI spec is auto-generated from our codebase and always reflects the latest API:

| Format             | URL                                                                    |
| ------------------ | ---------------------------------------------------------------------- |
| OpenAPI 3.1 (JSON) | [api.cuadra.ai/v1/openapi.json](https://api.cuadra.ai/v1/openapi.json) |

***

## Generate Client Libraries

Use [OpenAPI Generator](https://openapi-generator.tech/) to create type-safe clients in any language:

<CodeGroup>
  ```bash Python theme={null}
  pip install openapi-generator-cli
  openapi-generator generate \
    -i https://api.cuadra.ai/v1/openapi.json \
    -g python \
    -o ./cuadra-client \
    --additional-properties=packageName=cuadra
  ```

  ```bash TypeScript theme={null}
  npm install @openapitools/openapi-generator-cli -g
  openapi-generator generate \
    -i https://api.cuadra.ai/v1/openapi.json \
    -g typescript-fetch \
    -o ./cuadra-client
  ```

  ```bash Go theme={null}
  openapi-generator generate \
    -i https://api.cuadra.ai/v1/openapi.json \
    -g go \
    -o ./cuadra-client \
    --additional-properties=packageName=cuadra
  ```
</CodeGroup>

***

## API Versioning

The API version is included in the base URL:

```
https://api.cuadra.ai/v1/...
```

| Version | Status          |
| ------- | --------------- |
| v1      | Current, stable |

Breaking changes are communicated via email and changelog updates before release.

***

## Related

<CardGroup cols={2}>
  <Card title="API Overview" icon="book" href="/api-reference/overview">
    Base URL, authentication, rate limits
  </Card>

  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    JWT and M2M setup
  </Card>
</CardGroup>