# Tedro

> Documentation for Tedro, the multi-channel communication operations platform.

## Docs

- [Reports](https://docs.tedro.io/analytics/reports.md): View analytics across conversations, automation performance, outbound campaigns, and platform usage in Tedro.
- [Chat with agent](https://docs.tedro.io/api-reference/agents/chat-with-agent.md): Send a message to an agent in the builder playground.
- [Create agent](https://docs.tedro.io/api-reference/agents/create-agent.md): Create a new AI agent. Admin only.
- [Delete agent](https://docs.tedro.io/api-reference/agents/delete-agent.md): Delete an AI agent and its knowledge. Admin only.
- [Delete document](https://docs.tedro.io/api-reference/agents/delete-document.md): Delete a knowledge base document. Admin only.
- [Get agent](https://docs.tedro.io/api-reference/agents/get-agent.md): Get a single AI agent with its configuration.
- [Get agent analytics](https://docs.tedro.io/api-reference/agents/get-agent-analytics.md): Returns usage analytics for an agent over a date range.
- [Get document](https://docs.tedro.io/api-reference/agents/get-document.md): Get a single knowledge base document.
- [Improve agent instructions](https://docs.tedro.io/api-reference/agents/improve-agent-instructions.md): Use AI to suggest improved agent instructions.
- [List agent documents](https://docs.tedro.io/api-reference/agents/list-agent-documents.md): Returns all knowledge base documents for an agent.
- [List agents](https://docs.tedro.io/api-reference/agents/list-agents.md): Returns all AI agents for the current workspace.
- [Retrain agent](https://docs.tedro.io/api-reference/agents/retrain-agent.md): Re-index the agent knowledge base. Admin only.
- [Search agent knowledge](https://docs.tedro.io/api-reference/agents/search-agent-knowledge.md): Semantic search across the agent knowledge base.
- [Update agent](https://docs.tedro.io/api-reference/agents/update-agent.md): Update an AI agent configuration, knowledge, or tools. Admin only.
- [Update document](https://docs.tedro.io/api-reference/agents/update-document.md): Update a knowledge base document content. Admin only.
- [Upload document](https://docs.tedro.io/api-reference/agents/upload-document.md): Upload a file to the agent knowledge base. Multipart form upload (max 10MB). Admin only.
- [Request password reset email](https://docs.tedro.io/api-reference/auth/request-password-reset-email.md): Send a password-reset email to the provided address (if an account exists). Rate-limited.
- [Reset password using token](https://docs.tedro.io/api-reference/auth/reset-password-using-token.md): Consume a password-reset token (from the forget-password email) and set a new password. Rate-limited.
- [Sign in with email + password](https://docs.tedro.io/api-reference/auth/sign-in-with-email-+-password.md): Authenticate an existing user and return a session. Sets the Better Auth session cookie on success.
- [Sign up with email + password](https://docs.tedro.io/api-reference/auth/sign-up-with-email-+-password.md): Create a new user account and return a session. Sets the Better Auth session cookie on success.
- [Authentication](https://docs.tedro.io/api-reference/authentication.md): How to authenticate API requests using session cookies and workspace headers.
- [Create broadcast](https://docs.tedro.io/api-reference/broadcasts/create-broadcast.md): Create a draft broadcast. Admin only.
- [Delete broadcast](https://docs.tedro.io/api-reference/broadcasts/delete-broadcast.md): Delete a draft broadcast. Admin only.
- [Estimate broadcast audience](https://docs.tedro.io/api-reference/broadcasts/estimate-broadcast-audience.md): Estimate the number of contacts matching an audience filter.
- [Get broadcast](https://docs.tedro.io/api-reference/broadcasts/get-broadcast.md): Get a single broadcast with its stats.
- [List broadcast recipients](https://docs.tedro.io/api-reference/broadcasts/list-broadcast-recipients.md): Returns paginated recipients for a broadcast.
- [List broadcasts](https://docs.tedro.io/api-reference/broadcasts/list-broadcasts.md): Returns paginated broadcasts for the current workspace.
- [Pause broadcast](https://docs.tedro.io/api-reference/broadcasts/pause-broadcast.md): Pause a sending broadcast. Admin only.
- [Resume broadcast](https://docs.tedro.io/api-reference/broadcasts/resume-broadcast.md): Resume a paused broadcast. Admin only.
- [Send broadcast](https://docs.tedro.io/api-reference/broadcasts/send-broadcast.md): Start sending a draft broadcast to its audience. Admin only.
- [Update broadcast](https://docs.tedro.io/api-reference/broadcasts/update-broadcast.md): Update a draft broadcast. Admin only.
- [Create contact](https://docs.tedro.io/api-reference/contacts/create-contact.md): Create a new contact. Admin only.
- [Delete contact](https://docs.tedro.io/api-reference/contacts/delete-contact.md): Delete a contact. Admin only.
- [Export contacts as CSV](https://docs.tedro.io/api-reference/contacts/export-contacts-as-csv.md): Download contacts as CSV file. Supports the same filters as the list endpoint. Admin only.
- [Get contact](https://docs.tedro.io/api-reference/contacts/get-contact.md): Get a single contact with conversation count.
- [List contacts](https://docs.tedro.io/api-reference/contacts/list-contacts.md): Returns paginated contacts for the current workspace, with optional filtering.
- [List unique contact tags](https://docs.tedro.io/api-reference/contacts/list-unique-contact-tags.md): Returns all unique tags across the workspace's contacts.
- [Update contact](https://docs.tedro.io/api-reference/contacts/update-contact.md): Update contact fields, tags, or opt-out status. Admin only.
- [Begin content-source OAuth flow](https://docs.tedro.io/api-reference/content/begin-content-source-oauth-flow.md): Generate an OAuth authorization URL for a Notion or Google content source.
- [Change article status](https://docs.tedro.io/api-reference/content/change-article-status.md): Transition an article between draft and published. Publishing enqueues indexing; reverting to draft enqueues removal.
- [Create article](https://docs.tedro.io/api-reference/content/create-article.md): Create a new draft article. Slug is generated from title with collision retry.
- [Create collection](https://docs.tedro.io/api-reference/content/create-collection.md): Create a new content collection. Name must be unique within the workspace.
- [Create URL source](https://docs.tedro.io/api-reference/content/create-url-source.md): Create a new URL-based content source. URLs are SSRF-validated (public HTTPS/HTTP only).
- [Delete article](https://docs.tedro.io/api-reference/content/delete-article.md): Soft-delete an article and enqueue removal from the vector store if it was indexed.
- [Delete collection](https://docs.tedro.io/api-reference/content/delete-collection.md): Soft-delete a collection. Junction rows linking items to the collection are hard-deleted.
- [Delete file](https://docs.tedro.io/api-reference/content/delete-file.md): Soft-delete a file. If indexed, removal is enqueued before soft-delete.
- [Delete source](https://docs.tedro.io/api-reference/content/delete-source.md): Soft-delete a source, remove its sync scheduler, enqueue removals for indexed children, and soft-delete child items.
- [Get article](https://docs.tedro.io/api-reference/content/get-article.md): Fetch a single article by ID (includes collection links).
- [Get source](https://docs.tedro.io/api-reference/content/get-source.md): Fetch a single source with the live count of non-deleted items.
- [List articles](https://docs.tedro.io/api-reference/content/list-articles.md): Paginated list of articles for the workspace. Supports search, status, and collection filters.
- [List collections](https://docs.tedro.io/api-reference/content/list-collections.md): List collections with a live count of non-deleted items.
- [List files](https://docs.tedro.io/api-reference/content/list-files.md): List uploaded files for the workspace.
- [List Google Drive files for source](https://docs.tedro.io/api-reference/content/list-google-drive-files-for-source.md): List Google Drive files and folders for a connected Google content source. Pass `folderId` to navigate.
- [List Notion pages for source](https://docs.tedro.io/api-reference/content/list-notion-pages-for-source.md): List accessible Notion pages for a connected Notion content source.
- [List sources](https://docs.tedro.io/api-reference/content/list-sources.md): List content sources for the workspace.
- [One-time legacy migration](https://docs.tedro.io/api-reference/content/one-time-legacy-migration.md): Migrate legacy agent_document records into the content hub (articles + files). Idempotent. Admin only.
- [Trigger manual source sync](https://docs.tedro.io/api-reference/content/trigger-manual-source-sync.md): Enqueue an immediate re-sync of a source. Returns 409 if a sync is already running.
- [Update article](https://docs.tedro.io/api-reference/content/update-article.md): Update article fields. Providing `collectionIds` replaces the existing collection set.
- [Update collection](https://docs.tedro.io/api-reference/content/update-collection.md): Update a collection name or description.
- [Update source config and trigger sync](https://docs.tedro.io/api-reference/content/update-source-config-and-trigger-sync.md): Update the provider-specific selection (Notion page IDs or Google file/folder IDs) and trigger an immediate sync.
- [Upload file](https://docs.tedro.io/api-reference/content/upload-file.md): Upload a PDF, TXT, MD, or DOCX file (max 10 MB). Text is extracted and the file is enqueued for indexing.
- [Get conversation messages](https://docs.tedro.io/api-reference/conversations/get-conversation-messages.md): Returns all messages in a conversation with contact and window status.
- [List conversations](https://docs.tedro.io/api-reference/conversations/list-conversations.md): Returns conversations with optional status filter, including contact info and last message.
- [Resolve handoff](https://docs.tedro.io/api-reference/conversations/resolve-handoff.md): Resume automation after a human handoff.
- [Send message](https://docs.tedro.io/api-reference/conversations/send-message.md): Send a human agent message in a conversation. Enforces messaging window.
- [Suggest reply](https://docs.tedro.io/api-reference/conversations/suggest-reply.md): Get an AI-generated reply suggestion for a handoff conversation.
- [Update conversation](https://docs.tedro.io/api-reference/conversations/update-conversation.md): Update conversation status or assignee.
- [Errors](https://docs.tedro.io/api-reference/errors.md): Error response format, HTTP status codes, and common error scenarios.
- [Code Examples](https://docs.tedro.io/api-reference/examples.md): Working cURL and Node.js examples for common Tedro API operations.
- [Create group](https://docs.tedro.io/api-reference/groups/create-group.md): Create a new contact group with filter conditions. Admin only.
- [Delete group](https://docs.tedro.io/api-reference/groups/delete-group.md): Delete a contact group. Admin only.
- [Estimate group count](https://docs.tedro.io/api-reference/groups/estimate-group-count.md): Count contacts matching filter conditions without persisting a group. Admin only.
- [List group contacts](https://docs.tedro.io/api-reference/groups/list-group-contacts.md): Returns paginated contacts matching the group filters.
- [List groups](https://docs.tedro.io/api-reference/groups/list-groups.md): Returns all contact groups for the current workspace.
- [Refresh group count](https://docs.tedro.io/api-reference/groups/refresh-group-count.md): Force refresh the contact count for a group.
- [Update group](https://docs.tedro.io/api-reference/groups/update-group.md): Update group name or filters. Admin only.
- [Connect integration](https://docs.tedro.io/api-reference/integrations/connect-integration.md): Connect a new integration. Tests connection before saving. Admin only.
- [Disconnect integration](https://docs.tedro.io/api-reference/integrations/disconnect-integration.md): Disconnect an integration and revoke OAuth tokens. Admin only.
- [Get integration metadata](https://docs.tedro.io/api-reference/integrations/get-integration-metadata.md): Fetch dynamic metadata (tables, fields, etc.) for an integration.
- [Initiate OAuth flow](https://docs.tedro.io/api-reference/integrations/initiate-oauth-flow.md): Generate an OAuth authorization URL for an integration provider. Admin only.
- [List connected integrations](https://docs.tedro.io/api-reference/integrations/list-connected-integrations.md): Returns all connected integrations for the current workspace (credentials excluded).
- [List integration catalog](https://docs.tedro.io/api-reference/integrations/list-integration-catalog.md): Returns all available integration types with their capabilities.
- [Sync integration tools](https://docs.tedro.io/api-reference/integrations/sync-integration-tools.md): Sync all integration tool descriptions from the registry. Admin only.
- [Test integration](https://docs.tedro.io/api-reference/integrations/test-integration.md): Test an integration connection. Admin only.
- [Update integration](https://docs.tedro.io/api-reference/integrations/update-integration.md): Update integration credentials or configuration. Admin only.
- [API Reference](https://docs.tedro.io/api-reference/introduction.md): REST API documentation for the Tedro multi-channel communication operations platform.
- [Backfill step cost totals](https://docs.tedro.io/api-reference/metrics/backfill-step-cost-totals.md): Recompute `totalUsd` on workflow_run_step rows that have token data but no cost total. Admin only.
- [Dashboard overview metrics](https://docs.tedro.io/api-reference/metrics/dashboard-overview-metrics.md): Consolidated workspace snapshot: contacts, conversations, workflows, runs, messages, recent runs.
- [Dashboard sparkline trends](https://docs.tedro.io/api-reference/metrics/dashboard-sparkline-trends.md): Daily time-series + period-over-period comparison for messages, conversations, runs, contacts.
- [Per-agent analytics](https://docs.tedro.io/api-reference/metrics/per-agent-analytics.md): Agent comparison analytics: run counts, success rate, total cost, average tokens over the range.
- [Time-series analytics](https://docs.tedro.io/api-reference/metrics/time-series-analytics.md): Bucketed analytics (message volume, runs, conversations, response times, cost-over-time).
- [Pagination](https://docs.tedro.io/api-reference/pagination.md): How to paginate through list endpoints using limit and offset parameters.
- [API Quickstart](https://docs.tedro.io/api-reference/quickstart.md): Make your first Tedro API call in under 5 minutes.
- [Rate Limiting](https://docs.tedro.io/api-reference/rate-limiting.md): API rate limits, response headers, and how to handle exceeded limits.
- [Get run](https://docs.tedro.io/api-reference/runs/get-run.md): Get a single workflow run with its definition and contact.
- [Get run steps](https://docs.tedro.io/api-reference/runs/get-run-steps.md): Get the execution steps for a workflow run.
- [List runs](https://docs.tedro.io/api-reference/runs/list-runs.md): Returns paginated workflow runs for the current workspace.
- [Replay run](https://docs.tedro.io/api-reference/runs/replay-run.md): Re-enqueue a run's trigger event for reprocessing. Admin only.
- [Get AI settings](https://docs.tedro.io/api-reference/settings:-ai/get-ai-settings.md): Returns the AI model configuration for the current workspace.
- [Update AI settings](https://docs.tedro.io/api-reference/settings:-ai/update-ai-settings.md): Update AI model configuration, API keys, or budgets. Admin only.
- [Get billing info](https://docs.tedro.io/api-reference/settings:-billing/get-billing-info.md): Returns current plan, subscription status, and billing details.
- [Get usage stats](https://docs.tedro.io/api-reference/settings:-billing/get-usage-stats.md): Returns current period usage (messages, AI tokens, workflows) against plan limits.
- [Assign workflow to channel](https://docs.tedro.io/api-reference/settings:-channels/assign-workflow-to-channel.md): Assign or unassign a workflow to a channel. Admin only.
- [Connect channel](https://docs.tedro.io/api-reference/settings:-channels/connect-channel.md): Connect a new messaging channel (WhatsApp, Instagram, or Messenger). Admin only.
- [Delete channel](https://docs.tedro.io/api-reference/settings:-channels/delete-channel.md): Disconnect and delete a channel. Admin only.
- [Get channel](https://docs.tedro.io/api-reference/settings:-channels/get-channel.md): Get a single channel with enriched data (message count, last webhook, workflow).
- [List channels](https://docs.tedro.io/api-reference/settings:-channels/list-channels.md): Returns all messaging channels for the current workspace with 24h message counts.
- [Update channel](https://docs.tedro.io/api-reference/settings:-channels/update-channel.md): Update a channel configuration. Admin only.
- [Invite team member](https://docs.tedro.io/api-reference/settings:-team/invite-team-member.md): Invite a new team member by email. Admin only.
- [List team members](https://docs.tedro.io/api-reference/settings:-team/list-team-members.md): Returns all team members for the current workspace.
- [Remove team member](https://docs.tedro.io/api-reference/settings:-team/remove-team-member.md): Remove a team member from the workspace. Admin only.
- [Update member role](https://docs.tedro.io/api-reference/settings:-team/update-member-role.md): Change a team member role (admin/agent). Admin only.
- [Get workspace settings](https://docs.tedro.io/api-reference/settings:-workspace/get-workspace-settings.md): Returns workspace name and settings.
- [Update workspace](https://docs.tedro.io/api-reference/settings:-workspace/update-workspace.md): Update workspace name. Admin only.
- [Create tag](https://docs.tedro.io/api-reference/tags/create-tag.md): Create a new tag with name and color. Admin only.
- [Delete tag](https://docs.tedro.io/api-reference/tags/delete-tag.md): Delete a tag and remove from all contacts. Admin only.
- [List tags](https://docs.tedro.io/api-reference/tags/list-tags.md): Returns all tags for the current workspace, sorted by name.
- [Update tag](https://docs.tedro.io/api-reference/tags/update-tag.md): Update a tag name or color. Renames propagate to all contacts. Admin only.
- [Create template](https://docs.tedro.io/api-reference/templates/create-template.md): Create a WhatsApp message template (submits to Meta for approval). Admin only.
- [Delete template](https://docs.tedro.io/api-reference/templates/delete-template.md): Delete a WhatsApp message template by name (all language versions). Admin only.
- [List templates](https://docs.tedro.io/api-reference/templates/list-templates.md): Returns all WhatsApp message templates from Meta API.
- [Create tool](https://docs.tedro.io/api-reference/tools/create-tool.md): Create a new tool definition with optional credential. Admin only.
- [Delete tool](https://docs.tedro.io/api-reference/tools/delete-tool.md): Delete a tool definition and its credentials. Cannot delete integration-managed tools. Admin only.
- [Get tool](https://docs.tedro.io/api-reference/tools/get-tool.md): Get a single tool definition with credential metadata (no secrets).
- [List tools](https://docs.tedro.io/api-reference/tools/list-tools.md): Returns all tool definitions for the current workspace.
- [Update tool](https://docs.tedro.io/api-reference/tools/update-tool.md): Update a tool definition. Optionally replace credentials. Admin only.
- [Create workflow](https://docs.tedro.io/api-reference/workflows/create-workflow.md): Create a new workflow with an optional trigger type. Admin only.
- [Delete workflow](https://docs.tedro.io/api-reference/workflows/delete-workflow.md): Delete a workflow and its versions. Admin only.
- [Get workflow](https://docs.tedro.io/api-reference/workflows/get-workflow.md): Get a single workflow with its draft graph and latest published version.
- [List workflows](https://docs.tedro.io/api-reference/workflows/list-workflows.md): Returns all workflows for the current workspace.
- [Publish workflow](https://docs.tedro.io/api-reference/workflows/publish-workflow.md): Validate and publish an immutable workflow version. Admin only.
- [Rename workflow](https://docs.tedro.io/api-reference/workflows/rename-workflow.md): Update a workflow name. Admin only.
- [Save workflow draft](https://docs.tedro.io/api-reference/workflows/save-workflow-draft.md): Save the draft graph for a workflow. Admin only.
- [AI Agents](https://docs.tedro.io/automation/ai-agents.md): Create AI agents with personality, knowledge bases, and tools. Test in the playground and deploy to handle conversations autonomously.
- [Workflow Builder](https://docs.tedro.io/automation/workflow-builder.md): Build automations with the visual node-based workflow canvas in Tedro.
- [Changelog](https://docs.tedro.io/changelog.md): Product updates, new features, and improvements
- [Facebook Messenger Setup](https://docs.tedro.io/channels/facebook-messenger.md): Connect your Facebook Page to handle Messenger conversations through Tedro.
- [Instagram DMs Setup](https://docs.tedro.io/channels/instagram-dms.md): Connect your Instagram Business or Creator account to receive and respond to direct messages through Tedro.
- [Live Chat Setup](https://docs.tedro.io/channels/live-chat.md): Add a live chat widget to your website and manage conversations through Tedro.
- [Welcome to Tedro](https://docs.tedro.io/introduction.md): Tedro is a multi-channel communication operations platform. Connect WhatsApp, Instagram, Messenger, and Live Chat -- build automations, deploy AI agents, and manage conversations from one workspace.
- [Key Concepts](https://docs.tedro.io/key-concepts.md): Core terminology and concepts used throughout the Tedro platform.
- [AI Nodes](https://docs.tedro.io/nodes/ai-nodes.md): AI-powered agents that handle conversations autonomously with tools, knowledge, and multi-agent handoffs.
- [Instagram Nodes](https://docs.tedro.io/nodes/instagram-nodes.md): Send direct messages and escalate conversations on Instagram.
- [Live Chat Nodes](https://docs.tedro.io/nodes/livechat-nodes.md): Send messages and escalate conversations from your website live chat widget.
- [Logic Nodes](https://docs.tedro.io/nodes/logic-nodes.md): Control flow and branching in Tedro workflows.
- [Messenger Nodes](https://docs.tedro.io/nodes/messenger-nodes.md): Send messages and escalate conversations on Facebook Messenger.
- [State Nodes](https://docs.tedro.io/nodes/state-nodes.md): Persist data on contacts and conversations in Tedro workflows.
- [Tool Nodes](https://docs.tedro.io/nodes/tool-nodes.md): Connect external services and APIs to your Tedro workflows.
- [Trigger Nodes](https://docs.tedro.io/nodes/trigger-nodes.md): Entry points that start workflow execution in Tedro.
- [WhatsApp Nodes](https://docs.tedro.io/nodes/whatsapp-nodes.md): Send messages, use templates, and escalate to human agents in Tedro workflows.
- [Broadcasts and Campaigns](https://docs.tedro.io/outbound/broadcasts-campaigns.md): Create, schedule, and track outbound message campaigns to contact groups in Tedro.
- [WhatsApp Templates](https://docs.tedro.io/outbound/whatsapp-templates.md): Create, submit for approval, and manage WhatsApp message templates for outbound messaging in Tedro.
- [Contacts and Groups](https://docs.tedro.io/platform/contacts-groups.md): Manage your contacts with tags, custom fields, groups, and CSV import/export in Tedro.
- [Inbox](https://docs.tedro.io/platform/inbox.md): Manage conversations from all channels in one place. Assign to team members, add internal notes, and resolve handoffs.
- [Organizations and Workspaces](https://docs.tedro.io/platform/organizations-workspaces.md): Manage your organization, create and configure workspaces, use the workspace switcher, and handle billing.
- [Settings](https://docs.tedro.io/platform/settings.md): Configure workspace settings, integrations, and preferences.
- [Team and Permissions](https://docs.tedro.io/platform/team-permissions.md): Invite team members, assign roles, and manage access with Tedro's organization and workspace permission system.
- [Quickstart](https://docs.tedro.io/quickstart.md): Go from signup to your first AI-powered automation in under 10 minutes.
- [WhatsApp Setup](https://docs.tedro.io/whatsapp-setup.md): Connect your WhatsApp Business number to Tedro using Meta Embedded Signup and understand WhatsApp messaging policies.

## OpenAPI Specs

- [openapi](https://docs.tedro.io/api-reference/openapi.json)