---
title: "Past sessions · intentic sandbox API"
description: "Conversations that have finished, and their transcripts. Every route in the past sessions group of the intentic sandbox API, with its input, its answer and a playground."
url: "https://intentic.dev/api/sessions/"
---

Agents

# Past sessions

Conversations that have finished, and their transcripts

Two reads. The list of past conversations, and one conversation's full record by id.

**GET`/sessions` Past conversations in this workspace**

Summaries for a history menu, filtered when you pass a search. Covers conversations that worked in their own private copies too, so nothing is hidden just because it happened on a branch.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `query` | string | query |
| `caseSensitive` | string | query |

### What comes back

| Field | Type |
| --- | --- |
| `sessions` Past conversations, newest first | object[] |
| `id` Its id | string |
| `title` What it is called | string |
| `updatedAt` When it last moved, in milliseconds | number |
| `snippet` Why a search matched: the line… | object |
| `text` The matching line, with a little… | string |
| `speaker` Who said it | "user" | "agent" |

Try it answered in this tab

curl

```bash
curl "$SANDBOX/sessions" \
 -H "x-intentic-control: $INTENTIC_TOKEN"
```

TypeScript

```typescript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.sessions.list();
```

**GET`/sessions/{id}` Read one past conversation**

The full record of a single conversation, restored for display.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required Which past conversation | string | address |

### What comes back

| Field | Type |
| --- | --- |
| `messages` The conversation, in order | object[] |
| `role` Who said it | "user" | "assistant" | "notice" |
| `text` The words | string |
| `sentAt` When it was sent, in milliseconds | number |
| `attachments` Files attached to this message, as… | string[] |
| `checkpointId` The saved point this message can… | string |
| `thinking` What the agent was reasoning about | string |
| `tools` The tool calls this part of… | object[] |
| `id` The call's id | string |
| `name` Which tool | string |
| `category` What kind of thing it does:… | "read" | "edit" | "delete" | "move" … (9) |
| `status` How it went | "pending" | "in_progress" | "completed" | "failed" |
| `target` What it acted on, in one… | string |
| `locations` The files it touched | object[] |
| `path` The file, as a workspace path,… | string |
| `line` Which line, counting from one | number |
| `content` What it produced: text, a change… | object[] |
| `type` Plain output | "text" |
| `text` What the tool said | string |
| `children` Calls a delegated helper made, nested… | object[] |
| `id` The call's id | string |
| `name` Which tool | string |
| `category` What kind of thing it does:… | "read" | "edit" | "delete" | "move" … (9) |
| `status` How it went | "pending" | "in_progress" | "completed" | "failed" |
| `target` What it acted on, in one… | string |
| `locations` The files it touched | object[] |
| `content` What it produced: text, a change… | object[] |
| `children` Calls a delegated helper made, nested… | object[] |
| `thinking` What the agent was reasoning about… | string |
| `thinking` What the agent was reasoning about… | string |
| `notes` What the sandbox added to this… | object[] |
| `title` The one line a reader sees,… | string |
| `text` The note itself, which is also… | string |
| `placed` A person wrote this in the… | boolean |
| `noticeAction` A one-press follow-up this recorded notice… | "tierHold" |

Try it answered in this tab

curl

```bash
curl "$SANDBOX/sessions/a1b2c3d4" \
 -H "x-intentic-control: $INTENTIC_TOKEN"
```

TypeScript

```typescript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.sessions.get({
 "id": "a1b2c3d4"
});
```

More in Agents

[Previous ← The fleet](https://intentic.dev/api/agents/)[Next Workflows →](https://intentic.dev/api/workflows/)