# Saperly Docs

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For a complete documentation index, see https://docs.saperly.com/llms.txt
- For full documentation content in one file, see https://docs.saperly.com/llms-full.txt
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.saperly.com/_mcp/server

## Docs

- [Welcome](https://docs.saperly.com/welcome.md): Build AI agents that can call, text, and stay compliant from day one.
- [Quickstart](https://docs.saperly.com/quickstart.md)
- [Agent onboarding](https://docs.saperly.com/agent-onboarding.md)
- [Service keys](https://docs.saperly.com/service-keys.md)
- [Core Concepts](https://docs.saperly.com/core-concepts.md)
- [Hosted Mode](https://docs.saperly.com/guides/hosted-mode.md)
- [Webhook Mode](https://docs.saperly.com/guides/webhook-mode.md)
- [Audio Mode](https://docs.saperly.com/guides/audio-mode.md)
- [SMS and Conversations](https://docs.saperly.com/guides/sms-and-conversations.md)
- [Compliance and Consent](https://docs.saperly.com/guides/compliance-and-consent.md)
- [Billing and Usage](https://docs.saperly.com/guides/billing-and-usage.md)
- [Voice pricing zones](https://docs.saperly.com/guides/voice-zones.md)
- [SMS pricing zones](https://docs.saperly.com/guides/sms-zones.md)
- [Authentication](https://docs.saperly.com/reference/authentication.md)
- [API Overview](https://docs.saperly.com/reference/api-overview.md)
- [Errors and Testing](https://docs.saperly.com/reference/errors-and-testing.md)
- [Cloudflare Insights CSP allowlist](https://docs.saperly.com/changelog/2026-05-13-cloudflare-insights-csp.md): 2026-05-13 · v0.5.7.3 · fix
- [Agent-native key management](https://docs.saperly.com/changelog/2026-05-13-agent-native-key-management.md): 2026-05-13 · v0.5.7.0 · feature
- [Postpaid auto-charge and low-balance modal](https://docs.saperly.com/changelog/2026-05-06-postpaid-auto-charge.md): 2026-05-06 · v0.5.5.0 · feature
- [Cents-honest pricing reprice](https://docs.saperly.com/changelog/2026-05-04-cents-honest-pricing.md): 2026-05-04 · v0.5.3 · pricing
- [Stripe payments foundation](https://docs.saperly.com/changelog/2026-04-28-stripe-payments-foundation.md): 2026-04-28 · v0.5.0.0 · platform
- [Hosted/webhook mode rename](https://docs.saperly.com/changelog/2026-04-20-mode-rename.md): 2026-04-20 · v0.3.0.0 · breaking
- [Upgrading to v0.5.7.0](https://docs.saperly.com/changelog/upgrade-v0570.md): Service keys + /v1/keys lifecycle endpoints

## API Docs

- API Reference > Health [Health check](https://docs.saperly.com/api-reference/health/get-health.md)
- API Reference > Auth [List API keys](https://docs.saperly.com/api-reference/auth/list-api-keys.md)
- API Reference > Auth [Create an API key](https://docs.saperly.com/api-reference/auth/create-api-key.md)
- API Reference > Keys [List child API keys](https://docs.saperly.com/api-reference/keys/list-child-api-keys.md)
- API Reference > Keys [Mint a child API key](https://docs.saperly.com/api-reference/keys/create-child-api-key.md)
- API Reference > Keys [Get a child API key](https://docs.saperly.com/api-reference/keys/get-child-api-key.md)
- API Reference > Keys [Revoke a child API key](https://docs.saperly.com/api-reference/keys/revoke-child-api-key.md)
- API Reference > Keys [Update a child API key](https://docs.saperly.com/api-reference/keys/update-child-api-key.md)
- API Reference > Keys [Atomically rotate a child API key](https://docs.saperly.com/api-reference/keys/rotate-child-api-key.md)
- API Reference > Lines [List all lines](https://docs.saperly.com/api-reference/lines/list-lines.md)
- API Reference > Lines [Provision a new phone line](https://docs.saperly.com/api-reference/lines/create-line.md)
- API Reference > Lines [Get a line](https://docs.saperly.com/api-reference/lines/get-line.md)
- API Reference > Lines [Release a line](https://docs.saperly.com/api-reference/lines/delete-line.md)
- API Reference > Lines [Update a line](https://docs.saperly.com/api-reference/lines/update-line.md)
- API Reference > Lines [Rotate the webhook signing secret for a line](https://docs.saperly.com/api-reference/lines/rotate-webhook-secret.md)
- API Reference > Calls [List calls](https://docs.saperly.com/api-reference/calls/list-calls.md)
- API Reference > Calls [Initiate an outbound call](https://docs.saperly.com/api-reference/calls/initiate-call.md)
- API Reference > Calls [Get a call](https://docs.saperly.com/api-reference/calls/get-call.md)
- API Reference > Calls [Hang up an active call](https://docs.saperly.com/api-reference/calls/hangup-call.md)
- API Reference > Calls [Initiate a conversation call](https://docs.saperly.com/api-reference/calls/initiate-conversation-call.md)
- API Reference > Sms [Send an SMS](https://docs.saperly.com/api-reference/sms/send-sms.md)
- API Reference > Conversations [List SMS conversations](https://docs.saperly.com/api-reference/conversations/list-conversations.md)
- API Reference > Conversations [Get messages in a conversation](https://docs.saperly.com/api-reference/conversations/get-conversation-messages.md)
- API Reference > Consent [Check consent status](https://docs.saperly.com/api-reference/consent/check-consent.md)
- API Reference > Consent [Grant consent](https://docs.saperly.com/api-reference/consent/grant-consent.md)
- API Reference > Consent [Revoke consent](https://docs.saperly.com/api-reference/consent/revoke-consent.md)
- API Reference > Compliance [Query compliance audit trail](https://docs.saperly.com/api-reference/compliance/query-compliance-audit.md)
- API Reference > Compliance [Query compliance events (alias)](https://docs.saperly.com/api-reference/compliance/query-compliance-events.md)
- API Reference > Compliance [Agent self-audit feed](https://docs.saperly.com/api-reference/compliance/get-agent-audit.md)
- API Reference > Disclosures [List disclosures](https://docs.saperly.com/api-reference/disclosures/list-disclosures.md)
- API Reference > Disclosures [Create a disclosure config](https://docs.saperly.com/api-reference/disclosures/create-disclosure.md)
- API Reference > Webhooks [List webhook deliveries](https://docs.saperly.com/api-reference/webhooks/list-webhook-deliveries.md)
- API Reference > Webhooks [Get webhook delivery statistics](https://docs.saperly.com/api-reference/webhooks/get-webhook-stats.md)
- API Reference > Webhooks [Send a test webhook](https://docs.saperly.com/api-reference/webhooks/test-webhook.md)
- API Reference > Billing [Get account balance](https://docs.saperly.com/api-reference/billing/get-balance.md)
- API Reference > Billing [List billing transactions](https://docs.saperly.com/api-reference/billing/list-transactions.md)
- API Reference > Settings [Get account settings](https://docs.saperly.com/api-reference/settings/get-settings.md)
- API Reference > Settings [Update account settings](https://docs.saperly.com/api-reference/settings/update-settings.md)
- API Reference > Usage [Get daily usage](https://docs.saperly.com/api-reference/usage/get-daily-usage.md)
- API Reference > Usage [Get monthly usage](https://docs.saperly.com/api-reference/usage/get-monthly-usage.md)
- API Reference > Voices [List available voices](https://docs.saperly.com/api-reference/voices/list-voices.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.saperly.com/openapi.json)
- [OpenAPI YAML](https://docs.saperly.com/openapi.yaml)