# Talki Developers

> REST API and signed webhooks for the calls, appointments and contacts handled by the Talki AI phone agent. The REST API is in private beta on the Business plan; webhooks are available from Pro upward.

- Base URL: https://api.talki.it/v1
- Dated contract: 2026-10-01 (draft — fields may still change)
- Authentication: `Authorization: Bearer talki_live_…` (or `talki_test_…`)
- Contract language is English. Italian translations of these pages live under https://developers.talki.it/it/.
- The OpenAPI document owns field names, types and enum values. Where prose and schema disagree, the schema wins.

## Documentation

- [Overview](https://developers.talki.it/overview.md): What the private-beta API can read, sync, and change.
- [Quickstart](https://developers.talki.it/quickstart.md): Get a sandbox, make it take a call, and receive the signed webhook it produces.
- [Authentication](https://developers.talki.it/authentication.md): Send, store, scope, expire, and roll API keys safely.
- [OAuth apps](https://developers.talki.it/oauth.md): Let Talki customers connect your platform — authorization code with PKCE, tokens, refresh, and disconnection.
- [Sandbox](https://developers.talki.it/sandbox.md): A Talki account of your own — a seeded business, callable scenarios, and a repeatable reset.
- [Core concepts](https://developers.talki.it/concepts.md): Resource ownership, identifiers, change feeds, idempotency, and compatibility.
- [Python SDK](https://developers.talki.it/sdks/python.md): Install the talki package, call the API with typed sync or async methods, and verify webhooks and run OAuth with its helpers.
- [TypeScript SDK](https://developers.talki.it/sdks/typescript.md): Install @hubtec/talki, call the API with typed methods, and verify webhooks and run OAuth with its helpers, on Node, Bun, Deno and Workers.
- [Webhooks](https://developers.talki.it/webhooks.md): Event catalogue, envelope, signatures, retries and recovery.
- [App events](https://developers.talki.it/app-events.md): Install, scope, revoke and access events for OAuth apps, and the events about calls, appointments, contacts, services, resources, locations, documents and account settings of every installed account, delivered to the app's own URL.
- [Become a partner](https://developers.talki.it/partners.md): Offer Talki inside your software — your customers pay Talki, or you pay for them.
- [Managed billing](https://developers.talki.it/partner-billing.md): Activate Talki for your customers on your own bill — activations, plans, ending management, and monthly usage.
- [Create a CRM activity after a call](https://developers.talki.it/guides/crm-activity-after-call.md): Turn each answered call into a recoverable CRM activity.
- [Mirror a Talki appointment](https://developers.talki.it/guides/mirror-appointment.md): Keep a CRM calendar in step with Talki bookings and write changes safely.
- [Configure the assistant](https://developers.talki.it/guides/configure-assistant.md): Change the assistant's settings, the weekly hours, closures and special openings, create services and resources, and teach the assistant answers, without overwriting the owner's edits.
- [Work with locations](https://developers.talki.it/guides/locations.md): Read an account's locations, filter by location, configure one location at a time, and book at the right one.
- [Manage the knowledge base](https://developers.talki.it/guides/knowledge-base.md): Add the text notes, files and websites the assistant answers from, wait for them to be indexed, replace, switch off and download them, and keep a copy in sync.
- [Errors and rate limits](https://developers.talki.it/errors.md): Stable error codes, booking conflicts, request IDs, retries, and limits.
- [Security and data handling](https://developers.talki.it/security.md): What you are handling, what is retained, and what is expected of you.
- [Changelog and lifecycle](https://developers.talki.it/changelog.md): What changed, what is deprecated, and which versions are served.
- [Support](https://developers.talki.it/support.md): What to include when you report a problem.

## Machine-readable contract

- [OpenAPI document](https://developers.talki.it/openapi.yaml): the pinned public contract, generated from the backend schemas.
- [Full documentation in one file](https://developers.talki.it/llms-full.txt): every page above, concatenated.