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

# Stop a flow

`POST /flows/{id}/stop`

Stops the flow's integration process by publishing an appropriate event to the event bus. Requires the 'flows.control' permission.

## Path parameters

- `id` string, string, required

## Response `200`

Returns id and new status of the stopped flow

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

## Other responses

- `400` — Invalid ID format.
- `403` — User is not authorised to stop flows.
- `404` — No Flow with this id was found.
- `409` — Flow is currently not active. Only active flows can be stopped.

---

[API](https://skmtc.net/openintegrationhub/apis/flow-repository.md) · [All operations](https://skmtc.net/openintegrationhub/apis/flow-repository/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openintegrationhub/flow-repository/versions/898fa794c6b8/schema)