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

# API Reference

> REST API documentation for the Tedro multi-channel communication operations platform.

# Tedro API

The Tedro REST API lets you programmatically manage workflows, contacts, conversations, runs, and more. All endpoints are served from `https://api.tedro.io` and return JSON responses.

## Base URL

```
https://api.tedro.io
```

## Quick Overview

The API is organized around these core resources:

| Resource          | Description                                            |
| ----------------- | ------------------------------------------------------ |
| **Workflows**     | Create, edit, publish, and delete automation workflows |
| **Contacts**      | Manage contacts across all channels and their metadata |
| **Conversations** | View conversation threads and send messages            |
| **Runs**          | Inspect workflow execution history and replay runs     |
| **Agents**        | Configure AI agents with knowledge bases and documents |
| **Broadcasts**    | Send bulk template messages to contact groups          |
| **Tags**          | Organize contacts with labels                          |
| **Tools**         | Register external HTTP and MCP tools for AI nodes      |
| **Templates**     | Manage WhatsApp message templates                      |
| **Settings**      | Configure channels, AI, team, workspace, and billing   |
| **Integrations**  | Connect third-party services and sync tools            |

## Authentication

Every API request requires two things:

1. A **session cookie** obtained by signing in
2. An **`x-workspace-id` header** with your workspace UUID

See the [Authentication](/api-reference/authentication) page for details and working examples.

## Getting Started

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Learn how to authenticate your API requests with session cookies and workspace headers.
  </Card>

  <Card title="API Quickstart" icon="rocket" href="/api-reference/quickstart">
    Make your first API call in under 5 minutes with a working cURL example.
  </Card>

  <Card title="Error Reference" icon="circle-exclamation" href="/api-reference/errors">
    Understand error response formats, HTTP status codes, and common error scenarios.
  </Card>

  <Card title="Code Examples" icon="code" href="/api-reference/examples">
    Copy-paste cURL and Node.js examples for common API operations.
  </Card>
</CardGroup>

## Conventions

* **UUIDs** -- All resource IDs are UUIDs (e.g., `550e8400-e29b-41d4-a716-446655440000`)
* **JSON** -- Request and response bodies use `application/json`
* **Pagination** -- List endpoints support `limit` and `offset` query parameters
* **Workspace isolation** -- All data is scoped to the workspace specified in `x-workspace-id`