List task executions with filtering

List task executions with optional filtering by flow execution, task name, or execution index.

Overview Retrieve task executions across all flows in your organization. Results can be filtered by parent flow execution, specific task name, or execution index. Returns task executions with their associated tags for categorization and filtering.

Filtering Logic Multiple filters are combined with AND logic:

• flow_execution_id AND task_name → All executions of a specific task in a flow
• flow_execution_id AND task_execution_idx → All tasks at a specific execution index
• All three filters → Exact task execution lookup (equivalent to GET /{id})

Common Query Patterns

1. All tasks in a flow execution: ?flow_execution_id={id}
2. Specific task across retries: ?flow_execution_id={id}&task_name=send_email
3. First execution of all tasks: ?flow_execution_id={id}&task_execution_idx=0
4. All task executions (no filters): Returns all executions in organization

Response Format Returns TaskExecutionWithTagsAPI objects containing:

• Full task execution details (input, output, error, status)
• Associated tags (e.g., reviewed, approved, flagged)
• Metadata (created_at, updated_at, modified_by)
• Organization context for multi-tenant isolation

Performance Considerations

• Queries are scoped to organization_id via RLS policies (automatic filtering)
• Add flow_execution_id filter for better query performance on large datasets
• Unfiltered queries may return large result sets; pagination planned for future

Tags Task tags provide categorization and workflow state:

• Tag types: 'review_status', 'approval', 'quality', 'custom'
• Tags are returned with each task execution for filtering and display
• Soft-deleted tags are excluded from results

Related Endpoints

• GET /task-executions/{id} - Get single task execution by ID
• GET /task-tags - List all tags for a flow execution
• POST /task-executions - Create new task execution