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

# Workflow Management

> List workflows, poll status, resume paused workflows, and view published content.

For a conceptual overview of how workflows work, see [Core Concepts: Workflows](/concepts/workflows).

## platform\_list\_workflows

List recent workflows with status and progress.

### Parameters

| Name     | Type    | Required | Default | Description                                  |
| -------- | ------- | -------- | ------- | -------------------------------------------- |
| `status` | string  | No       | `""`    | Filter: `In Progress`, `Completed`, `Failed` |
| `limit`  | integer | No       | `20`    | Maximum workflows to return                  |

### Response

```json theme={null}
{
  "workflows": [
    {
      "_id": "wf_xyz789",
      "name": "Create Adaptive Prompt-Driven Post Draft",
      "status": "Completed",
      "progress": 100,
      "currentAction": "Done"
    }
  ],
  "count": 1
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    ```json theme={null}
    { "status": "In Progress", "limit": 5 }
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl "https://api.clickflow.com/v1/api/workflows?status=In%20Progress&limit=5" \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>

***

## workflows\_get\_status

Check a specific workflow's progress. Returns status, progress percentage, current action, and output (when completed).

### Parameters

| Name            | Type   | Required | Default  | Description                                                                                                                        |
| --------------- | ------ | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `workflow_id`   | string | Yes      | —        | The workflow ID                                                                                                                    |
| `output_format` | string | No       | `"html"` | `html` (default) or `markdown`. When `markdown`, completed workflow output includes a `markdown` field alongside `html`. MCP only. |

### Response

See [Workflows: Polling for status](/concepts/workflows#polling-for-status) for the full response shape including `In Progress`, `Completed`, `Failed`, and `Human Review` states.

When `output_format="markdown"`, the `output` object of a completed workflow includes an additional `markdown` field with the content converted to Markdown.

### Usage

<Tabs>
  <Tab title="MCP">
    ```json theme={null}
    { "workflow_id": "wf_xyz789", "output_format": "markdown" }
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/workflows/wf_xyz789/status \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```

    <Note>The `output_format` parameter is available via MCP only. REST API always returns HTML.</Note>
  </Tab>
</Tabs>

***

## workflows\_resume

Submit a review decision to resume a paused workflow. Only applicable when workflow status is `Human Review`.

### Parameters

| Name          | Type   | Required | Description                              |
| ------------- | ------ | -------- | ---------------------------------------- |
| `workflow_id` | string | Yes      | The workflow ID                          |
| `decision`    | object | Yes      | Decision payload — varies by review type |

See [Workflows: Decision payloads](/concepts/workflows#decision-payloads-by-review-type) for the decision format for each review type.

### Response

```json theme={null}
{
  "workflow_id": "wf_xyz789",
  "status": "resuming",
  "review_type": "implementation_spec_review",
  "message": "Decision submitted. Poll workflows_get_status for progress."
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    ```json theme={null}
    {
      "workflow_id": "wf_xyz789",
      "decision": {
        "approved": true,
        "selected_change_ids": [1, 3, 5]
      }
    }
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://api.clickflow.com/v1/api/workflows/wf_xyz789/resume \
      -H "Authorization: Bearer cf_ak_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{"decision": {"approved": true, "selected_change_ids": [1, 3, 5]}}'
    ```
  </Tab>
</Tabs>

***

## platform\_list\_published\_content

List all content pieces that have been published to a CMS.

### Parameters

None.

### Response

```json theme={null}
{
  "items": [
    {
      "url": "https://example.com/blog/seo-guide",
      "title": "Complete SEO Guide for 2026",
      "postId": "12345",
      "cmsType": "wordpress",
      "publishedAt": 1711324800000,
      "status": "published"
    }
  ],
  "count": 1
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    Call `platform_list_published_content` with no parameters.
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/published-content \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>