# Bota

> Bota is a multi-tenant hardware + API platform for capturing, transcribing, and summarizing offline conversations via AI wearable devices. B2B2C model: your backend calls the Bota API; your end users wear the devices. Bota never has a direct relationship with end users.

## Get Started

- [Overview](https://docs.bota.dev): Platform overview, architecture, use cases (healthcare, sales, legal, enterprise)
- [Quickstart](https://docs.bota.dev/quickstart): Full walkthrough — create end user, register device, upload audio, get transcript
- [Core Concepts](https://docs.bota.dev/concepts): Entity model — Organization, Project, EndUser, Device, Recording, Transcription, Summary

## Authentication

- [Authentication](https://docs.bota.dev/authentication): API key types (sk_live_*, sk_test_*, rk_*, dtok_*, up_*), security practices, mobile vs server flows

## API Reference

- [API Introduction](https://docs.bota.dev/api-reference/introduction): Base URL, headers, response format, HTTP status codes
- [Pagination](https://docs.bota.dev/api-reference/pagination): Cursor-based pagination with limit and cursor params
- [Idempotency](https://docs.bota.dev/api-reference/idempotency): Safe retries using Idempotency-Key header
- [External IDs](https://docs.bota.dev/api-reference/external-ids): Mapping your user/device IDs to Bota resources via external_id
- [Test Mode](https://docs.bota.dev/api-reference/test-mode): sk_test_* keys, isolated data, no billing
- [Errors](https://docs.bota.dev/api-reference/errors): Error codes and handling strategies
- [Rate Limits](https://docs.bota.dev/api-reference/rate-limits): 100 req/s, 1000 req/min

## End Users

- [Create End User](https://docs.bota.dev/api-reference/end-users/create): POST /v1/end-users
- [List End Users](https://docs.bota.dev/api-reference/end-users/list): GET /v1/end-users
- [Get End User](https://docs.bota.dev/api-reference/end-users/get): GET /v1/end-users/:id
- [Delete End User](https://docs.bota.dev/api-reference/end-users/delete): DELETE /v1/end-users/:id — cascades to recordings, transcriptions, summaries

## Devices

- [Register Device](https://docs.bota.dev/api-reference/devices/create): POST /v1/devices with serial_number
- [Bind Device](https://docs.bota.dev/api-reference/devices/bind): POST /v1/devices/:id/bind — returns dtok_* for cellular devices
- [Unbind Device](https://docs.bota.dev/api-reference/devices/unbind): POST /v1/devices/:id/unbind — rotates device token
- [List Devices](https://docs.bota.dev/api-reference/devices/list): GET /v1/devices
- [Get Device](https://docs.bota.dev/api-reference/devices/get): GET /v1/devices/:id
- [Update Device](https://docs.bota.dev/api-reference/devices/update): PATCH /v1/devices/:id
- [Reset Device](https://docs.bota.dev/api-reference/devices/reset): POST /v1/devices/:id/reset — durable local-device wipe command; ACK finalizes backend unbind/token revocation while cloud data is preserved
- [Device Management Guide](https://docs.bota.dev/guides/device-management): Fleet operations, reassignment, lifecycle

## Recordings

- [Create Recording](https://docs.bota.dev/api-reference/recordings/create): POST /v1/recordings — creates the record before upload
- [List Recordings](https://docs.bota.dev/api-reference/recordings/list): GET /v1/recordings — filter by end_user_id, device_id, status
- [Get Recording](https://docs.bota.dev/api-reference/recordings/get): GET /v1/recordings/:id
- [Delete Recording](https://docs.bota.dev/api-reference/recordings/delete): DELETE /v1/recordings/:id

## Uploads

- [Get Upload URL](https://docs.bota.dev/api-reference/uploads/create-url): POST /v1/recordings/:id/upload-url — presigned S3 PUT URL
- [Complete Upload](https://docs.bota.dev/api-reference/uploads/complete): POST /v1/recordings/:id/upload-complete — triggers auto-processing
- [Get Download URL](https://docs.bota.dev/api-reference/uploads/download-url): GET /v1/recordings/:id/download-url — presigned S3 GET URL
- [Finalize Streaming](https://docs.bota.dev/api-reference/recordings/finalize-streaming): POST /v1/recordings/:id/finalize — stitch chunks after streaming upload

## AI Processing

- [Transcriptions](https://docs.bota.dev/api-reference/ai/transcriptions): POST /v1/transcriptions — ASR with speaker diarization and timestamps
- [Summaries](https://docs.bota.dev/api-reference/ai/summaries): POST /v1/summaries — LLM summary from transcription, supports templates
- [Auto-Processing](https://docs.bota.dev/guides/auto-processing): Zero-code pipeline — upload once, get transcription and summary automatically

## Webhooks

- [Webhooks Overview](https://docs.bota.dev/webhooks/overview): Setup, timestamp-bound v1 HMAC-SHA256 verification, replay protection, retry policy, best practices
- [Webhook Events](https://docs.bota.dev/webhooks/events): All event types (recording.*, transcription.*, summary.*, device.*) with payload schemas

## Guides

- [Streaming Upload](https://docs.bota.dev/guides/streaming-upload): Chunked upload during recording for faster time-to-transcript
- [Hierarchical Config](https://docs.bota.dev/guides/hierarchical-config): Override settings at org → project → end_user → device level
- [Connectivity](https://docs.bota.dev/guides/connectivity): BLE sync, WiFi, cellular — upload paths and failover
- [Cellular Mode](https://docs.bota.dev/guides/cellular-mode): 4G device direct upload without a mobile app

## Hardware

- [Bota Pin](https://docs.bota.dev/hardware/pin): BLE wearable, syncs via mobile app
- [Bota Pin Pro](https://docs.bota.dev/hardware/pin-pro): BLE + cellular, can upload directly
- [Fleet Management](https://docs.bota.dev/hardware/fleet-management): Bulk provisioning and monitoring

## Optional

- [Full Documentation](https://docs.bota.dev/llms-full.txt): Single-file comprehensive reference — fetch this to understand the full Bota API without searching individual pages
- [Skills Repository](https://raw.githubusercontent.com/bota-dev/bota-skills/main/index.json): Machine-readable catalog of agent-ready integration guides (device registration, recording upload, webhooks, auto-processing, streaming upload)