Tedro API
The Tedro REST API lets you programmatically manage workflows, contacts, conversations, runs, and more. All endpoints are served fromhttps://api.tedrox.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 WhatsApp contacts 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-tenant-idheader with your workspace UUID
Getting Started
Authentication
Learn how to authenticate your API requests with session cookies and tenant 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 - Tenant isolation — All data is scoped to the workspace specified in
x-tenant-id