> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List revisions

> Returns the revisions you can see, newest first.

### Parameters

**subject** `string`

Only revisions that changed this resource, such as a worker ID.

**attribute** `string`

Only revisions that changed this field, by its key (`number`) or its
Attribute ID (`attr_…`).

**limit** `number`

The number of revisions to return. Defaults to 10; a value above 100 is
treated as 100.

**cursor** `string`

The `next_cursor` from the previous page. It carries this request's filters,
so send it alone, or with a new `limit`. See [pagination](https://docs.plane.com/reference/pagination.md).

### Returns

`data`, an array of [revisions](https://docs.plane.com/reference/revisions/object.md), and
`next_cursor`: pass it as `cursor` for the next page; it is null at the end.

```json Response theme={null}
{
  "data": [
    {
      "id": "rv_8Hd2K",
      "object": "revision",
      "workspace": "wsp_456def",
      "status": "applied",
      "cancelled_reason": null,
      "reason": "Renumbered after the merger",
      "actor": "mem_3Jq8T",
      "via": "api",
      "created": "2026-11-07T12:00:00Z",
      "applied": "2026-11-07T12:00:00Z",
      "cancelled": null
    }
  ],
  "next_cursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.