---
title: "Run an Adapter Flow"
method: POST
path: "/adapters/installs/{installId}/flows/{flowName}"
tags: ["Adapters"]
---

# Run an Adapter Flow

`POST /adapters/installs/{installId}/flows/{flowName}`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/adapters/installs/{installId}/flows/{flowName}`
- Auth: API key in header `Authorization` and OAuth 2
  - Authorization code: `https://ironcladapp.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://ironcladapp.com/oauth/token` scopes: `public.adapters.triggerFlow`

Runs an adapter flow that has been configured to trigger on-demand via the API. The request body is passed through unchanged as the flow's input.

`installId` and `flowName` must each be 1-255 characters long.

**OAuth Scope required:** `public.adapters.triggerFlow`

## Path parameters

- `installId` string, required
- `flowName` string, required

## Response `200`

200

- AdapterFlowRunResult
  - `state` 'queued' | 'running' | 'succeeded' | 'failed' | 'partial', required: The overall status of the flow run.
  - `output` object, required: The flow's final output. Shape depends on how the flow is authored.
  - `nodeStates` object, required: Per-step results, keyed by the flow definition's authored step id (not `stepName` — the same step can be referenced by more than one node).
  - `failedNodeId` string: The authored step id of the node that failed, if any. A key into `nodeStates`.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404
- `409`: 409
- `422`: 422

## Changes

- **2026-11-03** `435da5a4396e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/changes/adapters/installs/:installId/flows/:flowName/post.md)

---

[API](https://skmtc.dev/ironcladapp/apis/ironclad-public-api.md) - [All operations](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/revisions/435da5a4396e?raw)