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

​
Import Steps

1

Download the spec

Download openapi.json or copy the URL.
2

Import into Postman

In Postman, click Import → select File or Link → point to the OpenAPI spec.
3

Set up environment

Create a Postman environment with these variables:
VariableValue
baseUrlhttps://api.bota.dev/v1
apiKeysk_test_... (or sk_live_...)
4

Configure authentication

Set the collection’s Authorization to Bearer Token with value {{apiKey}}.

​
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