---
title: "Start a flow"
method: POST
path: "/flows/{id}/start"
tags: ["flows"]
---

# Start a flow

`POST /flows/{id}/start`

Initiates the flow's integration process by publishing an appropriate event to the event bus-

## Path parameters

- `id` string, string, required

## Response `200`

Returns the id and new status of the flow

- object
  - `data` object
    - `id` string
    - `status` string
  - `meta` object

## Other responses

- `400` — Invalid ID format.
- `403` — User is not authorised to start flows.
- `404` — No Flow with this id was found.

## Changes

- **2019-03-26** `a65fada07ca8` — 2 warning, 2 info
  - removed the optional property `header` from the response with the `200` status
  - removed the optional property `payload` from the response with the `200` status
  - added the optional property `data` to the response with the `200` status
  - added the optional property `meta` to the response with the `200` status

[Change history](https://skmtc.dev/openintegrationhub/apis/flow-repository/changes/flows/:id/start/post.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/flow-repository.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/flow-repository/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/flow-repository/revisions/db102ef341f4/schema)