> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggle Workflow

> Turn a Workflow on or off

Flips `is_active`. Turning a Workflow on runs an immediate pass that seeds
membership without firing — the same behavior as creating it active for the
first time, so turning on a Workflow over an existing view never floods you with
notifications for records that were already there.

## Path Parameters

<ParamField path="id" type="string" required>
  The Workflow's id.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.clustr-ai.com/api/public/workflows/7f1e2a33-.../toggle" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "workflow": { "id": "7f1e2a33-...", "is_active": false },
      "message": "Workflow toggled successfully"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "workflow not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>
