---
title: "Add an action to a flow"
method: POST
path: "/flows/{flowId}/actions"
tags: ["Flows", "Flow Actions"]
---

# Add an action to a flow

`POST /flows/{flowId}/actions`

Append a single action to a flow at the given `position`, optionally nesting it under a `parentFlowActionId` or supplying its own `children`. Supports a `nameOverride`, param `overrides`, and `continueOnError`. Returns 404 if the flow does not exist.

## Path parameters

- `flowId` string, uuid, required

## Request body

- AddFlowActionBody
  - `actionId` string, uuid, required
  - `position` integer, required
  - `continueOnError` boolean
  - `nameOverride` string
  - `overrides` FlowActionOverrides, nullable
    - `params` object
  - `parentFlowActionId` string, uuid, nullable
  - `children` FlowChildActionInput[]
    - `actionId` string, uuid, required
    - `position` integer, required
    - `continueOnError` boolean
    - `nameOverride` string
    - `overrides` FlowActionOverrides, nullable
      - `params` object

## Response `201`

Flow action added

- object
  - `data` FlowAction, required
    - `id` string, uuid, required
    - `flowId` string, uuid, required
    - `actionId` string, uuid, required
    - `parentFlowActionId` string, uuid, nullable, required
    - `position` integer, required
    - `continueOnError` boolean, required
    - `nameOverride` string, nullable, required
    - `overrides` object, nullable, required
      - `params` object
    - `createdAt` string, nullable, required

## Other responses

- `404` — Not Found

## Changes

- **2026-06-29** `8f06726ac240` — 5 breaking
  - the request property `children/items/overrides` became not nullable
  - the request property `children/items/overrides/params/additionalProperties/` became not nullable
  - the request property `overrides` became not nullable
  - the request property `overrides/params/additionalProperties/` became not nullable
  - …1 more
- **2026-06-28** `fd8fb6b29e38` — 1 info
  - endpoint added
- **2026-06-27** `99b4ade46263` — 1 breaking
  - api path removed without deprecation
- **2026-06-19** `7f577998739b` — 1 info
  - endpoint added
- **2026-06-19** `ec76cd771e68` — 1 breaking
  - api path removed without deprecation

[Full history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/flows/:flowId/actions/post.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/3183ec3153d1/schema)