Frontline Documentation

Welcome. The Frontline Public API gives you programmatic access to your assistants, flows, automation workflows, CRM objects, tables, performance analytics, and billing information.

This section covers the concepts and conventions of the API. For per-endpoint details see the API Reference.

• Manage agents — list, create, update, deploy, and inspect AI agents and their channel settings.
• Build flows visually or via the API — create flows, add nodes, draw edges, and ship without the UI.
• Run automation workflows — define triggers, build the graph, fetch run analytics.
• Manage CRM data — objects, record types, tables, fields, rows, views, notes, tasks, files.
• Track usage — credits consumed, conversations by channel, workflow run analytics.
• Billing — view plan, credits, and subscription renewal.

https://prod-api.getfrontline.ai

All Public API endpoints are prefixed with /public/v1.

Getting started

• Getting started — your first authenticated request, step by step.
• Authentication — USER vs GENERAL keys and which endpoints need which.
• Rate limits — current quotas and how to handle 429 responses.
• Errors — error envelope, status codes, and recommended client handling.

Core Concepts

• Agents — the AI assistants you ship.
• Flows — conversation graphs that drive agent behavior.
• Workflows — account-level automations.
• Flow Variables — variables scoped to an agent's Flow.
• Workflow Variables — variables scoped to a Workflow automation.
• Intents — NLP triggers inside an agent.
• Tools — reusable HTTP integrations.
• AI Models — LLMs and transcription models available to your agents.
• Incoming Webhooks — inbound HTTPS endpoints for external systems.
• Objects — CRM entities with record types and relations.
• Record Types — categories within an Object.
• Tables — spreadsheet-style datasets.