# Resia API

> Resia places and answers phone calls for you. Its workflows can coordinate calls, messages, and waits.

Hand this file to your coding assistant. Everything it needs to integrate is linked below.

## The API

- [OpenAPI contract](https://api.resia.ai/openapi.json): the complete machine-readable API. Generate a client from it, or read it directly.
- [Task guides](https://api.resia.ai/redoc#section/Start-here): account access, a first call, incoming calls, core concepts, agent edits, and call results. The same guides appear in the OpenAPI contract's `info.description`.

## What's changed

- [Changelog](https://api.resia.ai/changelog.json): every published change to the contract as JSON, newest first, breaking ones marked. Human-readable version at https://api.resia.ai/changelog.

## Getting started

1. Get an API key through the Resia portal. Follow the account access guide if you need an invitation.
2. Send the complete key on every request: `Authorization: Bearer <api-key>`.
3. Create and configure a Call Agent with `POST /v1/call-agents`; use its `id` as `call_agent_id` when placing calls.
4. Place a call with `POST /v1/calls`, then poll `GET /v1/calls/{call_id}` for its status, transcript, and analysis. Calls are asynchronous — you get `202 Accepted`, then poll.