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/sessionsPast 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 itanswered in this tab

curl

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

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`requiredWhich 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 itanswered in this tab

curl

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

TypeScript

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

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