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.
Tedro API
The Tedro REST API lets you programmatically manage workflows, contacts, conversations, runs, and more. All endpoints are served fromhttps://api.tedro.io and return JSON responses.
Base URL
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:- A session cookie obtained by signing in
- An
x-workspace-idheader with your workspace UUID
Getting Started
Authentication
Learn how to authenticate your API requests with session cookies and workspace headers.
API Quickstart
Make your first API call in under 5 minutes with a working cURL example.
Error Reference
Understand error response formats, HTTP status codes, and common error scenarios.
Code Examples
Copy-paste cURL and Node.js examples for common API operations.
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
limitandoffsetquery parameters - Workspace isolation — All data is scoped to the workspace specified in
x-workspace-id