How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Super.ai task-executions API

Task execution operations for tracking individual task runs within flow executions.Task executions represent individual task runs within a flow execution. Each task in a flow execution has its own task execution record that tracks its lifecycle, inputs, outputs, and status.**What is tracked:**- **Status**: Current state (pending, running, completed, failed, skipped)- **Input/Output**: Data passed to and produced by the task- **Timing**: Start time, end time, and duration- **Errors**: Failure details and error messages- **Tags**: Metadata and categorization**Use these endpoints to:**- Query task execution status for debugging- Retrieve task outputs for analysis- Debug task failures with detailed error information- Track task performance and timing- Monitor task execution progress within flowsTask executions provide granular visibility into workflow execution, essential for debugging and optimization.

Super.ai task-executions API is one of 19 APIs that Super.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Task Executions. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and authentication docs.

This API exposes 4 operations across 2 paths, and defines 12 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://flows.super.ai/api.

4 operations 2 paths 12 schemas 2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://flows.super.ai/api
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Super.ai task-executions API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). An API key is passed in the header as X-API-Key (APIKeyAuth).

  • BearerAuth — JWT Bearer token authentication. Include your access token in the Authorization header as: Bearer YOURACCESSTOKEN Example: Authorization: Bearer eyJhbGciOiJIUz…
  • APIKeyAuth — API key authentication. Include your API key in the X-API-Key header as: X-API-Key YOURAPIKEY Example: X-API-Key: saf1234567890

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

task-executions 4

Task execution operations for tracking individual task runs within flow executions. Task executions represent individual task runs within a flow execution. Each task in a flow exe…

POST
/api/task-executions
Create a task execution record
create_task_execution_api_task_executions_post body → 201400404500422
PUT
/api/task-executions
Update task execution and optionally re-execute flow
update_task_execution_api_task_executions_put 1 param body → 200400404500422
GET
/api/task-executions
List task executions with filtering
list_task_executions_api_task_executions_get 4 params → 200500422
GET
/api/task-executions/{task_execution_id}
Retrieve a specific task execution
get_task_execution_api_task_executions__task_execution_id__get 2 params → 200403404422

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are TaskExecutionWithTagsAPI (19 properties), TaskExecutionAPI (18 properties), CreateTaskExecutionRequest (11 properties), FlowTaskTagAPI (11 properties). Each schema is shown below with its type and property counts.

StaleStatus
string
Tracks whether task data is consistent with upstream changes. Orthogonal to editedstatus — a task can be both "edited" and "stale". Values: - consistent: Data…
ListTaskExecutionsResponse
object
Response model for listing task executions with filtering. Returns an array of task executions with their associated tags, filtered by the query parameters pro…
1 property 1 required
TaskExecutionWithTagsAPI
object
API model for TaskExecution including associated tags. Extended version of TaskExecutionAPI that includes tags for categorization and workflow state tracking.…
19 properties 8 required
FlowTaskTagAPI
object
API model representing a task execution tag. Task tags provide flexible categorization and workflow state tracking for task executions. Tags enable custom work…
11 properties 6 required
CreateTaskExecutionRequest
object
Request model for creating or updating a task execution. This model is used by system workers to report task execution state. Fields are intentionally simplifi…
11 properties 4 required
ErrorResponse
object
Standard API error response structure. All error responses from the API follow this format, ensuring consistent error handling for API consumers. Example: { "e…
2 properties 1 required
ProcessingStatus
string
Valid status values for task processing lifecycle. Used by taskexecution and taskoutput tables to track where a task is in its processing pipeline, independent…
ValidationError
object
3 properties 3 required
TaskExecutionEditedStatus
string
Tracks whether a task execution was manually edited via API. Values: - notedited: Data was not updated via API (result is from Flow Execution Engine) - editedn…
HTTPValidationError
object
1 property
TaskExecutionAPI
object
API model representing a task execution within a flow. Task executions track individual task invocations during flow execution. Each task can execute multiple…
18 properties 8 required
ErrorDetail
object
Standard error detail structure. This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

superai-task-executions-api-openapi.yml Raw ↑

Other APIs Super.ai publishes across the network.

Super.ai auth API
Super.ai files API
Super.ai flow-executions API
Super.ai flows API
Super.ai human-review-tasks API
Super.ai integrations API
Super.ai models API
Super.ai organizations API
Super.ai plugins API
Super.ai profile API
Super.ai service-accounts API
Super.ai sso API
Where this information came from

This is an independent, third-party profile of Super.ai task-executions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.