> ## Documentation Index
> Fetch the complete documentation index at: https://hellotars.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Calls API

> Place, schedule and inspect phone calls with scoped API keys and organization privacy protections.

> [!NOTE]
>
> This capability is in **beta**. Behavior can change before general availability.

Use **Read calls** to inspect calls. **Place and manage calls** includes read access and permits placement, metadata updates, stopping and content deletion.

## Place or schedule

[Create a call](https://hellotars.com/docs/developer/api/calls/create.md) now or schedule it 60 seconds to 30 days ahead. Use an Idempotency-Key when retrying a placement.

Selected-resource keys must supply an agentId within their selection. All-resources keys can use the agent assigned to the originating number.

## Read and search

[List](https://hellotars.com/docs/developer/api/calls/list.md) accepts simple filters. [Search](https://hellotars.com/docs/developer/api/calls/search.md) accepts the full condition grammar. Both exclude test calls and return newest first.

A cursor is valid only for the same query. [Get a call](https://hellotars.com/docs/developer/api/calls/get.md) includes its transcript and recording links.

## Privacy protections

Every call response applies the organization's privacy protections. Protected phone numbers, emails and variables remain masked or hidden unless the key has **Read protected call details**.

The protected permission includes **Read calls**. Grant it only to systems allowed to receive the underlying values.

## Manage calls

* [Update metadata](https://hellotars.com/docs/developer/api/calls/update.md)
* [Stop a live call](https://hellotars.com/docs/developer/api/calls/stop.md)
* [Delete call content](https://hellotars.com/docs/developer/api/calls/delete.md)
* [Read concurrency](https://hellotars.com/docs/developer/api/calls/concurrency.md)

See [Requests](https://hellotars.com/docs/developer/requests.md) for limits and idempotency.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.