List active task tags for a flow execution

List all active tags for task executions within a flow execution.

Overview Retrieve tags associated with task executions in a specific flow execution. Results can be filtered to a single task or return all tasks' tags. Only active tags are returned; soft-deleted tags (status='deleted') are excluded.

What are Task Tags? Task tags provide flexible categorization and workflow state for task executions:

• Review status: 'reviewed', 'approved', 'rejected'
• Quality flags: 'quality_checked', 'flagged', 'verified'
• Custom categories: 'priority_high', 'customer_acme', 'requires_attention' Each tag includes optional metadata for context (reviewer name, notes, etc.)

Filtering Logic Query parameters combine with AND logic:

• flow_execution_id (required): Return tags for this flow execution
• task_name (optional): Filter to tags for a specific task Without task_name: Returns all tags across all tasks in the flow execution

Common Query Patterns

1. All tags in flow execution: GET /task-tags?flow_execution_id={id}

2. Tags for specific task: GET /task-tags?flow_execution_id={id}&task_name=send_email

3. Check if task reviewed: GET /task-tags?flow_execution_id={id}&task_name=extract_data Filter results where tag='reviewed'

Response Format Returns array of FlowTaskTagAPI objects with:

• Tag identification: tag, tag_type, task_name
• Metadata: tag_metadata (JSON object for custom data)
• Lifecycle: created_at, updated_at, modified_by
• Status: Always 'active' (deleted tags excluded)
• Organization context: organization_id for tenant isolation

Tag Types and Usage Common tag_type values:

• 'review_status': Workflow state ('reviewed', 'approved', 'rejected')
• 'quality': Quality assurance ('quality_checked', 'flagged')
• 'priority': Business priority ('high', 'medium', 'low')
• 'custom': Domain-specific categories

Performance Considerations

• Queries scoped by organization_id via RLS (automatic filtering)
• Indexes on (flow_execution_id, task_name, status) for fast lookups
• Typical response: 5-50 tags per flow execution
• Soft-deleted tags excluded at query time (no filtering overhead)

Use Cases

• Display task status in UI (show 'reviewed' badge)
• Filter tasks by approval state (find all 'approved' tasks)
• Audit workflow progression (who reviewed what, when)
• Custom business logic (trigger actions based on tag presence)

Error Scenarios

• 400 Bad Request: Invalid UUID format for flow_execution_id
• 403 Forbidden: User lacks permission to access flow execution's organization
• 404 Not Found: flow_execution_id doesn't exist Note: Missing task_name is NOT an error; returns empty array

Related Endpoints

• PATCH /task-tags - Add/remove tags
• GET /task-executions - List task executions (includes tags via TaskExecutionWithTagsAPI)
• GET /flow-executions/{id} - View parent flow execution