---
title: "List a workspace's campaigns"
method: GET
path: "/workspaces/{workspaceId}/campaigns"
tags: ["Campaigns"]
---

# List a workspace's campaigns

`GET /workspaces/{workspaceId}/campaigns`

A campaign is a first-class `campaigns` row (org-global,
workspace-homed) whose queue is the set of sequences stamped with
its id — one sequence per person. Campaigns are homed on a
workspace, so the workspace is the primary list scope. Returns the
canonical list envelope with `nextCursor: null` (one page, newest
first).

## Response `200`

The workspace's campaigns as summaries in the list envelope.

- object — The canonical v2 list envelope. Every list endpoint returns this shape; per-endpoint `items` element types (and documented extras like `total`) are declared on each operation.
  - `object` 'list', required
  - `items` CampaignSummary[], required — The page of objects. Element type is per-endpoint.
    - `object` 'campaign', required
    - `id` string, uuid, nullable, required
    - `slug` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'active' | 'paused', required
    - `peopleCount` integer, required — Live enrolled sequences (people) — non-deleted, non-cancelled.
  - `nextCursor` string, nullable, required — Cursor for the next page; `null` means this is the last page.
  - `url` string, required — The path this list was fetched from (query string excluded).

## Other responses

- `404` — WORKSPACE_NOT_FOUND.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/revisions/8083ad7fe081/schema)