---
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`

## 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

---

[API](https://skmtc.net/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.net/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/versions/7f577998739b/schema)