# Staffify AI Developer Documentation

> Build voice AI products on top of Staffify. Configure agents, manage phone numbers, handle calls in real-time, and query everything programmatically with a single REST API. Base URL: https://api.staffifyai.com/v1

## Docs

- [API Reference](https://docs.staffifyai.com/docs/api): Full REST API reference — authentication, rate limits, errors, pagination
- [Authentication](https://docs.staffifyai.com/docs/api/authentication): Bearer token / X-Api-Key header. Project keys (sfy_live_*) and Org keys (sfy_org_*). Rate limits by tier.
- [Agents](https://docs.staffifyai.com/docs/api/agents): Create and manage AI voice agents — language, voice, server_url, webhook_url, knowledge bases. Full CRUD + clone + audit log.
- [server_url Guide](https://docs.staffifyai.com/docs/api/server-url): Real-time call control. Receive call.started (configure system prompt, tools, voice), tool.call (execute tools), transcript.updated. IVR menus via pre_gather. Mid-call DTMF collection. Data extraction schema.
- [Calls](https://docs.staffifyai.com/docs/api/calls): Access call history, transcripts, recordings, live status. Control in-progress calls: end, transfer, gather DTMF. Debug links with latency metrics.
- [Webhooks](https://docs.staffifyai.com/docs/api/webhooks): Org-level, project-level, and agent-level webhooks. 30+ event types. HMAC-SHA256 signature verification. Retry policy, DLQ, replay.
- [Knowledge Bases](https://docs.staffifyai.com/docs/api/knowledge-bases): Store Q&A data retrieved by agents during calls. Auto-refresh from URLs.
- [Phone Numbers](https://docs.staffifyai.com/docs/api/phone-numbers): Search, purchase, and assign numbers to agents.
- [Addresses](https://docs.staffifyai.com/docs/api/addresses): Address verification required for numbers in some countries.
- [SMS](https://docs.staffifyai.com/docs/api/sms): Send outbound SMS from Staffify phone numbers.
- [Usage](https://docs.staffifyai.com/docs/api/usage): Query call minutes, costs, and SMS usage over time.
- [Voices](https://docs.staffifyai.com/docs/api/voices): List available TTS voices by language (en-US, en-GB, nl-NL, de-DE, fr-FR, es-ES, it-IT, pt-PT, pl-PL, sv-SE, da-DK, nb-NO, fi-FI).
- [Verify](https://docs.staffifyai.com/docs/api/verify): Fuzzy-match caller answers for identity verification flows.
- [Credits](https://docs.staffifyai.com/docs/api/credits): Check account balance, tier, and concurrent call limits.
- [Error Codes](https://docs.staffifyai.com/docs/api/error-codes): HTTP status codes, auth errors, and validation error reference.
- [Organizations & Projects](https://docs.staffifyai.com/docs/api/projects): Manage org-level API keys, create and delete projects.
- [Test Sessions](https://docs.staffifyai.com/docs/api/testing): Test agent logic without a real phone call.
- [Node.js SDK](https://docs.staffifyai.com/docs/sdk): Official SDK. npm install staffify. Auto-pagination, typed responses.
- [Webhooks Guide](https://docs.staffifyai.com/docs/webhooks): End-to-end webhook integration walkthrough.
- [Widgets](https://docs.staffifyai.com/docs/widgets): Embed voice/text chat widgets on any website.
- [Integrations](https://docs.staffifyai.com/docs/custom-integrations): HubSpot, Salesforce, Pipedrive, Zoho, Zendesk, Freshdesk, Monday.com, Stripe.
- [Property Management](https://docs.staffifyai.com/docs/property-management): AI agents for property listing and tenant call handling.
- [Security](https://docs.staffifyai.com/docs/security): Infrastructure, data protection, compliance overview.

## Optional

Full API reference in plain text: https://docs.staffifyai.com/llms-full.txt