## Base URL

```
https://flows.super.ai
```

| Surface        | Path prefix          | Purpose                                           |
|----------------|----------------------|---------------------------------------------------|
| Main API       | `/api/*`             | Flows, executions, tasks, integrations, files, auth |
| Agent API      | `/api/agent/*`      | AI agent and conversation endpoints                 |

## Conventions

The API follows Stripe-inspired design principles:

- **RESTful endpoints** with intuitive, resource-oriented paths
- **Standard HTTP methods** — `GET`, `POST`, `PATCH`, `DELETE`
- **Standard HTTP status codes** for success and error handling
- **Consistent JSON** request and response bodies
- **`request_id` on every response** for log correlation and support

## Authentication

Most endpoints require a JWT bearer token; some accept a service-account API key. See [Authentication](https://docs.flows.super.ai/api-reference/authentication) for the full flow.

```
curl https://flows.super.ai/api/flows \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## Resource groups

The endpoint reference in this section is generated directly from the OpenAPI specification and grouped by resource:

## Flows

Create, list, and manage workflow definitions.

## Flow Executions

Run flows and monitor execution status.

## Task Executions & Outputs

Inspect individual task runs and their results.

## Integrations & Plugins

Connect flows to external services and platforms.

## Files

Download files referenced in task outputs.

## Service Accounts

Manage programmatic API access credentials.

## Versioning & compatibility

The API follows a strict compatibility policy. Non-breaking changes (new endpoints, optional parameters, new response fields, new enum values) ship without notice — design your clients to ignore unknown fields. Breaking changes are announced at least **15 days in advance** with migration guides.

## Errors

All errors share a consistent JSON shape with a machine-readable `code` and a `request_id`. See the [Error Codes reference](https://docs.flows.super.ai/api-reference/errors).

```
{
  "error": {
    "message": "Human-readable error description",
    "code": "machine_readable_error_code"
  },
  "request_id": "01K8KACP7D2XFGHJ9KLM4NPQR8"
}
```