> ## 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.

# Postman Collection

> Import the Bota API into Postman for interactive testing

Import the Bota OpenAPI spec into Postman to get a ready-to-use collection with all 31 API endpoints.

## Import Steps

<Steps>
  <Step title="Download the spec">
    Download [`openapi.json`](/api-reference/openapi.json) or copy the URL.
  </Step>

  <Step title="Import into Postman">
    In Postman, click **Import** → select **File** or **Link** → point to the OpenAPI spec.
  </Step>

  <Step title="Set up environment">
    Create a Postman environment with these variables:

    | Variable  | Value                            |
    | --------- | -------------------------------- |
    | `baseUrl` | `https://api.bota.dev/v1`        |
    | `apiKey`  | `sk_test_...` (or `sk_live_...`) |
  </Step>

  <Step title="Configure authentication">
    Set the collection's **Authorization** to `Bearer Token` with value `{{apiKey}}`.
  </Step>
</Steps>

## Tips

* **Test vs Production**: Duplicate the environment to maintain separate test (`sk_test_*`) and production (`sk_live_*`) configurations.
* **Chain requests**: Use Postman variables for `end_user_id`, `device_id`, and `recording_id` to chain requests across endpoints.
* **Auto-set variables**: In the **Tests** tab of create endpoints, add `pm.environment.set("end_user_id", pm.response.json().id)` to auto-capture IDs.

## Suggested Test Flow

1. **Create End User** → save `end_user_id`
2. **Register Device** → save `device_id`
3. **Bind Device** to end user
4. **Create Recording** → save `recording_id`
5. **Get Upload URL** → upload audio file
6. **Complete Upload**
7. **Create Transcription** → save `transcription_id`
8. **Poll Transcription** until `completed`
9. **Create Summary** from transcription