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 flows API

Flow management operations for defining and organizing workflows.Flows represent workflow definitions with tasks, dependencies, and execution logic. They serve as reusable templates that can be executed multiple times with different inputs.**What is a flow?**A flow consists of:- **Tasks**: Individual units of work that perform specific actions- **Dependencies**: Relationships between tasks that define execution order- **Configuration**: Settings and parameters that control flow behavior**Use these endpoints to:**- Create new flow definitions from scratch or import from YAML- List and search existing flows in your organization- Retrieve detailed flow information including task definitions- Update flow configurations and task parameters- Delete flows that are no longer neededFlows are the foundation of your workflow automation—once defined, they can be executed via the flow-executions endpoints.

Super.ai flows 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 Flows. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and authentication docs.

This API exposes 28 operations across 20 paths, and defines 33 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.

28 operations 20 paths 33 schemas 3 DELETE14 GET2 PATCH5 POST4 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 flows 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 28

Across 20 paths, the API surfaces 28 operations — 3 DELETE, 14 GET, 2 PATCH, 5 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

flows 28

Flow management operations for defining and organizing workflows. Flows represent workflow definitions with tasks, dependencies, and execution logic. They serve as reusable templa…

GET
/api/flows
List all flows
list_flows_api_flows_get 16 params → 200401500422
POST
/api/flows
Create a new flow
create_flow_api_flows_post 6 params body → 201400401409500422
GET
/api/flows/available-tags
Get available flow tags for autocomplete
get_flow_available_tags_api_flows_available_tags_get 1 param → 200401500422
GET
/api/flows/{flow_id}
Retrieve a flow by ID
get_flow_api_flows__flow_id__get 7 params → 200403401404422
DELETE
/api/flows/{flow_id}
Delete a flow
delete_flow_api_flows__flow_id__delete 1 param → 204403401404422
PATCH
/api/flows/{flow_id}
Partially update a flow
patch_flow_api_flows__flow_id__patch 7 params body → 200400401403404422
GET
/api/flows/{flow_id}/clone-info
Get clone info for a flow
get_flow_clone_info_api_flows__flow_id__clone_info_get 1 param → 200401404422
GET
/api/flows/{flow_id}/versions
List all versions of a flow
list_flow_versions_api_flows__flow_id__versions_get 7 params → 200403401404422
PUT
/api/flows/{flow_id}/definition
Update flow definition
update_flow_definition_api_flows__flow_id__definition_put 7 params body → 200400403401404422
POST
/api/flows/{flow_id}/validate
Validate a flow definition without persisting
validate_flow_definition_api_flows__flow_id__validate_post 4 params body → 200401404422
GET
/api/flows/{flow_id}/versions/summary
List version summaries for a flow
get_flow_version_summaries_api_flows__flow_id__versions_summary_get 5 params → 200401404422
PATCH
/api/flows/{flow_id}/versions/{version}
Update version metadata
update_flow_version_metadata_api_flows__flow_id__versions__version__patch 2 params body → 200401404422
GET
/api/flows/{flow_id}/versions/{version}
Get specific flow version
get_flow_version_api_flows__flow_id__versions__version__get 8 params → 200401403404422
POST
/api/flows/{flow_id}/versions/{version}/restore
Restore a past version
restore_flow_version_api_flows__flow_id__versions__version__restore_post 8 params → 200400401404422
PUT
/api/flows/{flow_id}/task
Update a single task in flow
update_flow_task_api_flows__flow_id__task_put 7 params body → 200400401403404422
POST
/api/flows/{flow_id}/upload-url
Generate file upload URL
generate_upload_url_api_flows__flow_id__upload_url_post 2 params → 200401404500422
GET
/api/flows/{flow_id}/files
List flow files
list_flow_files_api_flows__flow_id__files_get 1 param → 200401404500422
GET
/api/flows/{flow_id}/versions/{version}/summary
List task summaries for flow version
list_flow_summaries_api_flows__flow_id__versions__version__summary_get 2 params → 200401404500422
GET
/api/flows/{flow_id}/tags
Get tags for flow executions
get_flow_tags_api_flows__flow_id__tags_get 2 params → 200403401404500422
GET
/api/flows/{flow_id}/metadata/keys
Get distinct metadata keys for a flow
get_flow_metadata_keys_api_flows__flow_id__metadata_keys_get 5 params → 200403401404500422
GET
/api/flows/{flow_id}/metadata/values
Get distinct values for a metadata key
get_flow_metadata_values_api_flows__flow_id__metadata_values_get 6 params → 200403401404500422
POST
/api/flows/download-url
Generate file download URL
generate_download_url_api_flows_download_url_post body → 200400401403404500422
PUT
/api/flows/{flow_id}/invitations
Upsert user invitations to a flow
upsert_flow_invitations_api_flows__flow_id__invitations_put 1 param body → 200400403401404422
GET
/api/flows/{flow_id}/invitations
List flow invitations
list_flow_invitations_api_flows__flow_id__invitations_get 1 param → 200403401404422
DELETE
/api/flows/{flow_id}/invitations
Remove user invitations from a flow
delete_flow_invitations_api_flows__flow_id__invitations_delete 1 param body → 204400403401404422
PUT
/api/flows/{flow_id}/team-invitations
Upsert team (worker group) invitations to a flow
upsert_flow_team_invitations_api_flows__flow_id__team_invitations_put 1 param body → 200400403401404422
GET
/api/flows/{flow_id}/team-invitations
List team invitations for a flow
list_flow_team_invitations_api_flows__flow_id__team_invitations_get 1 param → 200403401404422
DELETE
/api/flows/{flow_id}/team-invitations
Remove team invitations from a flow
delete_flow_team_invitations_api_flows__flow_id__team_invitations_delete 1 param body → 204400403401404422

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are FlowResponse (18 properties), TaskSummaryResponse (12 properties), FlowInvitationResponse (9 properties), FlowVersionSummary (7 properties). Each schema is shown below with its type and property counts.

PaginatedFlowVersionSummaryResponse
object
4 properties 4 required
FlowInvitationRequest
object
Request model for creating flow invitations.
1 property 1 required
FlowDefinitionUpdate
object
Model for flow definition update request.
1 property 1 required
FlowResponse
object
Response model for a flow object. Represents a complete flow definition with metadata, execution statistics, and optional computed fields. Use query parameters…
18 properties 10 required
FlowInvitationBulkResponse
object
Response model for bulk invitation creation/update.
5 properties 4 required
FlowTeamInvitationBulkResponse
object
Response model for bulk team invitation creation/update.
5 properties 4 required
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…
TaskOutputEditedStatus
string
Aggregated edited status for a task output. Values: - notedited: All task executions have notedited status - edited: At least one task execution has editednotr…
PatchFlowRequest
object
Request body for partially updating a flow. All fields are optional - only provided fields will be updated.
6 properties
UserRole
string
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
TaskSummaryResponse
object
Summary of a task execution within a flow execution. Represents aggregated task information with status and metadata. Used for displaying task-level details in…
12 properties 10 required
FlowSettings
object
Flow-level settings configuration.
3 properties
ValidationError
object
3 properties 3 required
GeneratePresignedUrlForDownload
object
Model for generating a pre-signed URL for downloading a file.
1 property 1 required
FlowCreateRequest
object
Request body for creating a new flow. Flows represent workflow definitions with tasks, dependencies, and execution logic. Upon creation, flows are assigned ver…
6 properties 2 required
OrderDirection
string
Enum for sort direction.
UpdateFlowVersionMetadata
object
2 properties
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
MetadataValueResponse
object
Response model for metadata value discovery.
2 properties 2 required
MetadataKeyResponse
object
Response model for metadata key discovery.
2 properties 2 required
MetadataOrderBy
string
Enum for metadata ordering options.
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…
HTTPValidationError
object
1 property
PaginatedFlowResponse
object
Paginated response for flows list.
4 properties 4 required
FlowCloneInfoResponse
object
Response indicating whether a flow has external input tasks that need attention when cloning.
2 properties 1 required
FlowTeamInvitationResponse
object
Response model for a single flow team invitation.
7 properties 7 required
FlowInvitationResponse
object
Response model for a flow invitation.
9 properties 9 required
TTLSettings
object
TTL configuration for flow executions.
1 property
FlowTeamInvitationRequest
object
Request model for creating flow team invitations.
1 property 1 required
FlowValidationResponse
object
Response model for validate-only endpoint (no persistence).
5 properties 1 required
ErrorDetails
object
6 properties 4 required
FlowVersionSummary
object
Lightweight version metadata for the version history sidebar.
7 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

superai-flows-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 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
Super.ai task-data API
Where this information came from

This is an independent, third-party profile of Super.ai flows 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.