Workflows
Get Workflow Details
Fetch one workflow by ID.
GET
Get Workflow Details
Read only
Returns the complete record for a single workflow: the display
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.name, description, current status (such as active, paused, or cancelled), the totals of nodes and edges in the graph, the enrolled-lead count, and creation/update timestamps. This endpoint does not return the nodes or edges themselves, fetch those separately through List Nodes and List Edges when you need the full graph structure.
When to use this
- Workflow dashboards: render the workflow’s header summary (name, status, lead count) before lazy-loading the graph.
- Pre-update checks: confirm the workflow status is
pausedorinactivebefore applying structural edits. - Reporting: pull live counts of enrolled leads alongside historical call logs from List Call Logs.
Path parameters
Errors
404 Not Foundis returned when the workflow does not exist or has been deleted.403 Forbiddenis returned when the API key cannot read workflows on this workspace.
Related endpoints
- List Nodes: retrieve the workflow’s node set.
- List Edges: retrieve the transitions between nodes.
- Update Workflow Status: activate, pause, deactivate, or resume the workflow.
- List Workflow Leads: see which leads are enrolled.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workflow ID
Example:
"workflow_abc123"
Get Workflow Details