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

# Unpublish a workflow

> Stop a workflow from starting new runs.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

Stop the workflow from starting new runs. Its steps stay as they are, and you can [publish](https://docs.nedzo.ai/api-reference/workflows/publish.md) again later.

## Path Parameters

**id** `string` *required*

The workflow's id.

```bash cURL theme={null}
curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/unpublish" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

It answers with the workflow, the same as [Get a workflow](https://docs.nedzo.ai/api-reference/workflows/get.md).

```json Response theme={null}
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "name": "Welcome text",
  "isPublished": false,
  "isActive": true,
  "version": 2,
  "publishedAt": "2026-10-11T09:00:00Z",
  "createdAt": "2026-10-01T09:00:00Z",
  "updatedAt": "2026-10-12T09:00:00Z",
  "nodes": [
    { "id": "start", "type": "contactCreated", "parentId": null, "pathId": null, "config": {}, "position": { "x": 0, "y": 0 } },
    { "id": "text", "type": "sendSms", "parentId": "start", "pathId": null, "config": { "phoneNumberId": "323e4567-e89b-12d3-a456-426614174000", "message": "Hi {{firstName}}!" }, "position": { "x": 0, "y": 120 } }
  ]
}
```

## Errors

| Status | When |
| - | - |
| `400` | The workflow id is not a valid UUID. |
| `402` | The account has no plan, or its subscription is not active. |
| `403` | Your plan is not VIP. |
| `404` | No workflow has this id, or it is not in this key's scope. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.