List Operations

List the operations you started, newest first.

GET /api/v1/operations

cURL

curl "https://api.wordsmith.ai/api/v1/operations?status=running&limit=20" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "3b8e0f1c-6a2d-4e57-9c1b-2f7d8a4e6b90",
      "type": "question",
      "status": "running",
      "progress": null,
      "resource": { "type": "question", "id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58" },
      "result": null,
      "error": null,
      "poll_after_seconds": 5,
      "created_at": "2026-10-14T09:00:00Z",
      "updated_at": "2026-10-14T09:00:01Z",
      "completed_at": null
    }
  ],
  "cursor": null
}

Preview. This endpoint is available to organisations in the Wordsmith MCP and files pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Lists the operations you started through the API or the MCP server, newest first. Filters apply after the read, so a page can come back short, or even empty, with a cursor to the rest: keep following cursor until it is null.

Every endpoint that starts long-running work, such as Create Question, Create Review or Run Report, creates an operation. Get Operation lists every type, the resource it points at and its scopes.

Authentication

Send an API key, or an OAuth access token, as a bearer token in the Authorization header. The list leaves out operations whose type’s read scope the token lacks, so a token without sessions:read sees no questions, and one without reviews:read sees no reviews.

Query parameters

status · string

Only operations in this state: queued, running, succeeded, failed or cancelled.

type · string

Only operations of this type, such as question, review or report_run.

resource_type · string

Only operations on this kind of resource, such as question, review or report.

resource_id · string

Only operations on this resource. Combine it with resource_type.

cursor · string

Pagination cursor from a previous response.

limit · integer · default: "50"

Page size, from 1 to 100.

Response

Returns 200 with {"items": [...], "cursor": "..."}. cursor is null on the last page.

cURL

curl "https://api.wordsmith.ai/api/v1/operations?status=running&limit=20" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "3b8e0f1c-6a2d-4e57-9c1b-2f7d8a4e6b90",
      "type": "question",
      "status": "running",
      "progress": null,
      "resource": { "type": "question", "id": "5f0c9a12-8e3b-4d71-a6c4-0b2e9f7d3c58" },
      "result": null,
      "error": null,
      "poll_after_seconds": 5,
      "created_at": "2026-10-14T09:00:00Z",
      "updated_at": "2026-10-14T09:00:01Z",
      "completed_at": null
    }
  ],
  "cursor": null
}

Errors

Status	error_code	When
400	bad_request	A filter value is not recognised, limit is outside 1–100, or cursor is not one this endpoint returned.