---
title: "Get workspaces workspaceID history"
method: GET
path: "/v1/workspaces/{workspaceID}/history"
---

# Get workspaces workspaceID history

`GET /v1/workspaces/{workspaceID}/history`

## Request

- Base URL: `https://api.plori.ai`
- URL: `https://api.plori.ai/v1/workspaces/{workspaceID}/history`
- Auth: HTTP bearer

Accepted revisions of the Workspace, newest first. With path, only the revisions that changed that exact file, each with the kind of change. Without path, every accepted revision with its path count. Each item names the agent, the person and who accepted a changeset. complete is false while the paths of a recent revision are not recorded yet, so the latest change to a file can be one revision behind. Readable by the owner, members and viewers of the account.

## Path parameters

- `workspaceID` string, uuid, required

## Query parameters

- `path` string
- `cursor` string
- `limit` integer

## Response `200`

Request accepted or completed.

- object
  - `complete` boolean, required
  - `items` object[], required
    - `revision_id` string, uuid, required
    - `previous_revision_id` string, uuid: Absent for the first revision.
    - `accepted_at` string, date-time, required
    - `source` 'root_save' | 'changeset', required
    - `path` string: Present with the path query parameter.
    - `kind` 'add' | 'modify' | 'delete' | 'rename' | 'type': Present with the path query parameter.
    - `from` string: Previous path of a rename. Present with the path query parameter.
    - `path_count` integer: Number of recorded paths. Present without the path query parameter.
    - `paths_state` 'pending' | 'ready' | 'truncated' | 'unavailable': Present without the path query parameter.
    - `changeset_id` string, uuid
    - `run_id` string, uuid
    - `worker_request_id` string, uuid
    - `agent` object
      - `id` string, uuid, required
      - `name` string, required
    - `person` object: The person behind the change: the run's actor, the worker's creator, or the person whose Files edits were saved.
    - `decision` 'platform' | 'review_action' | 'person' | 'api_key': Who accepted the changeset. Present only when source is changeset.
    - `decided_by` object: Present when decision is person.
  - `next_cursor` string: Absent on the last page.

## Other responses

- `400`: Malformed request.
- `401`: Missing or invalid credential.
- `404`: No such resource.

---

[API](https://skmtc.dev/plori/apis/plori-rest-api.md) · [All operations](https://skmtc.dev/plori/apis/plori-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plori/apis/plori-rest-api/revisions/15c4f9260dff?raw)