---
title: "change the status of a flow"
method: PATCH
path: "/v1/flows/{flow-id}"
tags: ["flows"]
---

# change the status of a flow

`PATCH /v1/flows/{flow-id}`

## Request body

- PatchStatus — encodes the intended status to switch to
  - `status` 'running' | 'paused', required — Valid statusses flows and connectors can be switched to

## Response `200`

The new status of the flow after applying the patch

- Flow — Information on a deployed flow
  - `alias` string, required — Alias of the flow
  - `status` 'initializing' | 'running' | 'paused' | 'draining' | 'stopped' | 'failed', required — runtime status of a flow or connector instance
  - `connectors` string[], required — aliases of connectors in the flow

## Other responses

- `400` — Error during patch operation, due to invalid status transition.
- `404` — The flow 'flow-id' wasnt found. It is thus not deployed in the runtime.

---

[API](https://skmtc.net/tremor-rs/apis/tremor-api.md) · [All operations](https://skmtc.net/tremor-rs/apis/tremor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tremor-rs/tremor-api/versions/b73c19450409/schema)