GET
/
api
/
v1
/
insights
/
workflows
/
{workflow_id}
Python (SDK)
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.insights.workflows.get_by_id(workflow_id=788857)

    # Handle response
    print(res)
{
  "name": "summary-workflow",
  "source": "agent",
  "description": "Default workflow - generates a summary of the call",
  "insight_tool_ids": [
    1
  ],
  "conditions": {
    "min_duration": 120,
    "max_duration": 600,
    "sample_rate": 0.1,
    "agent_list": [
      866324,
      826325
    ],
    "prompt_list": [
      "123324"
    ],
    "folder_list": [
      16754,
      67535
    ],
    "sheet_info": {
      "sheet_id": "1AGOCYz05AZYYOMzow2EYlgdDXSXaWIhyA3-zCxBm4go",
      "sheet_name": "Q1 Sales Data"
    }
  },
  "start_datetime": "2025-09-10T00:00:00Z",
  "end_datetime": "2025-09-11T00:00:00Z",
  "id": 1,
  "insight_tools": [
    {
      "name": "summary-tool",
      "description": "This tool uses GPT4.1 to generate a summary of the call",
      "version": 1,
      "tool_arguments": "<any>",
      "insight_tool_definition_id": 1,
      "id": 1,
      "insight_tool_definition": {
        "id": 1,
        "name": "llm_tool",
        "type": "<string>",
        "description": "An LLM tool evaluates a transcript with a given prompt",
        "tool_parameters": "<any>",
        "tool_result_set": "<any>"
      },
      "created_at": "2025-09-10T00:00:00Z",
      "updated_at": "2025-09-11T00:00:00Z",
      "last_updated_by": "user@email.com"
    }
  ],
  "status": "ACTIVE",
  "estimate": {
    "backfill_count": 100,
    "backfill_duration": 1000,
    "estimated_daily_count": 10,
    "estimated_daily_duration": "3674.11",
    "estimated_daily_cost": "45.25",
    "estimated_backfill_cost": "4561.00"
  },
  "queue_count": 10,
  "created_at": "2025-09-10T00:00:00Z",
  "updated_at": "2025-09-11T00:00:00Z",
  "last_updated_by": "user@email.com"
}

Authorizations

Syllable-API-Key
string
header
required

Path Parameters

workflow_id
integer
required

Response

Successful Response

Response model for an insight workflow.

name
string
required

Human-readable name of insight workflow

Examples:

"summary-workflow"

source
string
required

Source of the workflow

Examples:

"agent"

"transfer"

"upload"

"sheet"

"manual"

description
string
required

Text description of workflow

Examples:

"Default workflow - generates a summary of the call"

insight_tool_ids
integer[]
required

Ordered list of IDs of tool configurations to be executed in the workflow

Examples:
[1]
conditions
object
required

Conditions (filters) on which a workflow should be triggered.

id
integer
required

Internal ID of the insight workflow

Examples:

1

insight_tools
InsightToolOutput · object[]
required

List of insight tool configurations used in the workflow

status
string
required

Status of the insight workflow

Examples:

"ACTIVE"

"INACTIVE"

estimate
object
required

Estimate of the number of calls that will be processed by the workflow and their cost

last_updated_by
string
required

Email of user who last updated Insight Workflow

Examples:

"user@email.com"

start_datetime
string<date-time> | null

Target session timestamp the workflow (backfill) should start. An empty value indicates start on activation - live sessions only

Examples:

"2025-09-10T00:00:00Z"

end_datetime
string<date-time> | null

Target session timestamp the workflow (backfill) should end. An empty value indicates no end, i.e., include live sessions until deactivation

Examples:

"2025-09-11T00:00:00Z"

queue_count
integer | null

Number of calls in the workflow queue (pending or processing)

Examples:

10

created_at
string<date-time>

Timestamp at which the insight workflow was created

Examples:

"2025-09-10T00:00:00Z"

updated_at
string<date-time>

Timestamp of most recent update to the insight workflow

Examples:

"2025-09-11T00:00:00Z"