---
title: "Run a flow"
method: POST
path: "/flows/{id}/run"
tags: ["Flow"]
---

# Run a flow

`POST /flows/{id}/run`

## Request

- Base URL: `https://api.recordedfuture.com/fusion/v3`
- URL: `https://api.recordedfuture.com/fusion/v3/flows/{id}/run`
- Auth: one of:
  - API key in header `X-RFToken`
  - OAuth 2
    - Authorization code: `https://id.recordedfuture.com/authorize`
    - Token URL: `https://id.recordedfuture.com/token`

Runs a flow on demand without waiting for its schedule.

## Path parameters

- `id` string, required

## Request body

- FlowRunRequest
  - `block` string: Specifies the block from which the flow should be executed. In practice, this means that only the blocks that are directly or indirectly connected to the inputs of this block will be executed. By default this is the first FileApiSinkBlock in the list of blocks.
  - `samples` integer: Specifies the number of samples to include in the execution state. The samples are helpful when debugging a flow.

## Response `200`

Flow job

- FlowJob
  - `job_id` string: Id of flow job

---

[API](https://skmtc.dev/recordedfuture/apis/fusion-api.md) - [All operations](https://skmtc.dev/recordedfuture/apis/fusion-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/fusion-api/revisions/15e440739cf0?raw)