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

# List Workflows

> List the workflows configured in your workspace

List every workflow in your workspace, oldest first. A workflow is a routine that an agent can conduct on a lead. Workflows are configured in the Monumint app. This endpoint exists so an integration can look up the `workflowId` it needs to [start a workflow run](/api-reference/workflow-runs/create-workflow-run).

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="workflows" type="array">
  The workspace's workflows, oldest first.

  <Expandable title="workflow">
    <ResponseField name="id" type="string">
      The workflow id. Pass this as `workflowId` when starting a workflow run.
    </ResponseField>

    <ResponseField name="name" type="string">
      The workflow's name.
    </ResponseField>

    <ResponseField name="type" type="string">
      What the workflow does: `CHECKLIST` (collect the lead's checklist),
      `REMINDER` (send a recurring reminder), or `SUPPORT` (answer inbound
      questions).
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      When the workflow was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      When the workflow last changed.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: "GET",
    headers: { "x-api-key": "<your-api-key>" },
  };

  fetch("https://api-v2.getomni.ai/api/v1/workflows", options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/workflows"
  headers = {"x-api-key": "<your-api-key>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/workflows \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "workflows": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "Document collection",
        "type": "CHECKLIST",
        "createdAt": "2026-03-02T15:21:40.000Z",
        "updatedAt": "2026-06-11T11:45:02.000Z"
      }
    ]
  }
  ```
</ResponseExample>
