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

# cURL

> Using the Truedy API with cURL

## Overview

You can interact with the Truedy API using standard cURL commands. This is useful for testing endpoints directly from your terminal.

## Base URL

```bash theme={null}
https://api.truedy.ai/api/public/v1
```

## Authentication

Include your API key in the **Authorization** header for all requests: `Authorization: Bearer <your-api-key>`.

```bash theme={null}
-H "Authorization: Bearer YOUR_API_KEY"
```

## Examples

### List Agents

```bash theme={null}
curl -X GET "https://api.truedy.ai/api/public/v1/agents" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Create a Call

```bash theme={null}
curl -X POST "https://api.truedy.ai/api/public/v1/calls" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_123",
    "phone_number": "+15550123456"
  }'
```