---
title: "Private conversations · intentic sandbox API"
description: "Who reads whose conversations, and how a private one is opened. Every route in the private conversations group of the intentic sandbox API."
url: "https://intentic.dev/api/seal/"
---

The workspace

# Private conversations

Who reads whose conversations, and how a private one is opened

**On this page (8 sections)**

- [Who reads whose conversations](#seal-house)
- [Set who reads whose conversations](#seal-setHouse)
- [Start my conversations private](#seal-setDefault)
- [Make a conversation private or shared](#seal-set)
- [Ask to read a private conversation](#seal-ask)
- [Answer an ask to read](#seal-answer)
- [Open a private conversation without asking](#seal-open)
- [Agree to an opening without asking](#seal-approveOpen)

The house rule, each person's default, making a conversation private or shared, asking its author to read it and their answer. The sandbox owner alone may open one without asking, with their passkey over a reason the author is shown; no agent can do any of it.

8 calls. Pick one to open it, or use the list on the right.

**GET`/seal` Who reads whose conversations**

The house rule for private conversations, whether an organisation fixed it, and whether a conversation you start now begins private.

### What you send

Nothing. Call it as it is.

### What comes back

| Field | Type |
| --- | --- |
| `mode` The house rule: who reads whose… | "everyone" | "chooses" | "private" |
| `locked` Whether the sandbox's organisation fixed the… | boolean |
| `twoPerson` Whether opening a private conversation without… | boolean |
| `hosted` Whether intentic runs this sandbox, so… | boolean |
| `sealed` How many conversations are private right… | integer |
| `startsPrivate` Whether a conversation the caller starts… | boolean |
| `ownDefault` The caller's own answer to whether… | boolean |

Try it answered in this tab

curl

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

TypeScript

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

const result = await sandbox.seal.house();
```

**POST`/seal/house` Set who reads whose conversations**

Sets the house rule. It applies to conversations started from now on: a conversation that is already private stays private whatever the rule becomes, until its author shares it.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `mode` required | "everyone" | "chooses" | "private" | body |

### What comes back

| Field | Type |
| --- | --- |
| `mode` The house rule: who reads whose… | "everyone" | "chooses" | "private" |
| `locked` Whether the sandbox's organisation fixed the… | boolean |
| `twoPerson` Whether opening a private conversation without… | boolean |
| `hosted` Whether intentic runs this sandbox, so… | boolean |
| `sealed` How many conversations are private right… | integer |
| `startsPrivate` Whether a conversation the caller starts… | boolean |
| `ownDefault` The caller's own answer to whether… | boolean |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/house" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"mode":"everyone"}'
```

TypeScript

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

const result = await sandbox.seal.setHouse({
 "mode": "everyone"
});
```

**POST`/seal/default` Start my conversations private**

Your own answer to whether the conversations you start begin private, where the house rule leaves it to each author.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `private` required Whether the caller's new conversations start… | boolean | body |

### What comes back

| Field | Type |
| --- | --- |
| `mode` The house rule: who reads whose… | "everyone" | "chooses" | "private" |
| `locked` Whether the sandbox's organisation fixed the… | boolean |
| `twoPerson` Whether opening a private conversation without… | boolean |
| `hosted` Whether intentic runs this sandbox, so… | boolean |
| `sealed` How many conversations are private right… | integer |
| `startsPrivate` Whether a conversation the caller starts… | boolean |
| `ownDefault` The caller's own answer to whether… | boolean |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/default" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"private":true}'
```

TypeScript

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

const result = await sandbox.seal.setDefault({
 "private": true
});
```

**POST`/seal/{id}` Make a conversation private or shared**

Makes a conversation private to its author and the people they name, or shared again. Only its author may, or one of its readers when nobody answers for it. Its subagents and reviews follow it. What it already landed stays where it is.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required The conversation | string | address |
| `private` required | boolean | body |
| `readers` Who besides its author may read… | string[] | body |

### What comes back

| Field | Type |
| --- | --- |
| `id` The conversation id, which is how… | string |
| `sessionId` The provider session behind the last… | string |
| `title` What to call it: the first… | string |
| `titleAction` One word for the kind of… | string |
| `status` What it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
| `failure` Why the last turn failed, in… | string |
| `failureCode` Which kind of failure it was,… | string |
| `failureOwn` Whether `failure` is the sandbox's own… | boolean |
| `failureRepeats` How many turns in a row… | integer |
| `limitResetsAt` When the spent allowance reopens, in… | number |
| `limitHeld` Whether the refused turn is held… | boolean |
| `limitScheduled` Sent only by sandboxes older than… | boolean |
| `limitMoving` Sent only by sandboxes older than… | string |
| `limitNextAt` Sent only by sandboxes older than… | number |
| `next` What carries it on next with… | object |
| `when kind is "rerun"` | shape |
| `at` When the held turn goes again,… | number |
| `onto` The account the owner's answer to… | string |
| `when kind is "room"` | shape |
| `when kind is "send"` | shape |
| `at` When the soonest booked message goes,… | number |
| `count` How many messages are booked to… | integer |
| `when kind is "land"` | shape |
| `after` The conversation whose landed work the… | string |
| `turn` Set when that message waits for… | true |
| `count` How many messages are booked to… | integer |
| `press` The daemon's one reading of what… | object |
| `when kind is "none"` | shape |
| `when kind is "continue"` | shape |
| `ending` How the last turn ended, which… | object |
| `reason` Which ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
| `resetsAt` When the spent allowance reopens, in… | number |
| `held` Present when the daemon still holds… | object |
| `scheduled` Whether something other than the user… | boolean |
| `nextAt` When the booked send actually fires,… | number |
| `retries` How many automatic re-runs a stopped… | object |
| `provider` Which model provider it runs on | string |
| `harness` Which agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `runner` The runner this conversation runs on | string |
| `startIn` Which folder it opened in, relative… | string |
| `actsAs` Which role its first turn acted… | string |
| `lastActsAs` Which role its last turn acted… | string |
| `model` What its last turn ran with | string |
| `effort` How hard that turn was told… | string |
| `thinking` Whether that turn showed its reasoning | boolean |
| `fast` Whether that turn asked for higher… | boolean |
| `account` Which connected account paid for it | string |
| `branch` The branch its private copy works… | string |
| `autoLand` This conversation's own answer to whether… | boolean |
| `limitPolicy` | "wait" | "resend" | "move" |
| `outagePolicy` | "wait" | "retry" |
| `stopPolicy` | "wait" | "retry" |
| `memoryPolicy` | "wait" | "resend" |
| `memoryKillPolicy` This conversation's own answer to a… | "wait" | "resume" |
| `proceedWithoutAsking` This conversation's own answer to whether… | boolean |
| `autoApprove` Whether every permission this conversation asks… | "own" | "inherited" |
| `landRequested` A collaborator has asked a maintainer… | object |
| `email` Who asked | string |
| `name` Their display name | string |
| `at` When they asked, in milliseconds | number |
| `reactions` What people have marked this conversation… | object[] |
| `emoji` The mark itself, one emoji, carried… | string |
| `by` Everyone wearing this mark, oldest first,… | object[] |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `at` When they marked it, in milliseconds | number |
| `origin` Where the conversation came from when… | object |
| `automationId` | string |
| `provider` | string |
| `channelId` | string |
| `threadId` | string |
| `author` | string |
| `startedBy` Who asked for the first turn,… | string |
| `areas` Which named areas of the workspace… | string[] |
| `owner` The member answerable for this conversation:… | object |
| `email` Who answers for this conversation, as… | string |
| `name` What to call them, when the… | string |
| `since` When they became its owner, in… | number |
| `participants` The people who took part in… | object[] |
| `email` Who took part, lowercased, as the… | string |
| `name` What to call them, when their… | string |
| `since` When they first took part, in… | number |
| `via` How they first took part: they… | "prompt" | "answer" | "land" | "mention" |
| `notify` Your own answer to how much… | object[] |
| `email` Whose answer it is, lowercased | string |
| `level` What they asked to hear of… | "all" | "asks" | "none" |
| `at` When they chose it, in milliseconds | number |
| `forkedFrom` The conversation this one was cut… | object |
| `conversationId` | string |
| `index` | integer |
| `files` | "then" | "now" |
| `fresh` Set on a conversation started on… | object |
| `of` The conversation whose work it started… | string |
| `kind` What it was opened for: a… | "review" | "test" | "ask" |
| `at` When it started, in milliseconds | number |
| `by` The agent that opened it, when… | string |
| `branches` The branches this conversation was started… | object[] |
| `repo` Which repository | string |
| `branch` The branch, by its short name:… | string |
| `seal` Set on a private conversation: how… | object |
| `sealed` The caller cannot read this conversation:… | true |
| `via` How the caller reads it | "reader" | "grant" | "open" |
| `until` Until when the caller may read… | number |
| `readers` | object[] |
| `email` | string |
| `name` | string |
| `grants` | object[] |
| `email` | string |
| `name` | string |
| `until` Until when they may read it,… | number |
| `by` Who let them, by address | string |
| `asks` | object[] |
| `email` | string |
| `name` | string |
| `at` | number |
| `opens` | object[] |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `asked` On a sealed card: the caller… | true |
| `pending` An opening without asking that waits… | object |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `canOpen` On a sealed card: the caller… | true |
| `canApprove` The caller may agree to the… | true |
| `home` This is its owner's home conversation… | true |
| `commits` A home conversation's latest lands as… | object[] |
| `land` The land's id, as its `landed`… | string |
| `at` When it was committed, in milliseconds | number |
| `subject` The commit's subject line | string |
| `commits` The commit each repository the land… | object[] |
| `repo` Which repository: "root" for the workspace… | string |
| `sha` The commit, in full | string |
| `freshPending` A home conversation whose next message… | "asked" | "cleared" |
| `base` The commit its private copy started… | string |
| `costUsd` What it has cost so far,… | number |
| `inputTokens` Uncached input tokens, excluding cache reads… | number |
| `outputTokens` Tokens received | number |
| `contextTokens` How much of the window the… | number |
| `contextWindow` How large that window is | number |
| `promptCache` When this conversation's prompt cache was… | object |
| `at` When its last request touched the… | number |
| `ttlMs` How long that entry lives from… | number |
| `rollsAt` When the date written into the… | number |
| `keepableUntil` Present when this sandbox can keep… | number |
| `keepWarm` Whether the sandbox is keeping this… | object |
| `since` When keeping it warm started, in… | number |
| `until` When it stops by itself, in… | number |
| `refreshes` Refreshes sent so far | integer |
| `readTokens` How much the last refresh read… | number |
| `ended` Why keeping it warm stopped before… | object |
| `at` When it stopped, in milliseconds | number |
| `reason` Why: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
| `detail` The specifics, when there are any:… | string |
| `activity` What it is doing at this… | object |
| `tool` The last tool it reached for | string |
| `target` What it reached for that tool… | string |
| `todo` The item on its own list… | string |
| `checklist` How far it is through its… | object |
| `done` Items it has completed | number |
| `total` Items on the list | number |
| `doing` Items it has marked in progress… | number |
| `landedMessageDraft` The whole story of this merge's… | object |
| `startedAt` When the drafting began, in milliseconds | number |
| `steps` Each model that was asked, in… | object[] |
| `provider` Which provider was asked | string |
| `model` Which of its models | string |
| `status` How this one went | "asking" | "answered" | "refused" | "skipped" |
| `at` When it started being asked, in… | number |
| `ms` How long it took | number |
| `reason` Why it refused, in its own… | string |
| `outcome` How it ended | "written" | "failed" |
| `reason` The one-line account of a failure,… | string |
| `finishedAt` When it ended, in milliseconds | number |
| `landedMessage` What this conversation's merged work is… | object |
| `subject` One line saying what the merged… | string |
| `note` The same change said to somebody… | string |
| `breaking` What this change takes away, for… | string |
| `testNote` Why a test this change weakened… | string |
| `allows` Exceptions the conversation declared for this… | string[] |
| `startedAt` When the running turn started, in… | number |
| `run` The run under way right now:… | string |
| `queue` Messages waiting for its next turn,… | object |
| `items` What waits, in the order it… | object[] |
| `id` The message's id: what its sender… | string |
| `text` The words, as they will go… | string |
| `attachments` Files that go with it, as… | string[] |
| `voice` Who it is from: a person,… | "person" | "sandbox" | "agent" |
| `queuedAt` When it joined the queue, in… | number |
| `revision` The queue's revision when this message… | integer |
| `until` When this message goes out by… | number |
| `after` The conversation whose finished work must… | string |
| `afterTurn` Says `after` waits for that conversation's… | true |
| `reopenOf` The allowance this message's `until` waits… | object |
| `agent` The provider whose allowance it waits… | string |
| `account` Which of its accounts | string |
| `trialRetry` Says `until` is the sandbox sending… | object |
| `made` Which automatic try this booking is,… | integer |
| `max` How many automatic tries the sandbox… | integer |
| `serves` Who serves the turn this message… | object |
| `agent` The provider | string |
| `harness` The agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `model` The model | string |
| `effort` How hard it thinks, where the… | string |
| `account` The account that pays for it | string |
| `continues` A continuation, not words: when it… | true |
| `revision` Moves with every change to the… | integer |
| `paused` Why the messages with no booking… | "stopped" | "refused" | "scheduled" |
| `until` The soonest booked message's time, in… | number |
| `after` The conversation the first booked message… | string |
| `updatedAt` When it last did something, in… | number |
| `answeredAt` When its model provider last answered… | number |
| `seenAt` When somebody last opened it, in… | number |
| `unsentAt` Since when somebody's composer has held… | number |
| `attention` Which kinds of waiting-for-you it is… | object |
| `plan` It has proposed a plan and… | boolean |
| `question` It has asked you something | boolean |
| `permission` It wants to use a tool… | boolean |
| `capability` It needs something connected that is… | boolean |
| `credential` It is waiting for a named… | boolean |
| `conflict` Its work cannot be merged without… | boolean |
| `need` It asked a person for something… | boolean |
| `permissionAsk` The oldest permission its running turn… | object |
| `requestId` Which request this is: the id… | string |
| `ask` What it asks to do, on… | string |
| `program` The program it is holding, as… | object |
| `text` What would run | string |
| `language` Which of the two backends it… | "bash" | "javascript" |
| `truncated` Whether this is an excerpt of… | boolean |
| `spans` Which fragments of the text the… | object[] |
| `start` | integer |
| `end` | integer |
| `landFailure` The last attempt to bring its… | object |
| `reason` Why it failed, in the words… | string |
| `code` Which kind of failure it was,… | string |
| `at` When it failed, in milliseconds | number |
| `delivery` What became of its last land… | object |
| `state` | "delivered" | "partial" | "waiting" | "failed" … (5) |
| `at` When this state was reached, in… | number |
| `project` | string |
| `folder` The folder on the owner's computer,… | string |
| `applied` Files written, merged ones included | integer |
| `conflicts` | object[] |
| `path` | string |
| `reason` | "edited" | "link" | "outside" | "missing-git" |
| `point` The machine's restore point taken before… | string |
| `reason` Why it failed or waits, in… | string |
| `conflictCauses` Why its work will not merge,… | "workspace" | "diverged" | "binary"[] |
| `unfinished` What its last turn left open:… | object |
| `at` When the turn that left this… | number |
| `steps` The agent's own checklist where that… | object |
| `open` Items on it that were never… | number |
| `total` Items on the whole list | number |
| `next` The one it would have done… | string |
| `check` The end-of-turn check that was still… | string |
| `proof` What its last turn showed of… | object |
| `at` When the turn that left this… | number |
| `verification` Verified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
| `check` The command that spoke, when one… | string |
| `unviewed` How many rendered files it changed… | number |
| `review` The latest code review this conversation… | object |
| `at` When the turn that reported it… | number |
| `source` Which harness's reviewer reported it | "claude" | "codex" |
| `findings` How many findings it reported | integer |
| `open` How many of those no re-report… | integer |
| `reach` Where its last turn's work went… | object |
| `at` When the turn that left this… | number |
| `live` Files it changed in place where… | object[] |
| `path` What it wrote, as it named… | string |
| `extension` The extension, by its manifest id,… | string |
| `liveMore` How many more such files there… | number |
| `stranded` Repositories it cloned inside its own… | object[] |
| `dir` The clone, as a folder relative… | string |
| `uncommitted` Files changed in it and never… | number |
| `unpushed` Commits in it its upstream does… | number |
| `commits` Commits it holds at all, 0… | number |
| `parent` The workspace repository it sits inside,… | string |
| `strandedMore` How many more such clones there… | number |
| `published` Pushes it made with git that… | object[] |
| `dir` The folder it pushed from, as… | string |
| `remote` The remote it pushed to, as… | string |
| `branch` The branch it pushed to, as… | string |
| `command` The push itself, trimmed to one… | string |
| `publishedMore` How many more such pushes there… | number |
| `turns` Turns it has finished | number |
| `toolUses` Tools it has used, over its… | number |
| `subagents` Subagents this one started, in-process and… | object |
| `running` Subagents working right now | number |
| `total` Subagents it has started over its… | number |
| `diff` Everything it has written, measured from… | object |
| `files` Files touched | number |
| `insertions` Lines added | number |
| `deletions` Lines removed | number |
| `modules` The packages its changes fall in,… | string[] |
| `landedPresence` Present only when some of what… | object |
| `landed` Paths this conversation merged in | number |
| `present` How many of them are still… | number |
| `removedBy` Who took them out, when the… | object |
| `when kind is "agent"` | shape |
| `id` The conversation that took them out | string |
| `title` What that conversation is called | string |
| `when kind is "person"` | shape |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `loop` The loop driving this conversation, if… | object |
| `state` How the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
| `iteration` Which round it is on | integer |
| `maxIterations` How many rounds it will attempt… | integer |
| `goal` What it is looping towards | string |
| `workflow` The workflow run this conversation is… | object |
| `runId` The run this belongs to, which… | string |
| `name` The workflow's name | string |
| `step` Which step this conversation is on… | string |
| `index` This step's place in the workflow,… | integer |
| `total` How many steps the workflow has | integer |
| `awaitingWake` Whether this conversation runs again by… | boolean |
| `watches` Outside conditions this conversation is parked… | object[] |
| `id` The daemon's handle for this watch,… | string |
| `note` The agent's own line on what… | string |
| `intervalSeconds` How often the check runs | integer |
| `deadlineAt` When it gives up and wakes… | number |
| `needs` What it is waiting on people… | object[] |
| `id` | string |
| `kind` What is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
| `title` | string |
| `status` Where it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
| `jobs` Commands this conversation left running in… | object[] |
| `id` The daemon's handle for this job,… | string |
| `label` What the job is, in the… | string |
| `session` The terminal session its pane runs… | string |
| `startedAt` When it started, in milliseconds | number |
| `endedAt` When the command exited, in milliseconds | number |
| `exitCode` The code it exited with | integer |
| `watch` The watch its exit wakes this… | string |
| `handed` Left running for the person: the… | boolean |
| `ports` The ports it was listening on… | integer[] |
| `stoppedBy` Who stopped it: the sandbox, when… | "turn" | "person" | "agent" |
| `inputWait` Present while it sits blocked reading… | object |
| `since` When it went still, in milliseconds | number |
| `program` The process blocked reading the terminal,… | string |
| `scriptRuns` Workflow runs this conversation started that… | object[] |
| `id` The run's id, the one its… | string |
| `name` The workflow's name, from its script's… | string |
| `calls` How many subagents it has started… | integer |
| `working` How many of its subagents are… | integer |
| `failed` How many of its calls failed… | integer |
| `phase` The phase its script last marked | string |
| `startedAt` When it started, in milliseconds | number |
| `archivedAt` When it was put away, in… | number |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/a1b2c3d4" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"private":true,"readers":["…","…"]}'
```

TypeScript

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

const result = await sandbox.seal.set({
 "id": "a1b2c3d4",
 "private": true,
 "readers": [
 "…",
 "…"
 ]
});
```

**POST`/seal/{id}/ask` Ask to read a private conversation**

Asks its author to show it to you. They can show it for a day, add you as a reader, or say no; nothing opens until they answer.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required The conversation | string | address |

### What comes back

| Field | Type |
| --- | --- |
| `id` The conversation id, which is how… | string |
| `sessionId` The provider session behind the last… | string |
| `title` What to call it: the first… | string |
| `titleAction` One word for the kind of… | string |
| `status` What it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
| `failure` Why the last turn failed, in… | string |
| `failureCode` Which kind of failure it was,… | string |
| `failureOwn` Whether `failure` is the sandbox's own… | boolean |
| `failureRepeats` How many turns in a row… | integer |
| `limitResetsAt` When the spent allowance reopens, in… | number |
| `limitHeld` Whether the refused turn is held… | boolean |
| `limitScheduled` Sent only by sandboxes older than… | boolean |
| `limitMoving` Sent only by sandboxes older than… | string |
| `limitNextAt` Sent only by sandboxes older than… | number |
| `next` What carries it on next with… | object |
| `when kind is "rerun"` | shape |
| `at` When the held turn goes again,… | number |
| `onto` The account the owner's answer to… | string |
| `when kind is "room"` | shape |
| `when kind is "send"` | shape |
| `at` When the soonest booked message goes,… | number |
| `count` How many messages are booked to… | integer |
| `when kind is "land"` | shape |
| `after` The conversation whose landed work the… | string |
| `turn` Set when that message waits for… | true |
| `count` How many messages are booked to… | integer |
| `press` The daemon's one reading of what… | object |
| `when kind is "none"` | shape |
| `when kind is "continue"` | shape |
| `ending` How the last turn ended, which… | object |
| `reason` Which ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
| `resetsAt` When the spent allowance reopens, in… | number |
| `held` Present when the daemon still holds… | object |
| `scheduled` Whether something other than the user… | boolean |
| `nextAt` When the booked send actually fires,… | number |
| `retries` How many automatic re-runs a stopped… | object |
| `provider` Which model provider it runs on | string |
| `harness` Which agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `runner` The runner this conversation runs on | string |
| `startIn` Which folder it opened in, relative… | string |
| `actsAs` Which role its first turn acted… | string |
| `lastActsAs` Which role its last turn acted… | string |
| `model` What its last turn ran with | string |
| `effort` How hard that turn was told… | string |
| `thinking` Whether that turn showed its reasoning | boolean |
| `fast` Whether that turn asked for higher… | boolean |
| `account` Which connected account paid for it | string |
| `branch` The branch its private copy works… | string |
| `autoLand` This conversation's own answer to whether… | boolean |
| `limitPolicy` | "wait" | "resend" | "move" |
| `outagePolicy` | "wait" | "retry" |
| `stopPolicy` | "wait" | "retry" |
| `memoryPolicy` | "wait" | "resend" |
| `memoryKillPolicy` This conversation's own answer to a… | "wait" | "resume" |
| `proceedWithoutAsking` This conversation's own answer to whether… | boolean |
| `autoApprove` Whether every permission this conversation asks… | "own" | "inherited" |
| `landRequested` A collaborator has asked a maintainer… | object |
| `email` Who asked | string |
| `name` Their display name | string |
| `at` When they asked, in milliseconds | number |
| `reactions` What people have marked this conversation… | object[] |
| `emoji` The mark itself, one emoji, carried… | string |
| `by` Everyone wearing this mark, oldest first,… | object[] |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `at` When they marked it, in milliseconds | number |
| `origin` Where the conversation came from when… | object |
| `automationId` | string |
| `provider` | string |
| `channelId` | string |
| `threadId` | string |
| `author` | string |
| `startedBy` Who asked for the first turn,… | string |
| `areas` Which named areas of the workspace… | string[] |
| `owner` The member answerable for this conversation:… | object |
| `email` Who answers for this conversation, as… | string |
| `name` What to call them, when the… | string |
| `since` When they became its owner, in… | number |
| `participants` The people who took part in… | object[] |
| `email` Who took part, lowercased, as the… | string |
| `name` What to call them, when their… | string |
| `since` When they first took part, in… | number |
| `via` How they first took part: they… | "prompt" | "answer" | "land" | "mention" |
| `notify` Your own answer to how much… | object[] |
| `email` Whose answer it is, lowercased | string |
| `level` What they asked to hear of… | "all" | "asks" | "none" |
| `at` When they chose it, in milliseconds | number |
| `forkedFrom` The conversation this one was cut… | object |
| `conversationId` | string |
| `index` | integer |
| `files` | "then" | "now" |
| `fresh` Set on a conversation started on… | object |
| `of` The conversation whose work it started… | string |
| `kind` What it was opened for: a… | "review" | "test" | "ask" |
| `at` When it started, in milliseconds | number |
| `by` The agent that opened it, when… | string |
| `branches` The branches this conversation was started… | object[] |
| `repo` Which repository | string |
| `branch` The branch, by its short name:… | string |
| `seal` Set on a private conversation: how… | object |
| `sealed` The caller cannot read this conversation:… | true |
| `via` How the caller reads it | "reader" | "grant" | "open" |
| `until` Until when the caller may read… | number |
| `readers` | object[] |
| `email` | string |
| `name` | string |
| `grants` | object[] |
| `email` | string |
| `name` | string |
| `until` Until when they may read it,… | number |
| `by` Who let them, by address | string |
| `asks` | object[] |
| `email` | string |
| `name` | string |
| `at` | number |
| `opens` | object[] |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `asked` On a sealed card: the caller… | true |
| `pending` An opening without asking that waits… | object |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `canOpen` On a sealed card: the caller… | true |
| `canApprove` The caller may agree to the… | true |
| `home` This is its owner's home conversation… | true |
| `commits` A home conversation's latest lands as… | object[] |
| `land` The land's id, as its `landed`… | string |
| `at` When it was committed, in milliseconds | number |
| `subject` The commit's subject line | string |
| `commits` The commit each repository the land… | object[] |
| `repo` Which repository: "root" for the workspace… | string |
| `sha` The commit, in full | string |
| `freshPending` A home conversation whose next message… | "asked" | "cleared" |
| `base` The commit its private copy started… | string |
| `costUsd` What it has cost so far,… | number |
| `inputTokens` Uncached input tokens, excluding cache reads… | number |
| `outputTokens` Tokens received | number |
| `contextTokens` How much of the window the… | number |
| `contextWindow` How large that window is | number |
| `promptCache` When this conversation's prompt cache was… | object |
| `at` When its last request touched the… | number |
| `ttlMs` How long that entry lives from… | number |
| `rollsAt` When the date written into the… | number |
| `keepableUntil` Present when this sandbox can keep… | number |
| `keepWarm` Whether the sandbox is keeping this… | object |
| `since` When keeping it warm started, in… | number |
| `until` When it stops by itself, in… | number |
| `refreshes` Refreshes sent so far | integer |
| `readTokens` How much the last refresh read… | number |
| `ended` Why keeping it warm stopped before… | object |
| `at` When it stopped, in milliseconds | number |
| `reason` Why: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
| `detail` The specifics, when there are any:… | string |
| `activity` What it is doing at this… | object |
| `tool` The last tool it reached for | string |
| `target` What it reached for that tool… | string |
| `todo` The item on its own list… | string |
| `checklist` How far it is through its… | object |
| `done` Items it has completed | number |
| `total` Items on the list | number |
| `doing` Items it has marked in progress… | number |
| `landedMessageDraft` The whole story of this merge's… | object |
| `startedAt` When the drafting began, in milliseconds | number |
| `steps` Each model that was asked, in… | object[] |
| `provider` Which provider was asked | string |
| `model` Which of its models | string |
| `status` How this one went | "asking" | "answered" | "refused" | "skipped" |
| `at` When it started being asked, in… | number |
| `ms` How long it took | number |
| `reason` Why it refused, in its own… | string |
| `outcome` How it ended | "written" | "failed" |
| `reason` The one-line account of a failure,… | string |
| `finishedAt` When it ended, in milliseconds | number |
| `landedMessage` What this conversation's merged work is… | object |
| `subject` One line saying what the merged… | string |
| `note` The same change said to somebody… | string |
| `breaking` What this change takes away, for… | string |
| `testNote` Why a test this change weakened… | string |
| `allows` Exceptions the conversation declared for this… | string[] |
| `startedAt` When the running turn started, in… | number |
| `run` The run under way right now:… | string |
| `queue` Messages waiting for its next turn,… | object |
| `items` What waits, in the order it… | object[] |
| `id` The message's id: what its sender… | string |
| `text` The words, as they will go… | string |
| `attachments` Files that go with it, as… | string[] |
| `voice` Who it is from: a person,… | "person" | "sandbox" | "agent" |
| `queuedAt` When it joined the queue, in… | number |
| `revision` The queue's revision when this message… | integer |
| `until` When this message goes out by… | number |
| `after` The conversation whose finished work must… | string |
| `afterTurn` Says `after` waits for that conversation's… | true |
| `reopenOf` The allowance this message's `until` waits… | object |
| `agent` The provider whose allowance it waits… | string |
| `account` Which of its accounts | string |
| `trialRetry` Says `until` is the sandbox sending… | object |
| `made` Which automatic try this booking is,… | integer |
| `max` How many automatic tries the sandbox… | integer |
| `serves` Who serves the turn this message… | object |
| `agent` The provider | string |
| `harness` The agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `model` The model | string |
| `effort` How hard it thinks, where the… | string |
| `account` The account that pays for it | string |
| `continues` A continuation, not words: when it… | true |
| `revision` Moves with every change to the… | integer |
| `paused` Why the messages with no booking… | "stopped" | "refused" | "scheduled" |
| `until` The soonest booked message's time, in… | number |
| `after` The conversation the first booked message… | string |
| `updatedAt` When it last did something, in… | number |
| `answeredAt` When its model provider last answered… | number |
| `seenAt` When somebody last opened it, in… | number |
| `unsentAt` Since when somebody's composer has held… | number |
| `attention` Which kinds of waiting-for-you it is… | object |
| `plan` It has proposed a plan and… | boolean |
| `question` It has asked you something | boolean |
| `permission` It wants to use a tool… | boolean |
| `capability` It needs something connected that is… | boolean |
| `credential` It is waiting for a named… | boolean |
| `conflict` Its work cannot be merged without… | boolean |
| `need` It asked a person for something… | boolean |
| `permissionAsk` The oldest permission its running turn… | object |
| `requestId` Which request this is: the id… | string |
| `ask` What it asks to do, on… | string |
| `program` The program it is holding, as… | object |
| `text` What would run | string |
| `language` Which of the two backends it… | "bash" | "javascript" |
| `truncated` Whether this is an excerpt of… | boolean |
| `spans` Which fragments of the text the… | object[] |
| `start` | integer |
| `end` | integer |
| `landFailure` The last attempt to bring its… | object |
| `reason` Why it failed, in the words… | string |
| `code` Which kind of failure it was,… | string |
| `at` When it failed, in milliseconds | number |
| `delivery` What became of its last land… | object |
| `state` | "delivered" | "partial" | "waiting" | "failed" … (5) |
| `at` When this state was reached, in… | number |
| `project` | string |
| `folder` The folder on the owner's computer,… | string |
| `applied` Files written, merged ones included | integer |
| `conflicts` | object[] |
| `path` | string |
| `reason` | "edited" | "link" | "outside" | "missing-git" |
| `point` The machine's restore point taken before… | string |
| `reason` Why it failed or waits, in… | string |
| `conflictCauses` Why its work will not merge,… | "workspace" | "diverged" | "binary"[] |
| `unfinished` What its last turn left open:… | object |
| `at` When the turn that left this… | number |
| `steps` The agent's own checklist where that… | object |
| `open` Items on it that were never… | number |
| `total` Items on the whole list | number |
| `next` The one it would have done… | string |
| `check` The end-of-turn check that was still… | string |
| `proof` What its last turn showed of… | object |
| `at` When the turn that left this… | number |
| `verification` Verified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
| `check` The command that spoke, when one… | string |
| `unviewed` How many rendered files it changed… | number |
| `review` The latest code review this conversation… | object |
| `at` When the turn that reported it… | number |
| `source` Which harness's reviewer reported it | "claude" | "codex" |
| `findings` How many findings it reported | integer |
| `open` How many of those no re-report… | integer |
| `reach` Where its last turn's work went… | object |
| `at` When the turn that left this… | number |
| `live` Files it changed in place where… | object[] |
| `path` What it wrote, as it named… | string |
| `extension` The extension, by its manifest id,… | string |
| `liveMore` How many more such files there… | number |
| `stranded` Repositories it cloned inside its own… | object[] |
| `dir` The clone, as a folder relative… | string |
| `uncommitted` Files changed in it and never… | number |
| `unpushed` Commits in it its upstream does… | number |
| `commits` Commits it holds at all, 0… | number |
| `parent` The workspace repository it sits inside,… | string |
| `strandedMore` How many more such clones there… | number |
| `published` Pushes it made with git that… | object[] |
| `dir` The folder it pushed from, as… | string |
| `remote` The remote it pushed to, as… | string |
| `branch` The branch it pushed to, as… | string |
| `command` The push itself, trimmed to one… | string |
| `publishedMore` How many more such pushes there… | number |
| `turns` Turns it has finished | number |
| `toolUses` Tools it has used, over its… | number |
| `subagents` Subagents this one started, in-process and… | object |
| `running` Subagents working right now | number |
| `total` Subagents it has started over its… | number |
| `diff` Everything it has written, measured from… | object |
| `files` Files touched | number |
| `insertions` Lines added | number |
| `deletions` Lines removed | number |
| `modules` The packages its changes fall in,… | string[] |
| `landedPresence` Present only when some of what… | object |
| `landed` Paths this conversation merged in | number |
| `present` How many of them are still… | number |
| `removedBy` Who took them out, when the… | object |
| `when kind is "agent"` | shape |
| `id` The conversation that took them out | string |
| `title` What that conversation is called | string |
| `when kind is "person"` | shape |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `loop` The loop driving this conversation, if… | object |
| `state` How the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
| `iteration` Which round it is on | integer |
| `maxIterations` How many rounds it will attempt… | integer |
| `goal` What it is looping towards | string |
| `workflow` The workflow run this conversation is… | object |
| `runId` The run this belongs to, which… | string |
| `name` The workflow's name | string |
| `step` Which step this conversation is on… | string |
| `index` This step's place in the workflow,… | integer |
| `total` How many steps the workflow has | integer |
| `awaitingWake` Whether this conversation runs again by… | boolean |
| `watches` Outside conditions this conversation is parked… | object[] |
| `id` The daemon's handle for this watch,… | string |
| `note` The agent's own line on what… | string |
| `intervalSeconds` How often the check runs | integer |
| `deadlineAt` When it gives up and wakes… | number |
| `needs` What it is waiting on people… | object[] |
| `id` | string |
| `kind` What is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
| `title` | string |
| `status` Where it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
| `jobs` Commands this conversation left running in… | object[] |
| `id` The daemon's handle for this job,… | string |
| `label` What the job is, in the… | string |
| `session` The terminal session its pane runs… | string |
| `startedAt` When it started, in milliseconds | number |
| `endedAt` When the command exited, in milliseconds | number |
| `exitCode` The code it exited with | integer |
| `watch` The watch its exit wakes this… | string |
| `handed` Left running for the person: the… | boolean |
| `ports` The ports it was listening on… | integer[] |
| `stoppedBy` Who stopped it: the sandbox, when… | "turn" | "person" | "agent" |
| `inputWait` Present while it sits blocked reading… | object |
| `since` When it went still, in milliseconds | number |
| `program` The process blocked reading the terminal,… | string |
| `scriptRuns` Workflow runs this conversation started that… | object[] |
| `id` The run's id, the one its… | string |
| `name` The workflow's name, from its script's… | string |
| `calls` How many subagents it has started… | integer |
| `working` How many of its subagents are… | integer |
| `failed` How many of its calls failed… | integer |
| `phase` The phase its script last marked | string |
| `startedAt` When it started, in milliseconds | number |
| `archivedAt` When it was put away, in… | number |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/a1b2c3d4/ask" \
 -H "x-intentic-control: $INTENTIC_TOKEN"
```

TypeScript

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

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

**POST`/seal/{id}/answer` Answer an ask to read**

The author's answer to someone who asked to read their private conversation: for a day, for good, or no.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required The conversation | string | address |
| `email` required Whose ask this answers | string | body |
| `answer` required Show it to them for a… | "day" | "always" | "decline" | body |

### What comes back

| Field | Type |
| --- | --- |
| `id` The conversation id, which is how… | string |
| `sessionId` The provider session behind the last… | string |
| `title` What to call it: the first… | string |
| `titleAction` One word for the kind of… | string |
| `status` What it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
| `failure` Why the last turn failed, in… | string |
| `failureCode` Which kind of failure it was,… | string |
| `failureOwn` Whether `failure` is the sandbox's own… | boolean |
| `failureRepeats` How many turns in a row… | integer |
| `limitResetsAt` When the spent allowance reopens, in… | number |
| `limitHeld` Whether the refused turn is held… | boolean |
| `limitScheduled` Sent only by sandboxes older than… | boolean |
| `limitMoving` Sent only by sandboxes older than… | string |
| `limitNextAt` Sent only by sandboxes older than… | number |
| `next` What carries it on next with… | object |
| `when kind is "rerun"` | shape |
| `at` When the held turn goes again,… | number |
| `onto` The account the owner's answer to… | string |
| `when kind is "room"` | shape |
| `when kind is "send"` | shape |
| `at` When the soonest booked message goes,… | number |
| `count` How many messages are booked to… | integer |
| `when kind is "land"` | shape |
| `after` The conversation whose landed work the… | string |
| `turn` Set when that message waits for… | true |
| `count` How many messages are booked to… | integer |
| `press` The daemon's one reading of what… | object |
| `when kind is "none"` | shape |
| `when kind is "continue"` | shape |
| `ending` How the last turn ended, which… | object |
| `reason` Which ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
| `resetsAt` When the spent allowance reopens, in… | number |
| `held` Present when the daemon still holds… | object |
| `scheduled` Whether something other than the user… | boolean |
| `nextAt` When the booked send actually fires,… | number |
| `retries` How many automatic re-runs a stopped… | object |
| `provider` Which model provider it runs on | string |
| `harness` Which agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `runner` The runner this conversation runs on | string |
| `startIn` Which folder it opened in, relative… | string |
| `actsAs` Which role its first turn acted… | string |
| `lastActsAs` Which role its last turn acted… | string |
| `model` What its last turn ran with | string |
| `effort` How hard that turn was told… | string |
| `thinking` Whether that turn showed its reasoning | boolean |
| `fast` Whether that turn asked for higher… | boolean |
| `account` Which connected account paid for it | string |
| `branch` The branch its private copy works… | string |
| `autoLand` This conversation's own answer to whether… | boolean |
| `limitPolicy` | "wait" | "resend" | "move" |
| `outagePolicy` | "wait" | "retry" |
| `stopPolicy` | "wait" | "retry" |
| `memoryPolicy` | "wait" | "resend" |
| `memoryKillPolicy` This conversation's own answer to a… | "wait" | "resume" |
| `proceedWithoutAsking` This conversation's own answer to whether… | boolean |
| `autoApprove` Whether every permission this conversation asks… | "own" | "inherited" |
| `landRequested` A collaborator has asked a maintainer… | object |
| `email` Who asked | string |
| `name` Their display name | string |
| `at` When they asked, in milliseconds | number |
| `reactions` What people have marked this conversation… | object[] |
| `emoji` The mark itself, one emoji, carried… | string |
| `by` Everyone wearing this mark, oldest first,… | object[] |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `at` When they marked it, in milliseconds | number |
| `origin` Where the conversation came from when… | object |
| `automationId` | string |
| `provider` | string |
| `channelId` | string |
| `threadId` | string |
| `author` | string |
| `startedBy` Who asked for the first turn,… | string |
| `areas` Which named areas of the workspace… | string[] |
| `owner` The member answerable for this conversation:… | object |
| `email` Who answers for this conversation, as… | string |
| `name` What to call them, when the… | string |
| `since` When they became its owner, in… | number |
| `participants` The people who took part in… | object[] |
| `email` Who took part, lowercased, as the… | string |
| `name` What to call them, when their… | string |
| `since` When they first took part, in… | number |
| `via` How they first took part: they… | "prompt" | "answer" | "land" | "mention" |
| `notify` Your own answer to how much… | object[] |
| `email` Whose answer it is, lowercased | string |
| `level` What they asked to hear of… | "all" | "asks" | "none" |
| `at` When they chose it, in milliseconds | number |
| `forkedFrom` The conversation this one was cut… | object |
| `conversationId` | string |
| `index` | integer |
| `files` | "then" | "now" |
| `fresh` Set on a conversation started on… | object |
| `of` The conversation whose work it started… | string |
| `kind` What it was opened for: a… | "review" | "test" | "ask" |
| `at` When it started, in milliseconds | number |
| `by` The agent that opened it, when… | string |
| `branches` The branches this conversation was started… | object[] |
| `repo` Which repository | string |
| `branch` The branch, by its short name:… | string |
| `seal` Set on a private conversation: how… | object |
| `sealed` The caller cannot read this conversation:… | true |
| `via` How the caller reads it | "reader" | "grant" | "open" |
| `until` Until when the caller may read… | number |
| `readers` | object[] |
| `email` | string |
| `name` | string |
| `grants` | object[] |
| `email` | string |
| `name` | string |
| `until` Until when they may read it,… | number |
| `by` Who let them, by address | string |
| `asks` | object[] |
| `email` | string |
| `name` | string |
| `at` | number |
| `opens` | object[] |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `asked` On a sealed card: the caller… | true |
| `pending` An opening without asking that waits… | object |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `canOpen` On a sealed card: the caller… | true |
| `canApprove` The caller may agree to the… | true |
| `home` This is its owner's home conversation… | true |
| `commits` A home conversation's latest lands as… | object[] |
| `land` The land's id, as its `landed`… | string |
| `at` When it was committed, in milliseconds | number |
| `subject` The commit's subject line | string |
| `commits` The commit each repository the land… | object[] |
| `repo` Which repository: "root" for the workspace… | string |
| `sha` The commit, in full | string |
| `freshPending` A home conversation whose next message… | "asked" | "cleared" |
| `base` The commit its private copy started… | string |
| `costUsd` What it has cost so far,… | number |
| `inputTokens` Uncached input tokens, excluding cache reads… | number |
| `outputTokens` Tokens received | number |
| `contextTokens` How much of the window the… | number |
| `contextWindow` How large that window is | number |
| `promptCache` When this conversation's prompt cache was… | object |
| `at` When its last request touched the… | number |
| `ttlMs` How long that entry lives from… | number |
| `rollsAt` When the date written into the… | number |
| `keepableUntil` Present when this sandbox can keep… | number |
| `keepWarm` Whether the sandbox is keeping this… | object |
| `since` When keeping it warm started, in… | number |
| `until` When it stops by itself, in… | number |
| `refreshes` Refreshes sent so far | integer |
| `readTokens` How much the last refresh read… | number |
| `ended` Why keeping it warm stopped before… | object |
| `at` When it stopped, in milliseconds | number |
| `reason` Why: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
| `detail` The specifics, when there are any:… | string |
| `activity` What it is doing at this… | object |
| `tool` The last tool it reached for | string |
| `target` What it reached for that tool… | string |
| `todo` The item on its own list… | string |
| `checklist` How far it is through its… | object |
| `done` Items it has completed | number |
| `total` Items on the list | number |
| `doing` Items it has marked in progress… | number |
| `landedMessageDraft` The whole story of this merge's… | object |
| `startedAt` When the drafting began, in milliseconds | number |
| `steps` Each model that was asked, in… | object[] |
| `provider` Which provider was asked | string |
| `model` Which of its models | string |
| `status` How this one went | "asking" | "answered" | "refused" | "skipped" |
| `at` When it started being asked, in… | number |
| `ms` How long it took | number |
| `reason` Why it refused, in its own… | string |
| `outcome` How it ended | "written" | "failed" |
| `reason` The one-line account of a failure,… | string |
| `finishedAt` When it ended, in milliseconds | number |
| `landedMessage` What this conversation's merged work is… | object |
| `subject` One line saying what the merged… | string |
| `note` The same change said to somebody… | string |
| `breaking` What this change takes away, for… | string |
| `testNote` Why a test this change weakened… | string |
| `allows` Exceptions the conversation declared for this… | string[] |
| `startedAt` When the running turn started, in… | number |
| `run` The run under way right now:… | string |
| `queue` Messages waiting for its next turn,… | object |
| `items` What waits, in the order it… | object[] |
| `id` The message's id: what its sender… | string |
| `text` The words, as they will go… | string |
| `attachments` Files that go with it, as… | string[] |
| `voice` Who it is from: a person,… | "person" | "sandbox" | "agent" |
| `queuedAt` When it joined the queue, in… | number |
| `revision` The queue's revision when this message… | integer |
| `until` When this message goes out by… | number |
| `after` The conversation whose finished work must… | string |
| `afterTurn` Says `after` waits for that conversation's… | true |
| `reopenOf` The allowance this message's `until` waits… | object |
| `agent` The provider whose allowance it waits… | string |
| `account` Which of its accounts | string |
| `trialRetry` Says `until` is the sandbox sending… | object |
| `made` Which automatic try this booking is,… | integer |
| `max` How many automatic tries the sandbox… | integer |
| `serves` Who serves the turn this message… | object |
| `agent` The provider | string |
| `harness` The agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `model` The model | string |
| `effort` How hard it thinks, where the… | string |
| `account` The account that pays for it | string |
| `continues` A continuation, not words: when it… | true |
| `revision` Moves with every change to the… | integer |
| `paused` Why the messages with no booking… | "stopped" | "refused" | "scheduled" |
| `until` The soonest booked message's time, in… | number |
| `after` The conversation the first booked message… | string |
| `updatedAt` When it last did something, in… | number |
| `answeredAt` When its model provider last answered… | number |
| `seenAt` When somebody last opened it, in… | number |
| `unsentAt` Since when somebody's composer has held… | number |
| `attention` Which kinds of waiting-for-you it is… | object |
| `plan` It has proposed a plan and… | boolean |
| `question` It has asked you something | boolean |
| `permission` It wants to use a tool… | boolean |
| `capability` It needs something connected that is… | boolean |
| `credential` It is waiting for a named… | boolean |
| `conflict` Its work cannot be merged without… | boolean |
| `need` It asked a person for something… | boolean |
| `permissionAsk` The oldest permission its running turn… | object |
| `requestId` Which request this is: the id… | string |
| `ask` What it asks to do, on… | string |
| `program` The program it is holding, as… | object |
| `text` What would run | string |
| `language` Which of the two backends it… | "bash" | "javascript" |
| `truncated` Whether this is an excerpt of… | boolean |
| `spans` Which fragments of the text the… | object[] |
| `start` | integer |
| `end` | integer |
| `landFailure` The last attempt to bring its… | object |
| `reason` Why it failed, in the words… | string |
| `code` Which kind of failure it was,… | string |
| `at` When it failed, in milliseconds | number |
| `delivery` What became of its last land… | object |
| `state` | "delivered" | "partial" | "waiting" | "failed" … (5) |
| `at` When this state was reached, in… | number |
| `project` | string |
| `folder` The folder on the owner's computer,… | string |
| `applied` Files written, merged ones included | integer |
| `conflicts` | object[] |
| `path` | string |
| `reason` | "edited" | "link" | "outside" | "missing-git" |
| `point` The machine's restore point taken before… | string |
| `reason` Why it failed or waits, in… | string |
| `conflictCauses` Why its work will not merge,… | "workspace" | "diverged" | "binary"[] |
| `unfinished` What its last turn left open:… | object |
| `at` When the turn that left this… | number |
| `steps` The agent's own checklist where that… | object |
| `open` Items on it that were never… | number |
| `total` Items on the whole list | number |
| `next` The one it would have done… | string |
| `check` The end-of-turn check that was still… | string |
| `proof` What its last turn showed of… | object |
| `at` When the turn that left this… | number |
| `verification` Verified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
| `check` The command that spoke, when one… | string |
| `unviewed` How many rendered files it changed… | number |
| `review` The latest code review this conversation… | object |
| `at` When the turn that reported it… | number |
| `source` Which harness's reviewer reported it | "claude" | "codex" |
| `findings` How many findings it reported | integer |
| `open` How many of those no re-report… | integer |
| `reach` Where its last turn's work went… | object |
| `at` When the turn that left this… | number |
| `live` Files it changed in place where… | object[] |
| `path` What it wrote, as it named… | string |
| `extension` The extension, by its manifest id,… | string |
| `liveMore` How many more such files there… | number |
| `stranded` Repositories it cloned inside its own… | object[] |
| `dir` The clone, as a folder relative… | string |
| `uncommitted` Files changed in it and never… | number |
| `unpushed` Commits in it its upstream does… | number |
| `commits` Commits it holds at all, 0… | number |
| `parent` The workspace repository it sits inside,… | string |
| `strandedMore` How many more such clones there… | number |
| `published` Pushes it made with git that… | object[] |
| `dir` The folder it pushed from, as… | string |
| `remote` The remote it pushed to, as… | string |
| `branch` The branch it pushed to, as… | string |
| `command` The push itself, trimmed to one… | string |
| `publishedMore` How many more such pushes there… | number |
| `turns` Turns it has finished | number |
| `toolUses` Tools it has used, over its… | number |
| `subagents` Subagents this one started, in-process and… | object |
| `running` Subagents working right now | number |
| `total` Subagents it has started over its… | number |
| `diff` Everything it has written, measured from… | object |
| `files` Files touched | number |
| `insertions` Lines added | number |
| `deletions` Lines removed | number |
| `modules` The packages its changes fall in,… | string[] |
| `landedPresence` Present only when some of what… | object |
| `landed` Paths this conversation merged in | number |
| `present` How many of them are still… | number |
| `removedBy` Who took them out, when the… | object |
| `when kind is "agent"` | shape |
| `id` The conversation that took them out | string |
| `title` What that conversation is called | string |
| `when kind is "person"` | shape |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `loop` The loop driving this conversation, if… | object |
| `state` How the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
| `iteration` Which round it is on | integer |
| `maxIterations` How many rounds it will attempt… | integer |
| `goal` What it is looping towards | string |
| `workflow` The workflow run this conversation is… | object |
| `runId` The run this belongs to, which… | string |
| `name` The workflow's name | string |
| `step` Which step this conversation is on… | string |
| `index` This step's place in the workflow,… | integer |
| `total` How many steps the workflow has | integer |
| `awaitingWake` Whether this conversation runs again by… | boolean |
| `watches` Outside conditions this conversation is parked… | object[] |
| `id` The daemon's handle for this watch,… | string |
| `note` The agent's own line on what… | string |
| `intervalSeconds` How often the check runs | integer |
| `deadlineAt` When it gives up and wakes… | number |
| `needs` What it is waiting on people… | object[] |
| `id` | string |
| `kind` What is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
| `title` | string |
| `status` Where it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
| `jobs` Commands this conversation left running in… | object[] |
| `id` The daemon's handle for this job,… | string |
| `label` What the job is, in the… | string |
| `session` The terminal session its pane runs… | string |
| `startedAt` When it started, in milliseconds | number |
| `endedAt` When the command exited, in milliseconds | number |
| `exitCode` The code it exited with | integer |
| `watch` The watch its exit wakes this… | string |
| `handed` Left running for the person: the… | boolean |
| `ports` The ports it was listening on… | integer[] |
| `stoppedBy` Who stopped it: the sandbox, when… | "turn" | "person" | "agent" |
| `inputWait` Present while it sits blocked reading… | object |
| `since` When it went still, in milliseconds | number |
| `program` The process blocked reading the terminal,… | string |
| `scriptRuns` Workflow runs this conversation started that… | object[] |
| `id` The run's id, the one its… | string |
| `name` The workflow's name, from its script's… | string |
| `calls` How many subagents it has started… | integer |
| `working` How many of its subagents are… | integer |
| `failed` How many of its calls failed… | integer |
| `phase` The phase its script last marked | string |
| `startedAt` When it started, in milliseconds | number |
| `archivedAt` When it was put away, in… | number |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/a1b2c3d4/answer" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"email":"ada@example.com","answer":"day"}'
```

TypeScript

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

const result = await sandbox.seal.answer({
 "id": "a1b2c3d4",
 "email": "ada@example.com",
 "answer": "day"
});
```

**POST`/seal/{id}/open` Open a private conversation without asking**

For the sandbox owner alone, with a written reason: lets them read a private conversation for a day without its author's yes. It is read-only, its author is told at once, and the reason stays on the conversation for good. Where an organisation asks for two people, it waits for a second person with Full access to agree.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required The conversation | string | address |
| `reason` required | string | body |

### What comes back

| Field | Type |
| --- | --- |
| `id` The conversation id, which is how… | string |
| `sessionId` The provider session behind the last… | string |
| `title` What to call it: the first… | string |
| `titleAction` One word for the kind of… | string |
| `status` What it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
| `failure` Why the last turn failed, in… | string |
| `failureCode` Which kind of failure it was,… | string |
| `failureOwn` Whether `failure` is the sandbox's own… | boolean |
| `failureRepeats` How many turns in a row… | integer |
| `limitResetsAt` When the spent allowance reopens, in… | number |
| `limitHeld` Whether the refused turn is held… | boolean |
| `limitScheduled` Sent only by sandboxes older than… | boolean |
| `limitMoving` Sent only by sandboxes older than… | string |
| `limitNextAt` Sent only by sandboxes older than… | number |
| `next` What carries it on next with… | object |
| `when kind is "rerun"` | shape |
| `at` When the held turn goes again,… | number |
| `onto` The account the owner's answer to… | string |
| `when kind is "room"` | shape |
| `when kind is "send"` | shape |
| `at` When the soonest booked message goes,… | number |
| `count` How many messages are booked to… | integer |
| `when kind is "land"` | shape |
| `after` The conversation whose landed work the… | string |
| `turn` Set when that message waits for… | true |
| `count` How many messages are booked to… | integer |
| `press` The daemon's one reading of what… | object |
| `when kind is "none"` | shape |
| `when kind is "continue"` | shape |
| `ending` How the last turn ended, which… | object |
| `reason` Which ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
| `resetsAt` When the spent allowance reopens, in… | number |
| `held` Present when the daemon still holds… | object |
| `scheduled` Whether something other than the user… | boolean |
| `nextAt` When the booked send actually fires,… | number |
| `retries` How many automatic re-runs a stopped… | object |
| `provider` Which model provider it runs on | string |
| `harness` Which agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `runner` The runner this conversation runs on | string |
| `startIn` Which folder it opened in, relative… | string |
| `actsAs` Which role its first turn acted… | string |
| `lastActsAs` Which role its last turn acted… | string |
| `model` What its last turn ran with | string |
| `effort` How hard that turn was told… | string |
| `thinking` Whether that turn showed its reasoning | boolean |
| `fast` Whether that turn asked for higher… | boolean |
| `account` Which connected account paid for it | string |
| `branch` The branch its private copy works… | string |
| `autoLand` This conversation's own answer to whether… | boolean |
| `limitPolicy` | "wait" | "resend" | "move" |
| `outagePolicy` | "wait" | "retry" |
| `stopPolicy` | "wait" | "retry" |
| `memoryPolicy` | "wait" | "resend" |
| `memoryKillPolicy` This conversation's own answer to a… | "wait" | "resume" |
| `proceedWithoutAsking` This conversation's own answer to whether… | boolean |
| `autoApprove` Whether every permission this conversation asks… | "own" | "inherited" |
| `landRequested` A collaborator has asked a maintainer… | object |
| `email` Who asked | string |
| `name` Their display name | string |
| `at` When they asked, in milliseconds | number |
| `reactions` What people have marked this conversation… | object[] |
| `emoji` The mark itself, one emoji, carried… | string |
| `by` Everyone wearing this mark, oldest first,… | object[] |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `at` When they marked it, in milliseconds | number |
| `origin` Where the conversation came from when… | object |
| `automationId` | string |
| `provider` | string |
| `channelId` | string |
| `threadId` | string |
| `author` | string |
| `startedBy` Who asked for the first turn,… | string |
| `areas` Which named areas of the workspace… | string[] |
| `owner` The member answerable for this conversation:… | object |
| `email` Who answers for this conversation, as… | string |
| `name` What to call them, when the… | string |
| `since` When they became its owner, in… | number |
| `participants` The people who took part in… | object[] |
| `email` Who took part, lowercased, as the… | string |
| `name` What to call them, when their… | string |
| `since` When they first took part, in… | number |
| `via` How they first took part: they… | "prompt" | "answer" | "land" | "mention" |
| `notify` Your own answer to how much… | object[] |
| `email` Whose answer it is, lowercased | string |
| `level` What they asked to hear of… | "all" | "asks" | "none" |
| `at` When they chose it, in milliseconds | number |
| `forkedFrom` The conversation this one was cut… | object |
| `conversationId` | string |
| `index` | integer |
| `files` | "then" | "now" |
| `fresh` Set on a conversation started on… | object |
| `of` The conversation whose work it started… | string |
| `kind` What it was opened for: a… | "review" | "test" | "ask" |
| `at` When it started, in milliseconds | number |
| `by` The agent that opened it, when… | string |
| `branches` The branches this conversation was started… | object[] |
| `repo` Which repository | string |
| `branch` The branch, by its short name:… | string |
| `seal` Set on a private conversation: how… | object |
| `sealed` The caller cannot read this conversation:… | true |
| `via` How the caller reads it | "reader" | "grant" | "open" |
| `until` Until when the caller may read… | number |
| `readers` | object[] |
| `email` | string |
| `name` | string |
| `grants` | object[] |
| `email` | string |
| `name` | string |
| `until` Until when they may read it,… | number |
| `by` Who let them, by address | string |
| `asks` | object[] |
| `email` | string |
| `name` | string |
| `at` | number |
| `opens` | object[] |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `asked` On a sealed card: the caller… | true |
| `pending` An opening without asking that waits… | object |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `canOpen` On a sealed card: the caller… | true |
| `canApprove` The caller may agree to the… | true |
| `home` This is its owner's home conversation… | true |
| `commits` A home conversation's latest lands as… | object[] |
| `land` The land's id, as its `landed`… | string |
| `at` When it was committed, in milliseconds | number |
| `subject` The commit's subject line | string |
| `commits` The commit each repository the land… | object[] |
| `repo` Which repository: "root" for the workspace… | string |
| `sha` The commit, in full | string |
| `freshPending` A home conversation whose next message… | "asked" | "cleared" |
| `base` The commit its private copy started… | string |
| `costUsd` What it has cost so far,… | number |
| `inputTokens` Uncached input tokens, excluding cache reads… | number |
| `outputTokens` Tokens received | number |
| `contextTokens` How much of the window the… | number |
| `contextWindow` How large that window is | number |
| `promptCache` When this conversation's prompt cache was… | object |
| `at` When its last request touched the… | number |
| `ttlMs` How long that entry lives from… | number |
| `rollsAt` When the date written into the… | number |
| `keepableUntil` Present when this sandbox can keep… | number |
| `keepWarm` Whether the sandbox is keeping this… | object |
| `since` When keeping it warm started, in… | number |
| `until` When it stops by itself, in… | number |
| `refreshes` Refreshes sent so far | integer |
| `readTokens` How much the last refresh read… | number |
| `ended` Why keeping it warm stopped before… | object |
| `at` When it stopped, in milliseconds | number |
| `reason` Why: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
| `detail` The specifics, when there are any:… | string |
| `activity` What it is doing at this… | object |
| `tool` The last tool it reached for | string |
| `target` What it reached for that tool… | string |
| `todo` The item on its own list… | string |
| `checklist` How far it is through its… | object |
| `done` Items it has completed | number |
| `total` Items on the list | number |
| `doing` Items it has marked in progress… | number |
| `landedMessageDraft` The whole story of this merge's… | object |
| `startedAt` When the drafting began, in milliseconds | number |
| `steps` Each model that was asked, in… | object[] |
| `provider` Which provider was asked | string |
| `model` Which of its models | string |
| `status` How this one went | "asking" | "answered" | "refused" | "skipped" |
| `at` When it started being asked, in… | number |
| `ms` How long it took | number |
| `reason` Why it refused, in its own… | string |
| `outcome` How it ended | "written" | "failed" |
| `reason` The one-line account of a failure,… | string |
| `finishedAt` When it ended, in milliseconds | number |
| `landedMessage` What this conversation's merged work is… | object |
| `subject` One line saying what the merged… | string |
| `note` The same change said to somebody… | string |
| `breaking` What this change takes away, for… | string |
| `testNote` Why a test this change weakened… | string |
| `allows` Exceptions the conversation declared for this… | string[] |
| `startedAt` When the running turn started, in… | number |
| `run` The run under way right now:… | string |
| `queue` Messages waiting for its next turn,… | object |
| `items` What waits, in the order it… | object[] |
| `id` The message's id: what its sender… | string |
| `text` The words, as they will go… | string |
| `attachments` Files that go with it, as… | string[] |
| `voice` Who it is from: a person,… | "person" | "sandbox" | "agent" |
| `queuedAt` When it joined the queue, in… | number |
| `revision` The queue's revision when this message… | integer |
| `until` When this message goes out by… | number |
| `after` The conversation whose finished work must… | string |
| `afterTurn` Says `after` waits for that conversation's… | true |
| `reopenOf` The allowance this message's `until` waits… | object |
| `agent` The provider whose allowance it waits… | string |
| `account` Which of its accounts | string |
| `trialRetry` Says `until` is the sandbox sending… | object |
| `made` Which automatic try this booking is,… | integer |
| `max` How many automatic tries the sandbox… | integer |
| `serves` Who serves the turn this message… | object |
| `agent` The provider | string |
| `harness` The agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `model` The model | string |
| `effort` How hard it thinks, where the… | string |
| `account` The account that pays for it | string |
| `continues` A continuation, not words: when it… | true |
| `revision` Moves with every change to the… | integer |
| `paused` Why the messages with no booking… | "stopped" | "refused" | "scheduled" |
| `until` The soonest booked message's time, in… | number |
| `after` The conversation the first booked message… | string |
| `updatedAt` When it last did something, in… | number |
| `answeredAt` When its model provider last answered… | number |
| `seenAt` When somebody last opened it, in… | number |
| `unsentAt` Since when somebody's composer has held… | number |
| `attention` Which kinds of waiting-for-you it is… | object |
| `plan` It has proposed a plan and… | boolean |
| `question` It has asked you something | boolean |
| `permission` It wants to use a tool… | boolean |
| `capability` It needs something connected that is… | boolean |
| `credential` It is waiting for a named… | boolean |
| `conflict` Its work cannot be merged without… | boolean |
| `need` It asked a person for something… | boolean |
| `permissionAsk` The oldest permission its running turn… | object |
| `requestId` Which request this is: the id… | string |
| `ask` What it asks to do, on… | string |
| `program` The program it is holding, as… | object |
| `text` What would run | string |
| `language` Which of the two backends it… | "bash" | "javascript" |
| `truncated` Whether this is an excerpt of… | boolean |
| `spans` Which fragments of the text the… | object[] |
| `start` | integer |
| `end` | integer |
| `landFailure` The last attempt to bring its… | object |
| `reason` Why it failed, in the words… | string |
| `code` Which kind of failure it was,… | string |
| `at` When it failed, in milliseconds | number |
| `delivery` What became of its last land… | object |
| `state` | "delivered" | "partial" | "waiting" | "failed" … (5) |
| `at` When this state was reached, in… | number |
| `project` | string |
| `folder` The folder on the owner's computer,… | string |
| `applied` Files written, merged ones included | integer |
| `conflicts` | object[] |
| `path` | string |
| `reason` | "edited" | "link" | "outside" | "missing-git" |
| `point` The machine's restore point taken before… | string |
| `reason` Why it failed or waits, in… | string |
| `conflictCauses` Why its work will not merge,… | "workspace" | "diverged" | "binary"[] |
| `unfinished` What its last turn left open:… | object |
| `at` When the turn that left this… | number |
| `steps` The agent's own checklist where that… | object |
| `open` Items on it that were never… | number |
| `total` Items on the whole list | number |
| `next` The one it would have done… | string |
| `check` The end-of-turn check that was still… | string |
| `proof` What its last turn showed of… | object |
| `at` When the turn that left this… | number |
| `verification` Verified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
| `check` The command that spoke, when one… | string |
| `unviewed` How many rendered files it changed… | number |
| `review` The latest code review this conversation… | object |
| `at` When the turn that reported it… | number |
| `source` Which harness's reviewer reported it | "claude" | "codex" |
| `findings` How many findings it reported | integer |
| `open` How many of those no re-report… | integer |
| `reach` Where its last turn's work went… | object |
| `at` When the turn that left this… | number |
| `live` Files it changed in place where… | object[] |
| `path` What it wrote, as it named… | string |
| `extension` The extension, by its manifest id,… | string |
| `liveMore` How many more such files there… | number |
| `stranded` Repositories it cloned inside its own… | object[] |
| `dir` The clone, as a folder relative… | string |
| `uncommitted` Files changed in it and never… | number |
| `unpushed` Commits in it its upstream does… | number |
| `commits` Commits it holds at all, 0… | number |
| `parent` The workspace repository it sits inside,… | string |
| `strandedMore` How many more such clones there… | number |
| `published` Pushes it made with git that… | object[] |
| `dir` The folder it pushed from, as… | string |
| `remote` The remote it pushed to, as… | string |
| `branch` The branch it pushed to, as… | string |
| `command` The push itself, trimmed to one… | string |
| `publishedMore` How many more such pushes there… | number |
| `turns` Turns it has finished | number |
| `toolUses` Tools it has used, over its… | number |
| `subagents` Subagents this one started, in-process and… | object |
| `running` Subagents working right now | number |
| `total` Subagents it has started over its… | number |
| `diff` Everything it has written, measured from… | object |
| `files` Files touched | number |
| `insertions` Lines added | number |
| `deletions` Lines removed | number |
| `modules` The packages its changes fall in,… | string[] |
| `landedPresence` Present only when some of what… | object |
| `landed` Paths this conversation merged in | number |
| `present` How many of them are still… | number |
| `removedBy` Who took them out, when the… | object |
| `when kind is "agent"` | shape |
| `id` The conversation that took them out | string |
| `title` What that conversation is called | string |
| `when kind is "person"` | shape |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `loop` The loop driving this conversation, if… | object |
| `state` How the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
| `iteration` Which round it is on | integer |
| `maxIterations` How many rounds it will attempt… | integer |
| `goal` What it is looping towards | string |
| `workflow` The workflow run this conversation is… | object |
| `runId` The run this belongs to, which… | string |
| `name` The workflow's name | string |
| `step` Which step this conversation is on… | string |
| `index` This step's place in the workflow,… | integer |
| `total` How many steps the workflow has | integer |
| `awaitingWake` Whether this conversation runs again by… | boolean |
| `watches` Outside conditions this conversation is parked… | object[] |
| `id` The daemon's handle for this watch,… | string |
| `note` The agent's own line on what… | string |
| `intervalSeconds` How often the check runs | integer |
| `deadlineAt` When it gives up and wakes… | number |
| `needs` What it is waiting on people… | object[] |
| `id` | string |
| `kind` What is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
| `title` | string |
| `status` Where it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
| `jobs` Commands this conversation left running in… | object[] |
| `id` The daemon's handle for this job,… | string |
| `label` What the job is, in the… | string |
| `session` The terminal session its pane runs… | string |
| `startedAt` When it started, in milliseconds | number |
| `endedAt` When the command exited, in milliseconds | number |
| `exitCode` The code it exited with | integer |
| `watch` The watch its exit wakes this… | string |
| `handed` Left running for the person: the… | boolean |
| `ports` The ports it was listening on… | integer[] |
| `stoppedBy` Who stopped it: the sandbox, when… | "turn" | "person" | "agent" |
| `inputWait` Present while it sits blocked reading… | object |
| `since` When it went still, in milliseconds | number |
| `program` The process blocked reading the terminal,… | string |
| `scriptRuns` Workflow runs this conversation started that… | object[] |
| `id` The run's id, the one its… | string |
| `name` The workflow's name, from its script's… | string |
| `calls` How many subagents it has started… | integer |
| `working` How many of its subagents are… | integer |
| `failed` How many of its calls failed… | integer |
| `phase` The phase its script last marked | string |
| `startedAt` When it started, in milliseconds | number |
| `archivedAt` When it was put away, in… | number |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/a1b2c3d4/open" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"reason":"Nothing had changed since the last run."}'
```

TypeScript

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

const result = await sandbox.seal.open({
 "id": "a1b2c3d4",
 "reason": "Nothing had changed since the last run."
});
```

**POST`/seal/{id}/open/approve` Agree to an opening without asking**

The second person an organisation's two-person rule asks for: agrees to the owner opening a private conversation without asking, or refuses it. The owner cannot be their own second person.

### What you send

| Field | Type | Where |
| --- | --- | --- |
| `id` required The conversation | string | address |
| `open` required Which opening | string | body |
| `agree` required | boolean | body |

### What comes back

| Field | Type |
| --- | --- |
| `id` The conversation id, which is how… | string |
| `sessionId` The provider session behind the last… | string |
| `title` What to call it: the first… | string |
| `titleAction` One word for the kind of… | string |
| `status` What it is doing | "idle" | "running" | "awaiting" | "stopping" … (13) |
| `failure` Why the last turn failed, in… | string |
| `failureCode` Which kind of failure it was,… | string |
| `failureOwn` Whether `failure` is the sandbox's own… | boolean |
| `failureRepeats` How many turns in a row… | integer |
| `limitResetsAt` When the spent allowance reopens, in… | number |
| `limitHeld` Whether the refused turn is held… | boolean |
| `limitScheduled` Sent only by sandboxes older than… | boolean |
| `limitMoving` Sent only by sandboxes older than… | string |
| `limitNextAt` Sent only by sandboxes older than… | number |
| `next` What carries it on next with… | object |
| `when kind is "rerun"` | shape |
| `at` When the held turn goes again,… | number |
| `onto` The account the owner's answer to… | string |
| `when kind is "room"` | shape |
| `when kind is "send"` | shape |
| `at` When the soonest booked message goes,… | number |
| `count` How many messages are booked to… | integer |
| `when kind is "land"` | shape |
| `after` The conversation whose landed work the… | string |
| `turn` Set when that message waits for… | true |
| `count` How many messages are booked to… | integer |
| `press` The daemon's one reading of what… | object |
| `when kind is "none"` | shape |
| `when kind is "continue"` | shape |
| `ending` How the last turn ended, which… | object |
| `reason` Which ending left the work here:… | "limit" | "outage" | "stopped" | "flagged" |
| `resetsAt` When the spent allowance reopens, in… | number |
| `held` Present when the daemon still holds… | object |
| `scheduled` Whether something other than the user… | boolean |
| `nextAt` When the booked send actually fires,… | number |
| `retries` How many automatic re-runs a stopped… | object |
| `provider` Which model provider it runs on | string |
| `harness` Which agentic loop it runs on | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `runner` The runner this conversation runs on | string |
| `startIn` Which folder it opened in, relative… | string |
| `actsAs` Which role its first turn acted… | string |
| `lastActsAs` Which role its last turn acted… | string |
| `model` What its last turn ran with | string |
| `effort` How hard that turn was told… | string |
| `thinking` Whether that turn showed its reasoning | boolean |
| `fast` Whether that turn asked for higher… | boolean |
| `account` Which connected account paid for it | string |
| `branch` The branch its private copy works… | string |
| `autoLand` This conversation's own answer to whether… | boolean |
| `limitPolicy` | "wait" | "resend" | "move" |
| `outagePolicy` | "wait" | "retry" |
| `stopPolicy` | "wait" | "retry" |
| `memoryPolicy` | "wait" | "resend" |
| `memoryKillPolicy` This conversation's own answer to a… | "wait" | "resume" |
| `proceedWithoutAsking` This conversation's own answer to whether… | boolean |
| `autoApprove` Whether every permission this conversation asks… | "own" | "inherited" |
| `landRequested` A collaborator has asked a maintainer… | object |
| `email` Who asked | string |
| `name` Their display name | string |
| `at` When they asked, in milliseconds | number |
| `reactions` What people have marked this conversation… | object[] |
| `emoji` The mark itself, one emoji, carried… | string |
| `by` Everyone wearing this mark, oldest first,… | object[] |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `at` When they marked it, in milliseconds | number |
| `origin` Where the conversation came from when… | object |
| `automationId` | string |
| `provider` | string |
| `channelId` | string |
| `threadId` | string |
| `author` | string |
| `startedBy` Who asked for the first turn,… | string |
| `areas` Which named areas of the workspace… | string[] |
| `owner` The member answerable for this conversation:… | object |
| `email` Who answers for this conversation, as… | string |
| `name` What to call them, when the… | string |
| `since` When they became its owner, in… | number |
| `participants` The people who took part in… | object[] |
| `email` Who took part, lowercased, as the… | string |
| `name` What to call them, when their… | string |
| `since` When they first took part, in… | number |
| `via` How they first took part: they… | "prompt" | "answer" | "land" | "mention" |
| `notify` Your own answer to how much… | object[] |
| `email` Whose answer it is, lowercased | string |
| `level` What they asked to hear of… | "all" | "asks" | "none" |
| `at` When they chose it, in milliseconds | number |
| `forkedFrom` The conversation this one was cut… | object |
| `conversationId` | string |
| `index` | integer |
| `files` | "then" | "now" |
| `fresh` Set on a conversation started on… | object |
| `of` The conversation whose work it started… | string |
| `kind` What it was opened for: a… | "review" | "test" | "ask" |
| `at` When it started, in milliseconds | number |
| `by` The agent that opened it, when… | string |
| `branches` The branches this conversation was started… | object[] |
| `repo` Which repository | string |
| `branch` The branch, by its short name:… | string |
| `seal` Set on a private conversation: how… | object |
| `sealed` The caller cannot read this conversation:… | true |
| `via` How the caller reads it | "reader" | "grant" | "open" |
| `until` Until when the caller may read… | number |
| `readers` | object[] |
| `email` | string |
| `name` | string |
| `grants` | object[] |
| `email` | string |
| `name` | string |
| `until` Until when they may read it,… | number |
| `by` Who let them, by address | string |
| `asks` | object[] |
| `email` | string |
| `name` | string |
| `at` | number |
| `opens` | object[] |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `asked` On a sealed card: the caller… | true |
| `pending` An opening without asking that waits… | object |
| `email` | string |
| `name` | string |
| `id` The opening's own id | string |
| `at` When it was asked for, in… | number |
| `until` Until when it may be read,… | number |
| `reason` Why, in the opener's words, as… | string |
| `approvedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `refusedBy` | object |
| `email` | string |
| `name` | string |
| `at` | number |
| `pending` | true |
| `canOpen` On a sealed card: the caller… | true |
| `canApprove` The caller may agree to the… | true |
| `home` This is its owner's home conversation… | true |
| `commits` A home conversation's latest lands as… | object[] |
| `land` The land's id, as its `landed`… | string |
| `at` When it was committed, in milliseconds | number |
| `subject` The commit's subject line | string |
| `commits` The commit each repository the land… | object[] |
| `repo` Which repository: "root" for the workspace… | string |
| `sha` The commit, in full | string |
| `freshPending` A home conversation whose next message… | "asked" | "cleared" |
| `base` The commit its private copy started… | string |
| `costUsd` What it has cost so far,… | number |
| `inputTokens` Uncached input tokens, excluding cache reads… | number |
| `outputTokens` Tokens received | number |
| `contextTokens` How much of the window the… | number |
| `contextWindow` How large that window is | number |
| `promptCache` When this conversation's prompt cache was… | object |
| `at` When its last request touched the… | number |
| `ttlMs` How long that entry lives from… | number |
| `rollsAt` When the date written into the… | number |
| `keepableUntil` Present when this sandbox can keep… | number |
| `keepWarm` Whether the sandbox is keeping this… | object |
| `since` When keeping it warm started, in… | number |
| `until` When it stops by itself, in… | number |
| `refreshes` Refreshes sent so far | integer |
| `readTokens` How much the last refresh read… | number |
| `ended` Why keeping it warm stopped before… | object |
| `at` When it stopped, in milliseconds | number |
| `reason` Why: `elapsed` the time asked for… | "elapsed" | "allowance" | "changed" | "cold" … (5) |
| `detail` The specifics, when there are any:… | string |
| `activity` What it is doing at this… | object |
| `tool` The last tool it reached for | string |
| `target` What it reached for that tool… | string |
| `todo` The item on its own list… | string |
| `checklist` How far it is through its… | object |
| `done` Items it has completed | number |
| `total` Items on the list | number |
| `doing` Items it has marked in progress… | number |
| `landedMessageDraft` The whole story of this merge's… | object |
| `startedAt` When the drafting began, in milliseconds | number |
| `steps` Each model that was asked, in… | object[] |
| `provider` Which provider was asked | string |
| `model` Which of its models | string |
| `status` How this one went | "asking" | "answered" | "refused" | "skipped" |
| `at` When it started being asked, in… | number |
| `ms` How long it took | number |
| `reason` Why it refused, in its own… | string |
| `outcome` How it ended | "written" | "failed" |
| `reason` The one-line account of a failure,… | string |
| `finishedAt` When it ended, in milliseconds | number |
| `landedMessage` What this conversation's merged work is… | object |
| `subject` One line saying what the merged… | string |
| `note` The same change said to somebody… | string |
| `breaking` What this change takes away, for… | string |
| `testNote` Why a test this change weakened… | string |
| `allows` Exceptions the conversation declared for this… | string[] |
| `startedAt` When the running turn started, in… | number |
| `run` The run under way right now:… | string |
| `queue` Messages waiting for its next turn,… | object |
| `items` What waits, in the order it… | object[] |
| `id` The message's id: what its sender… | string |
| `text` The words, as they will go… | string |
| `attachments` Files that go with it, as… | string[] |
| `voice` Who it is from: a person,… | "person" | "sandbox" | "agent" |
| `queuedAt` When it joined the queue, in… | number |
| `revision` The queue's revision when this message… | integer |
| `until` When this message goes out by… | number |
| `after` The conversation whose finished work must… | string |
| `afterTurn` Says `after` waits for that conversation's… | true |
| `reopenOf` The allowance this message's `until` waits… | object |
| `agent` The provider whose allowance it waits… | string |
| `account` Which of its accounts | string |
| `trialRetry` Says `until` is the sandbox sending… | object |
| `made` Which automatic try this booking is,… | integer |
| `max` How many automatic tries the sandbox… | integer |
| `serves` Who serves the turn this message… | object |
| `agent` The provider | string |
| `harness` The agentic loop | "native" | "claude-code" | "codex" | "opencode" … (7) |
| `model` The model | string |
| `effort` How hard it thinks, where the… | string |
| `account` The account that pays for it | string |
| `continues` A continuation, not words: when it… | true |
| `revision` Moves with every change to the… | integer |
| `paused` Why the messages with no booking… | "stopped" | "refused" | "scheduled" |
| `until` The soonest booked message's time, in… | number |
| `after` The conversation the first booked message… | string |
| `updatedAt` When it last did something, in… | number |
| `answeredAt` When its model provider last answered… | number |
| `seenAt` When somebody last opened it, in… | number |
| `unsentAt` Since when somebody's composer has held… | number |
| `attention` Which kinds of waiting-for-you it is… | object |
| `plan` It has proposed a plan and… | boolean |
| `question` It has asked you something | boolean |
| `permission` It wants to use a tool… | boolean |
| `capability` It needs something connected that is… | boolean |
| `credential` It is waiting for a named… | boolean |
| `conflict` Its work cannot be merged without… | boolean |
| `need` It asked a person for something… | boolean |
| `permissionAsk` The oldest permission its running turn… | object |
| `requestId` Which request this is: the id… | string |
| `ask` What it asks to do, on… | string |
| `program` The program it is holding, as… | object |
| `text` What would run | string |
| `language` Which of the two backends it… | "bash" | "javascript" |
| `truncated` Whether this is an excerpt of… | boolean |
| `spans` Which fragments of the text the… | object[] |
| `start` | integer |
| `end` | integer |
| `landFailure` The last attempt to bring its… | object |
| `reason` Why it failed, in the words… | string |
| `code` Which kind of failure it was,… | string |
| `at` When it failed, in milliseconds | number |
| `delivery` What became of its last land… | object |
| `state` | "delivered" | "partial" | "waiting" | "failed" … (5) |
| `at` When this state was reached, in… | number |
| `project` | string |
| `folder` The folder on the owner's computer,… | string |
| `applied` Files written, merged ones included | integer |
| `conflicts` | object[] |
| `path` | string |
| `reason` | "edited" | "link" | "outside" | "missing-git" |
| `point` The machine's restore point taken before… | string |
| `reason` Why it failed or waits, in… | string |
| `conflictCauses` Why its work will not merge,… | "workspace" | "diverged" | "binary"[] |
| `unfinished` What its last turn left open:… | object |
| `at` When the turn that left this… | number |
| `steps` The agent's own checklist where that… | object |
| `open` Items on it that were never… | number |
| `total` Items on the whole list | number |
| `next` The one it would have done… | string |
| `check` The end-of-turn check that was still… | string |
| `proof` What its last turn showed of… | object |
| `at` When the turn that left this… | number |
| `verification` Verified: a check it ran passed… | "verified" | "unproven" | "failing" | "no-code" |
| `check` The command that spoke, when one… | string |
| `unviewed` How many rendered files it changed… | number |
| `review` The latest code review this conversation… | object |
| `at` When the turn that reported it… | number |
| `source` Which harness's reviewer reported it | "claude" | "codex" |
| `findings` How many findings it reported | integer |
| `open` How many of those no re-report… | integer |
| `reach` Where its last turn's work went… | object |
| `at` When the turn that left this… | number |
| `live` Files it changed in place where… | object[] |
| `path` What it wrote, as it named… | string |
| `extension` The extension, by its manifest id,… | string |
| `liveMore` How many more such files there… | number |
| `stranded` Repositories it cloned inside its own… | object[] |
| `dir` The clone, as a folder relative… | string |
| `uncommitted` Files changed in it and never… | number |
| `unpushed` Commits in it its upstream does… | number |
| `commits` Commits it holds at all, 0… | number |
| `parent` The workspace repository it sits inside,… | string |
| `strandedMore` How many more such clones there… | number |
| `published` Pushes it made with git that… | object[] |
| `dir` The folder it pushed from, as… | string |
| `remote` The remote it pushed to, as… | string |
| `branch` The branch it pushed to, as… | string |
| `command` The push itself, trimmed to one… | string |
| `publishedMore` How many more such pushes there… | number |
| `turns` Turns it has finished | number |
| `toolUses` Tools it has used, over its… | number |
| `subagents` Subagents this one started, in-process and… | object |
| `running` Subagents working right now | number |
| `total` Subagents it has started over its… | number |
| `diff` Everything it has written, measured from… | object |
| `files` Files touched | number |
| `insertions` Lines added | number |
| `deletions` Lines removed | number |
| `modules` The packages its changes fall in,… | string[] |
| `landedPresence` Present only when some of what… | object |
| `landed` Paths this conversation merged in | number |
| `present` How many of them are still… | number |
| `removedBy` Who took them out, when the… | object |
| `when kind is "agent"` | shape |
| `id` The conversation that took them out | string |
| `title` What that conversation is called | string |
| `when kind is "person"` | shape |
| `email` Who it was, as the sandbox… | string |
| `name` What to call them, when their… | string |
| `loop` The loop driving this conversation, if… | object |
| `state` How the loop is going | "running" | "done" | "exhausted" | "stalled" … (8) |
| `iteration` Which round it is on | integer |
| `maxIterations` How many rounds it will attempt… | integer |
| `goal` What it is looping towards | string |
| `workflow` The workflow run this conversation is… | object |
| `runId` The run this belongs to, which… | string |
| `name` The workflow's name | string |
| `step` Which step this conversation is on… | string |
| `index` This step's place in the workflow,… | integer |
| `total` How many steps the workflow has | integer |
| `awaitingWake` Whether this conversation runs again by… | boolean |
| `watches` Outside conditions this conversation is parked… | object[] |
| `id` The daemon's handle for this watch,… | string |
| `note` The agent's own line on what… | string |
| `intervalSeconds` How often the check runs | integer |
| `deadlineAt` When it gives up and wakes… | number |
| `needs` What it is waiting on people… | object[] |
| `id` | string |
| `kind` What is being asked for: a… | "capability" | "secret" | "grant" | "release" … (8) |
| `title` | string |
| `status` Where it stands: open (waiting on… | "open" | "working" | "met" | "declined" … (5) |
| `jobs` Commands this conversation left running in… | object[] |
| `id` The daemon's handle for this job,… | string |
| `label` What the job is, in the… | string |
| `session` The terminal session its pane runs… | string |
| `startedAt` When it started, in milliseconds | number |
| `endedAt` When the command exited, in milliseconds | number |
| `exitCode` The code it exited with | integer |
| `watch` The watch its exit wakes this… | string |
| `handed` Left running for the person: the… | boolean |
| `ports` The ports it was listening on… | integer[] |
| `stoppedBy` Who stopped it: the sandbox, when… | "turn" | "person" | "agent" |
| `inputWait` Present while it sits blocked reading… | object |
| `since` When it went still, in milliseconds | number |
| `program` The process blocked reading the terminal,… | string |
| `scriptRuns` Workflow runs this conversation started that… | object[] |
| `id` The run's id, the one its… | string |
| `name` The workflow's name, from its script's… | string |
| `calls` How many subagents it has started… | integer |
| `working` How many of its subagents are… | integer |
| `failed` How many of its calls failed… | integer |
| `phase` The phase its script last marked | string |
| `startedAt` When it started, in milliseconds | number |
| `archivedAt` When it was put away, in… | number |

Try it answered in this tab

curl

```bash
curl -X POST "$SANDBOX/seal/a1b2c3d4/open/approve" \
 -H "x-intentic-control: $INTENTIC_TOKEN" \
 -H "content-type: application/json" \
 -d '{"open":"…","agree":true}'
```

TypeScript

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

const result = await sandbox.seal.approveOpen({
 "id": "a1b2c3d4",
 "open": "…",
 "agree": true
});
```

More in The workspace

[Previous ← Access profiles](https://intentic.dev/api/accessProfiles/)[Next Services →](https://intentic.dev/api/services/)
