# Vocapable

> API-first AI calling platform: BYOK Twilio telephony, Workspace and Headless consumption modes, a non-waivable compliance floor, RFC 9457 errors with a stable code registry.

## Documentation Sets

- [Abridged documentation](https://docs.vocapable.com/llms-small.txt): a compact version of the documentation for Vocapable, with non-essential content removed
- [Complete documentation](https://docs.vocapable.com/llms-full.txt): the full documentation for Vocapable

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Documentation index

- [Vocapable for developers](https://docs.vocapable.com/): API-first AI calling: BYOK Twilio telephony, Workspace and Headless consumption modes, a $49 sandbox with free simulated test keys, and a compliance floor that is structurally impossible to skip.
- [API reference](https://docs.vocapable.com/api-reference): Every operation of the Vocapable Control API, generated from the committed OpenAPI 3.1 snapshot, grouped by resource, with provenance.
- [Agents & templates](https://docs.vocapable.com/guides/agents-and-templates): Draft agents, immutable published versions, the golden-suite publish gate, and the platform template library.
- [Auth & scopes](https://docs.vocapable.com/guides/auth-and-scopes): Bearer API keys, the twenty-five-scope catalog, key rotation, and the deliberately information-free 401, plus how authentication and authorization work on /v1.
- [Billing & meters](https://docs.vocapable.com/guides/billing-and-meters): The nine usage meters, why BYO carrier minutes never appear on your Vocapable invoice, and how spend caps fail closed.
- [Campaigns & scrub](https://docs.vocapable.com/guides/campaigns-and-scrub): The launch path: import contacts, run a scrub, acknowledge the report, and launch, with every refusal the gate can raise.
- [Conventions](https://docs.vocapable.com/guides/conventions): Prefixed ULIDs, cursor pagination, Idempotency-Key, rate limits, E.164, RFC 3339, and ETag/304: the rules every endpoint follows.
- [Custom questions](https://docs.vocapable.com/guides/custom-questions): Typed survey objectives with scoring, and per-call questions on POST /v1/calls - ask something different on every call without republishing the agent.
- [Errors](https://docs.vocapable.com/guides/errors): RFC 9457 problem responses with stable, machine-matchable type URIs that resolve to the error registry on this site.
- [Headless mode](https://docs.vocapable.com/guides/headless-mode): Your stack as the system of record: contacts created via API with a consent basis, calls driven from your own scheduler, outcomes returned by webhook, with no CSV and no list upload.
- [Receive results](https://docs.vocapable.com/guides/receive-results): Every call's answers, disposition, and analysis pushed to your endpoint - payloads, the test ping, and self-service redrive.
- [Test mode](https://docs.vocapable.com/guides/test-mode): vcp_test_ keys route all telephony to a mock provider: free, no PSTN, with deterministic outcomes selected by the destination's last digit.
- [Webhooks](https://docs.vocapable.com/guides/webhooks): One endpoint per tenant, call-lifecycle delivery, and HMAC-signed verification snippets in TypeScript and Python.
- [Postman collection](https://docs.vocapable.com/postman): Download the generated Postman collection, wire up the two variables, and make your first request against the sandbox.
- [Quickstart](https://docs.vocapable.com/quickstart): From API key to a draft agent, a scripted release check, a simulated test call, and back to a rotated key.
- [Error registry](https://docs.vocapable.com/errors): all 506 RFC 9457 error codes, one page per code - the API's `type` URIs resolve here

## Machine-readable

- [OpenAPI specification](https://docs.vocapable.com/openapi.json): the complete contract - every operation, request/response schema, and auth scheme
- [Postman collection](https://docs.vocapable.com/postman/vocapable.postman_collection.json)
- [llms-full.txt](https://docs.vocapable.com/llms-full.txt): every documentation page PLUS the full API contract and error registry, in one file