Skip to main content
GET
Get tag usage for a flow

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Include your access token in the Authorization header as: Bearer YOUR_ACCESS_TOKEN

Example:

Path Parameters

flow_id
string<uuid>
required

Response

Tag usage successfully retrieved

execution_count
integer
required

Number of distinct non-deleted flow executions carrying this tag on any task. Zero for a tag that was removed from every execution but is still offered as a suggestion. Less than or equal to the sum of task_breakdown execution_count values, because one execution tagged on two tasks counts once here and once per task in the breakdown.

Required range: x >= 0
Example:

57

first_applied_at
string<date-time>
required

MIN(created_at) across active flow_task_tag rows for this tag in this flow (across removed rows when execution_count is zero) -- the date the tag was first applied in this flow. Surfaced in the UI as 'Created at'. There is no created-by equivalent: flow_task_tag only carries modified_by, which is overwritten on every update.

Example:

"2026-04-02T09:14:33.120000Z"

tag
string
required

Exact tag string. Case-sensitive: 'Reviewed' and 'reviewed' are separate rows.

Example:

"Reviewed"

task_count
integer
required

Number of distinct task names carrying this tag. Renders as '3 tasks'.

Required range: x >= 0
Example:

3

task_breakdown
TagTaskBreakdown · object[]

Per-task usage, ordered by execution_count descending then task_name ascending.