# StateSet Voice API

Base URL: https://voice.stateset.app

Documentation:
- Overview: https://voice.stateset.app/docs
- Getting started: https://voice.stateset.app/getting-started
- Request API access: https://voice.stateset.app/request-access
- Build voice agents: https://voice.stateset.app/docs/voice-agents
- First voice agent tutorial: https://voice.stateset.app/docs/tutorials/first-voice-agent
- Architecture: https://voice.stateset.app/docs/architecture
- Endpoint guides: https://voice.stateset.app/docs/api-reference
- Make call endpoint: https://voice.stateset.app/docs/endpoints/make-call
- Incoming call endpoint: https://voice.stateset.app/docs/endpoints/incoming-call
- Call logs endpoint: https://voice.stateset.app/docs/endpoints/call-logs
- Voice sessions endpoint: https://voice.stateset.app/docs/endpoints/voice-sessions
- SDKs and client generation: https://voice.stateset.app/docs/sdks
- TypeScript client: https://voice.stateset.app/docs/sdks/typescript
- Python client: https://voice.stateset.app/docs/sdks/python
- Code examples: https://voice.stateset.app/docs/examples
- Authentication: https://voice.stateset.app/docs/authentication
- Errors and retries: https://voice.stateset.app/docs/errors
- Rate limits: https://voice.stateset.app/docs/rate-limits
- Pagination: https://voice.stateset.app/docs/pagination
- Idempotency: https://voice.stateset.app/docs/idempotency
- Webhooks: https://voice.stateset.app/docs/webhooks
- Webhook event catalog: https://voice.stateset.app/docs/webhook-events
- Webhook signatures: https://voice.stateset.app/docs/webhook-signatures
- Versioning: https://voice.stateset.app/docs/versioning
- Changelog: https://voice.stateset.app/docs/changelog
- Sandbox and test mode: https://voice.stateset.app/docs/sandbox
- Production readiness: https://voice.stateset.app/docs/production-readiness

OpenAPI:
- Full spec: https://voice.stateset.app/api-docs/openapi.json
- Public tenant spec: https://voice.stateset.app/api-docs/public.json
- Admin spec: https://voice.stateset.app/api-docs/admin.json
- Swagger UI: https://voice.stateset.app/swagger-ui/

Authentication:
- Tenant API calls use Authorization: Bearer <tenant_api_key>.
- Admin calls use x-admin-key: <admin_api_key> or an authenticated admin session.
- Twilio callbacks must include X-Twilio-Signature.
- Media streams use short-lived stream tokens.

Core endpoints:
- GET /status
- GET /health
- GET /api/v1/call-logs
- GET /api/v1/voice-sessions
- POST /api/v1/access-requests
- POST /api/v1/make-call
- POST /api/v1/incoming-call
- GET /api/v1/admin/tenants
- GET /api/v1/admin/agents

Use this API to configure tenants, build voice agents, start outbound calls, handle inbound calls, inspect sessions, stream logs, run evaluations, and operate production voice workflows.