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

# List activity

> Read a task's History: every edit, agent note and escalation step, newest first.

Use this to see when something happened to a task. For example, the time its `status` changed to `completed` is the `occurred_at` of the `change` event whose `changes` include `field: "status"` and `new_value: "completed"`. The task itself only carries `updated_at`, which any later edit moves.

Each event has a `type`:

* `change`: an edit to the task. `changes` lists every field it changed.
* `agent_note`: a progress note from an agent. `summary` is its one-line headline.
* `escalation`: a step in an escalation raised on the task. `summary` is the escalation's title, and `escalation_event` says what happened: `created`, `resolved`, `withdrawn`, `reassigned` (it stays open with a new decider), or `host_canceled`, `host_archived` or `host_deleted` (the task was cancelled, archived or deleted, which closed the escalation).

Comments are not part of the History. Read them with [List comments](https://wordsmithai.mintlify.site/api-reference/tasks/list-comments.md), whose items carry their own `created_at`.

`actor` is the person who made the change and `agent_name` the agent that made it. Both are set when an agent acted for a person. `actor` is `null` for an agent working on its own and for the system. It is also `null` when the person's account no longer exists, so a `null` actor with no `agent_name` does not prove the system made the change.

Each change gives the value before and after twice. `old_value` and `new_value` are in the form the rest of the API uses: an enum value such as `in_progress`, an id without prefix, or an ISO 8601 UTC time for `complete_by`. `old_label` and `new_label` are the text the task History shows, such as `In Progress` or a person's name. Each change's `field` and the form of its values:

| `field` | `old_value` / `new_value` | `old_label` / `new_label` |
| - | - | - |
| `title`, `description`, `additional_context` | the text as written | the same text |
| `status`, `priority` | the enum value, such as `in_progress` or `high` | the display name, such as `In Progress` |
| `assigned_to` | the user's id | the user's name |
| `assigned_agent` | the agent's record id, the `id` of the task's `assigned_agent` | the agent's name |
| `assigned_team_id` | the team's id | the team's name |
| `matter_id` | the matter's id | the matter's name |
| `complete_by` | an ISO 8601 UTC time | a date such as `Jan 16, 2026` |
| `archived` | `true` or `false` | `null` |
| `created` | `null`: the task's first version | `null` |
| `tag_added`, `tag_removed`, `file_added`, `file_removed` | `null` | the tag or file name |
| `link_added`, `link_removed` | the linked item's type, such as `chat` or `review` | the linked item's name |

A label falls back to the id when the name no longer resolves, for example after a user is removed. New fields may appear as History grows, so treat a `field` you do not recognise as a change to show by its labels.

Collection events carry only one side. Tag and file events (`tag_added`, `tag_removed`, `file_added`, `file_removed`) have only a label: their `old_value` and `new_value` are `null`. Link events (`link_added`, `link_removed`) give the linked item's type, such as `chat` or `review`, as the value and its name as the label. Free-text fields such as `title` and `description` keep their text exactly as written.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --location --request GET 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/activity' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/activity", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests

url = "https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/activity"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
[
  {
    "type": "change",
    "occurred_at": "2026-01-14T16:20:05Z",
    "actor": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "agent_name": null,
    "changes": [
      {
        "field": "status",
        "old_value": "in_progress",
        "new_value": "completed",
        "old_label": "In Progress",
        "new_label": "Completed"
      }
    ],
    "summary": null,
    "escalation_id": null,
    "escalation_event": null
  },
  {
    "type": "agent_note",
    "occurred_at": "2026-01-14T09:02:41Z",
    "actor": null,
    "agent_name": "Paralegal",
    "changes": [],
    "summary": "Sent the mark-up to the counterparty",
    "escalation_id": null,
    "escalation_event": null
  },
  {
    "type": "change",
    "occurred_at": "2026-01-13T11:47:12Z",
    "actor": null,
    "agent_name": "Paralegal",
    "changes": [
      {
        "field": "assigned_to",
        "old_value": null,
        "new_value": "11111111-2222-3333-4444-555555555555",
        "old_label": null,
        "new_label": "Jane Doe"
      },
      {
        "field": "complete_by",
        "old_value": null,
        "new_value": "2026-01-16T17:00:00Z",
        "old_label": null,
        "new_label": "Jan 16, 2026"
      }
    ],
    "summary": null,
    "escalation_id": null,
    "escalation_event": null
  }
]
```


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