---
title: "Suspends all flows in the specified workspace"
method: POST
path: "/workspaces/{workspace_id}/flows/suspend"
tags: ["workspaces"]
---

# Suspends all flows in the specified workspace

`POST /workspaces/{workspace_id}/flows/suspend`

Suspends all active flows (excluding debug and retry flows) in the specified workspace.
You need to have the `workspaces.workspace.suspend_flows` permission to access this resource.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `reason` string

## Response `202`

Accepted

- object
  - `suspended` integer, required — Number of flows successfully suspended
  - `errors` object[] — List of errors that occurred during suspension (if any)
    - `flowId` string
    - `error` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)