---
title: "Execute a flow with input data"
method: POST
path: "/v1/multipass/flows/{flowId}/execute"
tags: ["Multipass API"]
---

# Execute a flow with input data

`POST /v1/multipass/flows/{flowId}/execute`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/multipass/flows/{flowId}/execute`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Executes the specified Multipass flow with the provided input data.
Returns the processed results based on the flow's configuration.

## Path parameters

- `flowId` string, required

## Headers

- `X-Request-Id` string

## Request body

- FlowExecutionRequest: Request object for flow execution containing optional metadata and input data.
  - `metadata` object[], nullable: Optional metadata for the flow execution
  - `input` array[], required: Array of input JSON data objects to be processed by the flow
    - JsonNode[]
      - `empty` boolean
      - `valueNode` boolean
      - `containerNode` boolean
      - `missingNode` boolean
      - `array` boolean
      - `object` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `pojo` boolean
      - `number` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `float` boolean
      - `double` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `boolean` boolean
      - `null` boolean
      - `binary` boolean
      - `_this` object[]

## Response `200`

Flow executed successfully

- FlowExecutionApiResponseFlowBatchExecutionResults: Represents a successful response containing a list of execution results
  - `results` array[], required
    - JsonNode[]
      - `empty` boolean
      - `valueNode` boolean
      - `containerNode` boolean
      - `missingNode` boolean
      - `array` boolean
      - `object` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `pojo` boolean
      - `number` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `float` boolean
      - `double` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `boolean` boolean
      - `null` boolean
      - `binary` boolean
      - `_this` object[]

## Other responses

- `206`: Partial Content
- `400`: Invalid request - check flow definition format or input data
- `401`: Unauthorized: Invalid or missing authentication token
- `403`: Forbidden: Insufficient permissions to access this flow
- `429`: Rate limit exceeded - too many requests
- `500`: Internal server error occurred
- `503`: Service temporarily unavailable

---

[API](https://skmtc.dev/precisely/apis/multipass-flow-management-api.md) · [All operations](https://skmtc.dev/precisely/apis/multipass-flow-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/multipass-flow-management-api/revisions/40c73192cfac?raw)