---
title: "List Workflows"
method: GET
path: "/agents/workflows"
tags: ["agentWorkflows"]
---

# List Workflows

`GET /agents/workflows`

List agent workflow executions with optional filters and cursor-based pagination.

## Query parameters

- `status` 'running' | 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'terminated' — Filter by workflow status
- `agent_id` string, nullable
- `created_after` string, date-time, nullable
- `limit` integer
- `cursor` string, nullable

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- WorkflowListResponse — Paginated list of workflow executions.
  - `workflows` WorkflowStatusResponse[], required — Workflow executions
    - `workflow_id` string, required — Workflow ID
    - `agent_id` string — Agent that ran this workflow
    - `document_ref` string, nullable — Caller-provided document identifier.
    - `check_type` 'interactive' | 'automated' | 'batch' | 'baseline' — How a content check should be counted. The type fixes two things about a result: its priority (is someone waiting?) and its attribution (does it count as authoring activity for a person?). - INTERACTIVE: a writer checking content as they work — high priority, assigned. - AUTOMATED: a save/update check credited to the last editor — assigned. - BATCH: a bulk check of content you own — assigned to the content's author. - BASELINE: a check of content you do NOT own — a measurement, not authoring, so it is not assigned to anyone.
    - `assigned` boolean — Whether the check counts as authoring activity for an author.
    - `batch_id` string, nullable — Owning batch id (agbw_<nanoid>); null unless this is a batch check.
    - `status` 'running' | 'completed' | 'failed' | 'timed_out' | 'cancelled', required — Status of a workflow execution.
    - `result` object, nullable — Result (if completed)
    - `started_at` string, date-time, required — Start time
    - `completed_at` string, date-time, nullable — Workflow completion time
  - `pagination` PaginationInfo, required — Cursor-based pagination metadata.
    - `next_cursor` string, nullable — Opaque cursor for fetching the next page
    - `has_more` boolean, required — Whether more results are available

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `404` — Agent not found
- `422` — Validation Error
- `500` — Internal Server Error
- `502` — Failed to list workflows

---

[API](https://skmtc.dev/markup/apis/api-reference.md) · [All operations](https://skmtc.dev/markup/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/markup/api-reference/revisions/65e1214d0bbf/schema)