SuperAI Flow Platform

Sections

Theme switcher

List task summaries for flow version

List task execution summaries for a specific flow version.

Returns lightweight task summaries without full output data, reducing network overhead when you only need execution metadata.

Performance Benefits

  • Excludes potentially large task output fields
  • Significantly faster response times for flows with large outputs
  • Ideal for listing/summary views

Use Cases

  • Display execution history in a table/list
  • Check task statuses without downloading full outputs
  • Build dashboards showing execution statistics

Header Parameters

Authorizationstring

Path Parameters

flow_idstring Required
versioninteger Required

Response

200
Object
List of task summaries successfully retrieved

Response Attributes

created_atstring Required
flow_execution_idstring Required

UUID of the parent flow execution containing this task

flow_versionnull
Minimum
1
idstring Required
modified_bystring Required
statusstring Required

Current status of the task execution. Common values: 'running', 'completed', 'failed', 'skipped'

summarystring Required

Task execution summary data. Structure varies by task type. May contain results, metrics, or status information.

Show child attributes

tagsnull

Show child attributes

task_namestring Required

Name of the task as defined in the flow definition. Case-sensitive.

Min length
1
Max length
255
updated_atstring Required
401
Object
Unauthorized - Missing or invalid authentication credentials

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
404
Object
Not Found - The requested resource does not exist

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
422
Object
Validation Error

Response Attributes

detailarray

Show child attributes

500
Object
Internal Server Error - An unexpected error occurred

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
Was this section helpful?

What made this section unhelpful for you?

GET

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot