---
title: "Export Workflows"
method: POST
path: "/v2/exports/workflows"
---

# Export Workflows

`POST /v2/exports/workflows`

## Request

- Base URL: `https://pub-api.conversion.ai/api`
- URL: `https://pub-api.conversion.ai/api/v2/exports/workflows`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Export of every workflow. Deleted workflows are not returned. Follow `pagination.nextCursor` until it is `null` to read the full set.

> **Request access.** This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return `403 export_not_enabled`.

## Request body

- object
  - `statuses` string[]: Only workflows in these statuses.
  - `cursor` string: The opaque cursor returned as `pagination.nextCursor` by a previous call. Omit it on the first page. Send it without filters, because the cursor carries them; sending both returns `invalid_filter`.
  - `limit` integer: The maximum number of rows per page. Defaults to 50. Values are clamped to [1, 100].

## Response `200`

A page of workflows retrieved successfully.

- object
  - `data` object
    - `workflows` object[], required: The current page of workflows.
      - `id` string, uuid, required: The workflow ID. Workflow events reference it as `workflowId`.
      - `name` string, required: The workflow's name.
      - `status` 'ACTIVE' | 'ACTIVATING' | 'PAUSED', required: The workflow's status.
      - `createdAt` string, date-time, required: When the workflow was created.
      - `updatedAt` string, date-time, required: When the workflow was last updated.
      - `activatedAt` string, date-time, nullable: When the workflow was last activated.
  - `pagination` object
    - `nextCursor` string, nullable, required: Opaque cursor for the next page, or `null` when there are no more results. A page can be short or empty while the cursor is non-null.

## Other responses

- `400`: The request was malformed or contained invalid data.
- `401`: Authentication failed.
- `403`: The export API is not enabled for this account.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/conversion/apis/conversion-api.md) - [All operations](https://skmtc.dev/conversion/apis/conversion-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conversion/apis/conversion-api/revisions/8422f815402a?raw)