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

# 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

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)