---
title: "Start flow run"
method: POST
path: "/flow-runs"
tags: ["Workflow Flows"]
---

# Start flow run

`POST /flow-runs`

## Request

- Base URL: `https://api.render.com/v1`
- URL: `https://api.render.com/v1/flow-runs`
- Auth: HTTP bearer

Starts a run of the workflow flow with the provided slug, passing the provided input data.

## Request body

- object
  - `flow` string, required: A flow slug in the format workflow-slug/flow-name. An optional version can be appended (workflow-slug/flow-name:version). If no version is provided, the latest version is used. Cannot be blank.
  - `input` union, required: Input data for a flow. Can be either an array (for positional arguments) or an object (for named parameters).
    - unknown[]: Positional arguments passed to the flow function
      - unknown
    - object: Named parameters passed to the flow function as keyword arguments
  - `idempotencyKey` IdempotencyKey (unresolved $ref)

## Response `202`

Flow run started

- object
  - `id` string, required
  - `flowId` string, required
  - `status` Items, required (unresolved $ref)
  - `startedAt` string, date-time
  - `completedAt` string, date-time

## Other responses

- `400`: The request could not be understood by the server.
- `401`: Authorization information is missing or invalid.
- `403`: You do not have permissions for the requested resource. If a scoped API token does not satisfy the endpoint's minimum scope requirements, the response has code insufficient_token_scope and its message lists all minimum required scopes. Broader scopes that include their permissions also satisfy the requirements. Passing this check does not guarantee access to the requested resource or to conditional operations.
- `404`: Unable to find the requested resource.
- `429`: Rate limit has been surpassed. Rate-limited endpoints also return `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` on successful responses so clients can track their remaining quota.
- `500`: An unexpected server error has occurred.
- `503`: Server currently unavailable.

## Changes

- **2026-11-03** `6ac5d3d47362`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/render/apis/render-public-api/changes/flow-runs/post.md)

---

[API](https://skmtc.dev/render/apis/render-public-api.md) - [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/render/apis/render-public-api/revisions/6ac5d3d47362?raw)