API documentation

POST /transcription_flows

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/transcription_flows

Create Transcription Flow.

Create a transcription flow that defines which call recording types get transcribed and which analysis runs on them, such as PII redaction, summaries, sentiment, topics, entities, and highlights. Flows belong to a transcription_flow_group and can be scoped to matching calls with a record_token_filter.

Params

Param name	Description
transcription_flow_group_id Optional Blank value allowed	Transcription Flow Group Must be a String
name Optional Blank value allowed	Name Must be a String
recording_types Optional Blank value allowed	Recording Types Must be an array of strings. EG: `["abc123", "xzy023"]`
description Optional Blank value allowed	Description Must be a String
record_token_filter_id Optional Blank value allowed	Record Token Filter Must be a valid foreign key reference to an Filters. Refer to: /api/docs/1.0/record_token_filters
token_value_ids Optional Blank value allowed	Token Value Ids Must be a decimal number.
transcription_keyword_group_id Optional Blank value allowed	The Transcription Keyword Group scanned for in this flow’s transcripts, if any. Must be a valid foreign key reference to an Transcription Keyword Group. Refer to: /api/docs/1.0/transcription_keyword_groups
schedule_action_group_id Optional Blank value allowed	Run this Schedule Action Group against the call after its transcript is ready. Must be a valid foreign key reference to an Schedule Action Group. Refer to: /api/docs/1.0/schedule_action_groups
record_token_filter_list Optional Blank value allowed	Assign filters to the object by passing an array of key:value pairs Must be a valid list of filters. Example filters: `"interest:auto", "loan_amount:>=10000", "loan_amount:<=50000", "geo:!=800", "caller_id:!=anonymous"`

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/transcription_flows/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "transcription_flow_group_id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
  "name": "Example Transcription Flow",
  "description": "Transcribes calls and flags compliance keywords.",
  "recording_types": [
    "call"
  ]
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "transcription_flow": {
    "id": "a09e6bca-255b-4217-af73-cb9601c80217",
    "type": "TranscriptionFlow",
    "uuid": "a09e6bca-255b-4217-af73-cb9601c80217",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/transcription_flows/a09e6bca-255b-4217-af73-cb9601c80217",
    "routes_edit_path": "/transcription_flows/a09e6bca-255b-4217-af73-cb9601c80217/edit",
    "external_record_id": null,
    "company_id": 10001,
    "transcription_flow_group_id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "sortable_order": -2,
    "name": "Example Transcription Flow",
    "recording_types": [
      "call"
    ],
    "description": "Transcribes calls and flags compliance keywords.",
    "transcription_keyword_group_id": null,
    "schedule_action_group_id": null,
    "redact_pii": null,
    "transcription_base_rate": "+$0.05/min",
    "record_token_filter_id": null,
    "record_token_filter_data_count": 0,
    "record_token_filter_data": []
  },
  "metadata": {
    "root": "transcription_flow"
  }
}