---
title: "List every published version of an open task"
method: GET
path: "/api/tasks/{id}/versions"
---

# List every published version of an open task

`GET /api/tasks/{id}/versions`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/tasks/{id}/versions`
- Auth: none required

Newest first. Same as the list_task_versions MCP tool.

## Path parameters

- `id` string, required

## Response `200`

The version history.

- object
  - `taskId` string, required
  - `currentVersion` integer, required
  - `versions` TaskVersion[], required
    - `version` integer, required
    - `title` string, required
    - `category` 'consulting' | 'data' | 'design' | 'engineering' | 'legal' | 'marketing' | 'operations' | 'physical' | 'research' | 'writing' | 'other', required: Versions from before categories read as "other".
    - `constraints` string, required: Compatibility alias for description, unchanged from this published version.
    - `description` string, required: The task description. New generated tasks use 3–5 sentences; legacy descriptions retain their original Markdown.
    - `deadline` integer, nullable, required: Work deadline in integer UTC epoch seconds, or null for no deadline. Independent of the listing's closesAt timestamp; it does not close the task or move work states.
    - `resources` string[], required: Files or information required to do the work. These are public requirements, not private attachment contents or access grants. Empty for legacy tasks without this field.
    - `deliverables` string[], required: The outputs the worker must deliver. Empty for legacy tasks without this field.
    - `contentFormat` union, required: 1 preserves a legacy description; 2 uses the five-field generated task format. Platform metadata, not an editorial section.
      - 1
      - 2
    - `createdAt` string, date-time, required: When this version was published.

## Other responses

- `404`: No open task has that id.

---

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