intentic
Download the app
Download the app
The workspace

Private conversations

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

On this page(8 sections)

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/sealWho 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

FieldType
modeThe house rule: who reads whose…"everyone" | "chooses" | "private"
lockedWhether the sandbox's organisation fixed the…boolean
twoPersonWhether opening a private conversation without…boolean
hostedWhether intentic runs this sandbox, so…boolean
sealedHow many conversations are private right…integer
startsPrivateWhether a conversation the caller starts…boolean
ownDefaultThe caller's own answer to whether…boolean
Try itanswered in this tab
curl
curl "$SANDBOX/seal" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.seal.house();
POST/seal/houseSet 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

FieldTypeWhere
moderequired"everyone" | "chooses" | "private"body

What comes back

FieldType
modeThe house rule: who reads whose…"everyone" | "chooses" | "private"
lockedWhether the sandbox's organisation fixed the…boolean
twoPersonWhether opening a private conversation without…boolean
hostedWhether intentic runs this sandbox, so…boolean
sealedHow many conversations are private right…integer
startsPrivateWhether a conversation the caller starts…boolean
ownDefaultThe caller's own answer to whether…boolean
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/seal/house" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"mode":"everyone"}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.seal.setHouse({
  "mode": "everyone"
});
POST/seal/defaultStart 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

FieldTypeWhere
privaterequiredWhether the caller's new conversations start…booleanbody

What comes back

FieldType
modeThe house rule: who reads whose…"everyone" | "chooses" | "private"
lockedWhether the sandbox's organisation fixed the…boolean
twoPersonWhether opening a private conversation without…boolean
hostedWhether intentic runs this sandbox, so…boolean
sealedHow many conversations are private right…integer
startsPrivateWhether a conversation the caller starts…boolean
ownDefaultThe caller's own answer to whether…boolean
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/seal/default" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"private":true}'
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

FieldTypeWhere
idrequiredThe conversationstringaddress
privaterequiredbooleanbody
readersWho besides its author may read…string[]body

What comes back

FieldType
idThe conversation id, which is how…string
sessionIdThe provider session behind the last…string
titleWhat to call it: the first…string
titleActionOne word for the kind of…string
statusWhat it is doing"idle" | "running" | "awaiting" | "stopping" … (13)
failureWhy the last turn failed, in…string
failureCodeWhich kind of failure it was,…string
failureOwnWhether `failure` is the sandbox's own…boolean
failureRepeatsHow many turns in a row…integer
limitResetsAtWhen the spent allowance reopens, in…number
limitHeldWhether the refused turn is held…boolean
limitScheduledSent only by sandboxes older than…boolean
limitMovingSent only by sandboxes older than…string
limitNextAtSent only by sandboxes older than…number
nextWhat carries it on next with…object
when kind is "rerun"shape
atWhen the held turn goes again,…number
ontoThe account the owner's answer to…string
when kind is "room"shape
when kind is "send"shape
atWhen the soonest booked message goes,…number
countHow many messages are booked to…integer
when kind is "land"shape
afterThe conversation whose landed work the…string
turnSet when that message waits for…true
countHow many messages are booked to…integer
pressThe daemon's one reading of what…object
when kind is "none"shape
when kind is "continue"shape
endingHow the last turn ended, which…object
reasonWhich ending left the work here:…"limit" | "outage" | "stopped" | "flagged"
resetsAtWhen the spent allowance reopens, in…number
heldPresent when the daemon still holds…object
scheduledWhether something other than the user…boolean
nextAtWhen the booked send actually fires,…number
retriesHow many automatic re-runs a stopped…object
providerWhich model provider it runs onstring
harnessWhich agentic loop it runs on"native" | "claude-code" | "codex" | "opencode" … (7)
runnerThe runner this conversation runs onstring
startInWhich folder it opened in, relative…string
actsAsWhich role its first turn acted…string
lastActsAsWhich role its last turn acted…string
modelWhat its last turn ran withstring
effortHow hard that turn was told…string
thinkingWhether that turn showed its reasoningboolean
fastWhether that turn asked for higher…boolean
accountWhich connected account paid for itstring
branchThe branch its private copy works…string
autoLandThis conversation's own answer to whether…boolean
limitPolicy"wait" | "resend" | "move"
outagePolicy"wait" | "retry"
stopPolicy"wait" | "retry"
memoryPolicy"wait" | "resend"
memoryKillPolicyThis conversation's own answer to a…"wait" | "resume"
proceedWithoutAskingThis conversation's own answer to whether…boolean
autoApproveWhether every permission this conversation asks…"own" | "inherited"
landRequestedA collaborator has asked a maintainer…object
emailWho askedstring
nameTheir display namestring
atWhen they asked, in millisecondsnumber
reactionsWhat people have marked this conversation…object[]
emojiThe mark itself, one emoji, carried…string
byEveryone wearing this mark, oldest first,…object[]
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
atWhen they marked it, in millisecondsnumber
originWhere the conversation came from when…object
automationIdstring
providerstring
channelIdstring
threadIdstring
authorstring
startedByWho asked for the first turn,…string
areasWhich named areas of the workspace…string[]
ownerThe member answerable for this conversation:…object
emailWho answers for this conversation, as…string
nameWhat to call them, when the…string
sinceWhen they became its owner, in…number
participantsThe people who took part in…object[]
emailWho took part, lowercased, as the…string
nameWhat to call them, when their…string
sinceWhen they first took part, in…number
viaHow they first took part: they…"prompt" | "answer" | "land" | "mention"
notifyYour own answer to how much…object[]
emailWhose answer it is, lowercasedstring
levelWhat they asked to hear of…"all" | "asks" | "none"
atWhen they chose it, in millisecondsnumber
forkedFromThe conversation this one was cut…object
conversationIdstring
indexinteger
files"then" | "now"
freshSet on a conversation started on…object
ofThe conversation whose work it started…string
kindWhat it was opened for: a…"review" | "test" | "ask"
atWhen it started, in millisecondsnumber
byThe agent that opened it, when…string
branchesThe branches this conversation was started…object[]
repoWhich repositorystring
branchThe branch, by its short name:…string
sealSet on a private conversation: how…object
sealedThe caller cannot read this conversation:…true
viaHow the caller reads it"reader" | "grant" | "open"
untilUntil when the caller may read…number
readersobject[]
emailstring
namestring
grantsobject[]
emailstring
namestring
untilUntil when they may read it,…number
byWho let them, by addressstring
asksobject[]
emailstring
namestring
atnumber
opensobject[]
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
askedOn a sealed card: the caller…true
pendingAn opening without asking that waits…object
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
canOpenOn a sealed card: the caller…true
canApproveThe caller may agree to the…true
homeThis is its owner's home conversation…true
commitsA home conversation's latest lands as…object[]
landThe land's id, as its `landed`…string
atWhen it was committed, in millisecondsnumber
subjectThe commit's subject linestring
commitsThe commit each repository the land…object[]
repoWhich repository: "root" for the workspace…string
shaThe commit, in fullstring
freshPendingA home conversation whose next message…"asked" | "cleared"
baseThe commit its private copy started…string
costUsdWhat it has cost so far,…number
inputTokensUncached input tokens, excluding cache reads…number
outputTokensTokens receivednumber
contextTokensHow much of the window the…number
contextWindowHow large that window isnumber
promptCacheWhen this conversation's prompt cache was…object
atWhen its last request touched the…number
ttlMsHow long that entry lives from…number
rollsAtWhen the date written into the…number
keepableUntilPresent when this sandbox can keep…number
keepWarmWhether the sandbox is keeping this…object
sinceWhen keeping it warm started, in…number
untilWhen it stops by itself, in…number
refreshesRefreshes sent so farinteger
readTokensHow much the last refresh read…number
endedWhy keeping it warm stopped before…object
atWhen it stopped, in millisecondsnumber
reasonWhy: `elapsed` the time asked for…"elapsed" | "allowance" | "changed" | "cold" … (5)
detailThe specifics, when there are any:…string
activityWhat it is doing at this…object
toolThe last tool it reached forstring
targetWhat it reached for that tool…string
todoThe item on its own list…string
checklistHow far it is through its…object
doneItems it has completednumber
totalItems on the listnumber
doingItems it has marked in progress…number
landedMessageDraftThe whole story of this merge's…object
startedAtWhen the drafting began, in millisecondsnumber
stepsEach model that was asked, in…object[]
providerWhich provider was askedstring
modelWhich of its modelsstring
statusHow this one went"asking" | "answered" | "refused" | "skipped"
atWhen it started being asked, in…number
msHow long it tooknumber
reasonWhy it refused, in its own…string
outcomeHow it ended"written" | "failed"
reasonThe one-line account of a failure,…string
finishedAtWhen it ended, in millisecondsnumber
landedMessageWhat this conversation's merged work is…object
subjectOne line saying what the merged…string
noteThe same change said to somebody…string
breakingWhat this change takes away, for…string
testNoteWhy a test this change weakened…string
allowsExceptions the conversation declared for this…string[]
startedAtWhen the running turn started, in…number
runThe run under way right now:…string
queueMessages waiting for its next turn,…object
itemsWhat waits, in the order it…object[]
idThe message's id: what its sender…string
textThe words, as they will go…string
attachmentsFiles that go with it, as…string[]
voiceWho it is from: a person,…"person" | "sandbox" | "agent"
queuedAtWhen it joined the queue, in…number
revisionThe queue's revision when this message…integer
untilWhen this message goes out by…number
afterThe conversation whose finished work must…string
afterTurnSays `after` waits for that conversation's…true
reopenOfThe allowance this message's `until` waits…object
agentThe provider whose allowance it waits…string
accountWhich of its accountsstring
trialRetrySays `until` is the sandbox sending…object
madeWhich automatic try this booking is,…integer
maxHow many automatic tries the sandbox…integer
servesWho serves the turn this message…object
agentThe providerstring
harnessThe agentic loop"native" | "claude-code" | "codex" | "opencode" … (7)
modelThe modelstring
effortHow hard it thinks, where the…string
accountThe account that pays for itstring
continuesA continuation, not words: when it…true
revisionMoves with every change to the…integer
pausedWhy the messages with no booking…"stopped" | "refused" | "scheduled"
untilThe soonest booked message's time, in…number
afterThe conversation the first booked message…string
updatedAtWhen it last did something, in…number
answeredAtWhen its model provider last answered…number
seenAtWhen somebody last opened it, in…number
unsentAtSince when somebody's composer has held…number
attentionWhich kinds of waiting-for-you it is…object
planIt has proposed a plan and…boolean
questionIt has asked you somethingboolean
permissionIt wants to use a tool…boolean
capabilityIt needs something connected that is…boolean
credentialIt is waiting for a named…boolean
conflictIts work cannot be merged without…boolean
needIt asked a person for something…boolean
permissionAskThe oldest permission its running turn…object
requestIdWhich request this is: the id…string
askWhat it asks to do, on…string
programThe program it is holding, as…object
textWhat would runstring
languageWhich of the two backends it…"bash" | "javascript"
truncatedWhether this is an excerpt of…boolean
spansWhich fragments of the text the…object[]
startinteger
endinteger
landFailureThe last attempt to bring its…object
reasonWhy it failed, in the words…string
codeWhich kind of failure it was,…string
atWhen it failed, in millisecondsnumber
deliveryWhat became of its last land…object
state"delivered" | "partial" | "waiting" | "failed" … (5)
atWhen this state was reached, in…number
projectstring
folderThe folder on the owner's computer,…string
appliedFiles written, merged ones includedinteger
conflictsobject[]
pathstring
reason"edited" | "link" | "outside" | "missing-git"
pointThe machine's restore point taken before…string
reasonWhy it failed or waits, in…string
conflictCausesWhy its work will not merge,…"workspace" | "diverged" | "binary"[]
unfinishedWhat its last turn left open:…object
atWhen the turn that left this…number
stepsThe agent's own checklist where that…object
openItems on it that were never…number
totalItems on the whole listnumber
nextThe one it would have done…string
checkThe end-of-turn check that was still…string
proofWhat its last turn showed of…object
atWhen the turn that left this…number
verificationVerified: a check it ran passed…"verified" | "unproven" | "failing" | "no-code"
checkThe command that spoke, when one…string
unviewedHow many rendered files it changed…number
reviewThe latest code review this conversation…object
atWhen the turn that reported it…number
sourceWhich harness's reviewer reported it"claude" | "codex"
findingsHow many findings it reportedinteger
openHow many of those no re-report…integer
reachWhere its last turn's work went…object
atWhen the turn that left this…number
liveFiles it changed in place where…object[]
pathWhat it wrote, as it named…string
extensionThe extension, by its manifest id,…string
liveMoreHow many more such files there…number
strandedRepositories it cloned inside its own…object[]
dirThe clone, as a folder relative…string
uncommittedFiles changed in it and never…number
unpushedCommits in it its upstream does…number
commitsCommits it holds at all, 0…number
parentThe workspace repository it sits inside,…string
strandedMoreHow many more such clones there…number
publishedPushes it made with git that…object[]
dirThe folder it pushed from, as…string
remoteThe remote it pushed to, as…string
branchThe branch it pushed to, as…string
commandThe push itself, trimmed to one…string
publishedMoreHow many more such pushes there…number
turnsTurns it has finishednumber
toolUsesTools it has used, over its…number
subagentsSubagents this one started, in-process and…object
runningSubagents working right nownumber
totalSubagents it has started over its…number
diffEverything it has written, measured from…object
filesFiles touchednumber
insertionsLines addednumber
deletionsLines removednumber
modulesThe packages its changes fall in,…string[]
landedPresencePresent only when some of what…object
landedPaths this conversation merged innumber
presentHow many of them are still…number
removedByWho took them out, when the…object
when kind is "agent"shape
idThe conversation that took them outstring
titleWhat that conversation is calledstring
when kind is "person"shape
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
loopThe loop driving this conversation, if…object
stateHow the loop is going"running" | "done" | "exhausted" | "stalled" … (8)
iterationWhich round it is oninteger
maxIterationsHow many rounds it will attempt…integer
goalWhat it is looping towardsstring
workflowThe workflow run this conversation is…object
runIdThe run this belongs to, which…string
nameThe workflow's namestring
stepWhich step this conversation is on…string
indexThis step's place in the workflow,…integer
totalHow many steps the workflow hasinteger
awaitingWakeWhether this conversation runs again by…boolean
watchesOutside conditions this conversation is parked…object[]
idThe daemon's handle for this watch,…string
noteThe agent's own line on what…string
intervalSecondsHow often the check runsinteger
deadlineAtWhen it gives up and wakes…number
needsWhat it is waiting on people…object[]
idstring
kindWhat is being asked for: a…"capability" | "secret" | "grant" | "release" … (8)
titlestring
statusWhere it stands: open (waiting on…"open" | "working" | "met" | "declined" … (5)
jobsCommands this conversation left running in…object[]
idThe daemon's handle for this job,…string
labelWhat the job is, in the…string
sessionThe terminal session its pane runs…string
startedAtWhen it started, in millisecondsnumber
endedAtWhen the command exited, in millisecondsnumber
exitCodeThe code it exited withinteger
watchThe watch its exit wakes this…string
handedLeft running for the person: the…boolean
portsThe ports it was listening on…integer[]
stoppedByWho stopped it: the sandbox, when…"turn" | "person" | "agent"
inputWaitPresent while it sits blocked reading…object
sinceWhen it went still, in millisecondsnumber
programThe process blocked reading the terminal,…string
scriptRunsWorkflow runs this conversation started that…object[]
idThe run's id, the one its…string
nameThe workflow's name, from its script's…string
callsHow many subagents it has started…integer
workingHow many of its subagents are…integer
failedHow many of its calls failed…integer
phaseThe phase its script last markedstring
startedAtWhen it started, in millisecondsnumber
archivedAtWhen it was put away, in…number
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/seal/a1b2c3d4" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"private":true,"readers":["…","…"]}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.seal.set({
  "id": "a1b2c3d4",
  "private": true,
  "readers": [
    "…",
    "…"
  ]
});
POST/seal/{id}/askAsk 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

FieldTypeWhere
idrequiredThe conversationstringaddress

What comes back

FieldType
idThe conversation id, which is how…string
sessionIdThe provider session behind the last…string
titleWhat to call it: the first…string
titleActionOne word for the kind of…string
statusWhat it is doing"idle" | "running" | "awaiting" | "stopping" … (13)
failureWhy the last turn failed, in…string
failureCodeWhich kind of failure it was,…string
failureOwnWhether `failure` is the sandbox's own…boolean
failureRepeatsHow many turns in a row…integer
limitResetsAtWhen the spent allowance reopens, in…number
limitHeldWhether the refused turn is held…boolean
limitScheduledSent only by sandboxes older than…boolean
limitMovingSent only by sandboxes older than…string
limitNextAtSent only by sandboxes older than…number
nextWhat carries it on next with…object
when kind is "rerun"shape
atWhen the held turn goes again,…number
ontoThe account the owner's answer to…string
when kind is "room"shape
when kind is "send"shape
atWhen the soonest booked message goes,…number
countHow many messages are booked to…integer
when kind is "land"shape
afterThe conversation whose landed work the…string
turnSet when that message waits for…true
countHow many messages are booked to…integer
pressThe daemon's one reading of what…object
when kind is "none"shape
when kind is "continue"shape
endingHow the last turn ended, which…object
reasonWhich ending left the work here:…"limit" | "outage" | "stopped" | "flagged"
resetsAtWhen the spent allowance reopens, in…number
heldPresent when the daemon still holds…object
scheduledWhether something other than the user…boolean
nextAtWhen the booked send actually fires,…number
retriesHow many automatic re-runs a stopped…object
providerWhich model provider it runs onstring
harnessWhich agentic loop it runs on"native" | "claude-code" | "codex" | "opencode" … (7)
runnerThe runner this conversation runs onstring
startInWhich folder it opened in, relative…string
actsAsWhich role its first turn acted…string
lastActsAsWhich role its last turn acted…string
modelWhat its last turn ran withstring
effortHow hard that turn was told…string
thinkingWhether that turn showed its reasoningboolean
fastWhether that turn asked for higher…boolean
accountWhich connected account paid for itstring
branchThe branch its private copy works…string
autoLandThis conversation's own answer to whether…boolean
limitPolicy"wait" | "resend" | "move"
outagePolicy"wait" | "retry"
stopPolicy"wait" | "retry"
memoryPolicy"wait" | "resend"
memoryKillPolicyThis conversation's own answer to a…"wait" | "resume"
proceedWithoutAskingThis conversation's own answer to whether…boolean
autoApproveWhether every permission this conversation asks…"own" | "inherited"
landRequestedA collaborator has asked a maintainer…object
emailWho askedstring
nameTheir display namestring
atWhen they asked, in millisecondsnumber
reactionsWhat people have marked this conversation…object[]
emojiThe mark itself, one emoji, carried…string
byEveryone wearing this mark, oldest first,…object[]
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
atWhen they marked it, in millisecondsnumber
originWhere the conversation came from when…object
automationIdstring
providerstring
channelIdstring
threadIdstring
authorstring
startedByWho asked for the first turn,…string
areasWhich named areas of the workspace…string[]
ownerThe member answerable for this conversation:…object
emailWho answers for this conversation, as…string
nameWhat to call them, when the…string
sinceWhen they became its owner, in…number
participantsThe people who took part in…object[]
emailWho took part, lowercased, as the…string
nameWhat to call them, when their…string
sinceWhen they first took part, in…number
viaHow they first took part: they…"prompt" | "answer" | "land" | "mention"
notifyYour own answer to how much…object[]
emailWhose answer it is, lowercasedstring
levelWhat they asked to hear of…"all" | "asks" | "none"
atWhen they chose it, in millisecondsnumber
forkedFromThe conversation this one was cut…object
conversationIdstring
indexinteger
files"then" | "now"
freshSet on a conversation started on…object
ofThe conversation whose work it started…string
kindWhat it was opened for: a…"review" | "test" | "ask"
atWhen it started, in millisecondsnumber
byThe agent that opened it, when…string
branchesThe branches this conversation was started…object[]
repoWhich repositorystring
branchThe branch, by its short name:…string
sealSet on a private conversation: how…object
sealedThe caller cannot read this conversation:…true
viaHow the caller reads it"reader" | "grant" | "open"
untilUntil when the caller may read…number
readersobject[]
emailstring
namestring
grantsobject[]
emailstring
namestring
untilUntil when they may read it,…number
byWho let them, by addressstring
asksobject[]
emailstring
namestring
atnumber
opensobject[]
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
askedOn a sealed card: the caller…true
pendingAn opening without asking that waits…object
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
canOpenOn a sealed card: the caller…true
canApproveThe caller may agree to the…true
homeThis is its owner's home conversation…true
commitsA home conversation's latest lands as…object[]
landThe land's id, as its `landed`…string
atWhen it was committed, in millisecondsnumber
subjectThe commit's subject linestring
commitsThe commit each repository the land…object[]
repoWhich repository: "root" for the workspace…string
shaThe commit, in fullstring
freshPendingA home conversation whose next message…"asked" | "cleared"
baseThe commit its private copy started…string
costUsdWhat it has cost so far,…number
inputTokensUncached input tokens, excluding cache reads…number
outputTokensTokens receivednumber
contextTokensHow much of the window the…number
contextWindowHow large that window isnumber
promptCacheWhen this conversation's prompt cache was…object
atWhen its last request touched the…number
ttlMsHow long that entry lives from…number
rollsAtWhen the date written into the…number
keepableUntilPresent when this sandbox can keep…number
keepWarmWhether the sandbox is keeping this…object
sinceWhen keeping it warm started, in…number
untilWhen it stops by itself, in…number
refreshesRefreshes sent so farinteger
readTokensHow much the last refresh read…number
endedWhy keeping it warm stopped before…object
atWhen it stopped, in millisecondsnumber
reasonWhy: `elapsed` the time asked for…"elapsed" | "allowance" | "changed" | "cold" … (5)
detailThe specifics, when there are any:…string
activityWhat it is doing at this…object
toolThe last tool it reached forstring
targetWhat it reached for that tool…string
todoThe item on its own list…string
checklistHow far it is through its…object
doneItems it has completednumber
totalItems on the listnumber
doingItems it has marked in progress…number
landedMessageDraftThe whole story of this merge's…object
startedAtWhen the drafting began, in millisecondsnumber
stepsEach model that was asked, in…object[]
providerWhich provider was askedstring
modelWhich of its modelsstring
statusHow this one went"asking" | "answered" | "refused" | "skipped"
atWhen it started being asked, in…number
msHow long it tooknumber
reasonWhy it refused, in its own…string
outcomeHow it ended"written" | "failed"
reasonThe one-line account of a failure,…string
finishedAtWhen it ended, in millisecondsnumber
landedMessageWhat this conversation's merged work is…object
subjectOne line saying what the merged…string
noteThe same change said to somebody…string
breakingWhat this change takes away, for…string
testNoteWhy a test this change weakened…string
allowsExceptions the conversation declared for this…string[]
startedAtWhen the running turn started, in…number
runThe run under way right now:…string
queueMessages waiting for its next turn,…object
itemsWhat waits, in the order it…object[]
idThe message's id: what its sender…string
textThe words, as they will go…string
attachmentsFiles that go with it, as…string[]
voiceWho it is from: a person,…"person" | "sandbox" | "agent"
queuedAtWhen it joined the queue, in…number
revisionThe queue's revision when this message…integer
untilWhen this message goes out by…number
afterThe conversation whose finished work must…string
afterTurnSays `after` waits for that conversation's…true
reopenOfThe allowance this message's `until` waits…object
agentThe provider whose allowance it waits…string
accountWhich of its accountsstring
trialRetrySays `until` is the sandbox sending…object
madeWhich automatic try this booking is,…integer
maxHow many automatic tries the sandbox…integer
servesWho serves the turn this message…object
agentThe providerstring
harnessThe agentic loop"native" | "claude-code" | "codex" | "opencode" … (7)
modelThe modelstring
effortHow hard it thinks, where the…string
accountThe account that pays for itstring
continuesA continuation, not words: when it…true
revisionMoves with every change to the…integer
pausedWhy the messages with no booking…"stopped" | "refused" | "scheduled"
untilThe soonest booked message's time, in…number
afterThe conversation the first booked message…string
updatedAtWhen it last did something, in…number
answeredAtWhen its model provider last answered…number
seenAtWhen somebody last opened it, in…number
unsentAtSince when somebody's composer has held…number
attentionWhich kinds of waiting-for-you it is…object
planIt has proposed a plan and…boolean
questionIt has asked you somethingboolean
permissionIt wants to use a tool…boolean
capabilityIt needs something connected that is…boolean
credentialIt is waiting for a named…boolean
conflictIts work cannot be merged without…boolean
needIt asked a person for something…boolean
permissionAskThe oldest permission its running turn…object
requestIdWhich request this is: the id…string
askWhat it asks to do, on…string
programThe program it is holding, as…object
textWhat would runstring
languageWhich of the two backends it…"bash" | "javascript"
truncatedWhether this is an excerpt of…boolean
spansWhich fragments of the text the…object[]
startinteger
endinteger
landFailureThe last attempt to bring its…object
reasonWhy it failed, in the words…string
codeWhich kind of failure it was,…string
atWhen it failed, in millisecondsnumber
deliveryWhat became of its last land…object
state"delivered" | "partial" | "waiting" | "failed" … (5)
atWhen this state was reached, in…number
projectstring
folderThe folder on the owner's computer,…string
appliedFiles written, merged ones includedinteger
conflictsobject[]
pathstring
reason"edited" | "link" | "outside" | "missing-git"
pointThe machine's restore point taken before…string
reasonWhy it failed or waits, in…string
conflictCausesWhy its work will not merge,…"workspace" | "diverged" | "binary"[]
unfinishedWhat its last turn left open:…object
atWhen the turn that left this…number
stepsThe agent's own checklist where that…object
openItems on it that were never…number
totalItems on the whole listnumber
nextThe one it would have done…string
checkThe end-of-turn check that was still…string
proofWhat its last turn showed of…object
atWhen the turn that left this…number
verificationVerified: a check it ran passed…"verified" | "unproven" | "failing" | "no-code"
checkThe command that spoke, when one…string
unviewedHow many rendered files it changed…number
reviewThe latest code review this conversation…object
atWhen the turn that reported it…number
sourceWhich harness's reviewer reported it"claude" | "codex"
findingsHow many findings it reportedinteger
openHow many of those no re-report…integer
reachWhere its last turn's work went…object
atWhen the turn that left this…number
liveFiles it changed in place where…object[]
pathWhat it wrote, as it named…string
extensionThe extension, by its manifest id,…string
liveMoreHow many more such files there…number
strandedRepositories it cloned inside its own…object[]
dirThe clone, as a folder relative…string
uncommittedFiles changed in it and never…number
unpushedCommits in it its upstream does…number
commitsCommits it holds at all, 0…number
parentThe workspace repository it sits inside,…string
strandedMoreHow many more such clones there…number
publishedPushes it made with git that…object[]
dirThe folder it pushed from, as…string
remoteThe remote it pushed to, as…string
branchThe branch it pushed to, as…string
commandThe push itself, trimmed to one…string
publishedMoreHow many more such pushes there…number
turnsTurns it has finishednumber
toolUsesTools it has used, over its…number
subagentsSubagents this one started, in-process and…object
runningSubagents working right nownumber
totalSubagents it has started over its…number
diffEverything it has written, measured from…object
filesFiles touchednumber
insertionsLines addednumber
deletionsLines removednumber
modulesThe packages its changes fall in,…string[]
landedPresencePresent only when some of what…object
landedPaths this conversation merged innumber
presentHow many of them are still…number
removedByWho took them out, when the…object
when kind is "agent"shape
idThe conversation that took them outstring
titleWhat that conversation is calledstring
when kind is "person"shape
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
loopThe loop driving this conversation, if…object
stateHow the loop is going"running" | "done" | "exhausted" | "stalled" … (8)
iterationWhich round it is oninteger
maxIterationsHow many rounds it will attempt…integer
goalWhat it is looping towardsstring
workflowThe workflow run this conversation is…object
runIdThe run this belongs to, which…string
nameThe workflow's namestring
stepWhich step this conversation is on…string
indexThis step's place in the workflow,…integer
totalHow many steps the workflow hasinteger
awaitingWakeWhether this conversation runs again by…boolean
watchesOutside conditions this conversation is parked…object[]
idThe daemon's handle for this watch,…string
noteThe agent's own line on what…string
intervalSecondsHow often the check runsinteger
deadlineAtWhen it gives up and wakes…number
needsWhat it is waiting on people…object[]
idstring
kindWhat is being asked for: a…"capability" | "secret" | "grant" | "release" … (8)
titlestring
statusWhere it stands: open (waiting on…"open" | "working" | "met" | "declined" … (5)
jobsCommands this conversation left running in…object[]
idThe daemon's handle for this job,…string
labelWhat the job is, in the…string
sessionThe terminal session its pane runs…string
startedAtWhen it started, in millisecondsnumber
endedAtWhen the command exited, in millisecondsnumber
exitCodeThe code it exited withinteger
watchThe watch its exit wakes this…string
handedLeft running for the person: the…boolean
portsThe ports it was listening on…integer[]
stoppedByWho stopped it: the sandbox, when…"turn" | "person" | "agent"
inputWaitPresent while it sits blocked reading…object
sinceWhen it went still, in millisecondsnumber
programThe process blocked reading the terminal,…string
scriptRunsWorkflow runs this conversation started that…object[]
idThe run's id, the one its…string
nameThe workflow's name, from its script's…string
callsHow many subagents it has started…integer
workingHow many of its subagents are…integer
failedHow many of its calls failed…integer
phaseThe phase its script last markedstring
startedAtWhen it started, in millisecondsnumber
archivedAtWhen it was put away, in…number
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/seal/a1b2c3d4/ask" \
  -H "x-intentic-control: $INTENTIC_TOKEN"
TypeScript
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.seal.ask({
  "id": "a1b2c3d4"
});
POST/seal/{id}/answerAnswer 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

FieldTypeWhere
idrequiredThe conversationstringaddress
emailrequiredWhose ask this answersstringbody
answerrequiredShow it to them for a…"day" | "always" | "decline"body

What comes back

FieldType
idThe conversation id, which is how…string
sessionIdThe provider session behind the last…string
titleWhat to call it: the first…string
titleActionOne word for the kind of…string
statusWhat it is doing"idle" | "running" | "awaiting" | "stopping" … (13)
failureWhy the last turn failed, in…string
failureCodeWhich kind of failure it was,…string
failureOwnWhether `failure` is the sandbox's own…boolean
failureRepeatsHow many turns in a row…integer
limitResetsAtWhen the spent allowance reopens, in…number
limitHeldWhether the refused turn is held…boolean
limitScheduledSent only by sandboxes older than…boolean
limitMovingSent only by sandboxes older than…string
limitNextAtSent only by sandboxes older than…number
nextWhat carries it on next with…object
when kind is "rerun"shape
atWhen the held turn goes again,…number
ontoThe account the owner's answer to…string
when kind is "room"shape
when kind is "send"shape
atWhen the soonest booked message goes,…number
countHow many messages are booked to…integer
when kind is "land"shape
afterThe conversation whose landed work the…string
turnSet when that message waits for…true
countHow many messages are booked to…integer
pressThe daemon's one reading of what…object
when kind is "none"shape
when kind is "continue"shape
endingHow the last turn ended, which…object
reasonWhich ending left the work here:…"limit" | "outage" | "stopped" | "flagged"
resetsAtWhen the spent allowance reopens, in…number
heldPresent when the daemon still holds…object
scheduledWhether something other than the user…boolean
nextAtWhen the booked send actually fires,…number
retriesHow many automatic re-runs a stopped…object
providerWhich model provider it runs onstring
harnessWhich agentic loop it runs on"native" | "claude-code" | "codex" | "opencode" … (7)
runnerThe runner this conversation runs onstring
startInWhich folder it opened in, relative…string
actsAsWhich role its first turn acted…string
lastActsAsWhich role its last turn acted…string
modelWhat its last turn ran withstring
effortHow hard that turn was told…string
thinkingWhether that turn showed its reasoningboolean
fastWhether that turn asked for higher…boolean
accountWhich connected account paid for itstring
branchThe branch its private copy works…string
autoLandThis conversation's own answer to whether…boolean
limitPolicy"wait" | "resend" | "move"
outagePolicy"wait" | "retry"
stopPolicy"wait" | "retry"
memoryPolicy"wait" | "resend"
memoryKillPolicyThis conversation's own answer to a…"wait" | "resume"
proceedWithoutAskingThis conversation's own answer to whether…boolean
autoApproveWhether every permission this conversation asks…"own" | "inherited"
landRequestedA collaborator has asked a maintainer…object
emailWho askedstring
nameTheir display namestring
atWhen they asked, in millisecondsnumber
reactionsWhat people have marked this conversation…object[]
emojiThe mark itself, one emoji, carried…string
byEveryone wearing this mark, oldest first,…object[]
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
atWhen they marked it, in millisecondsnumber
originWhere the conversation came from when…object
automationIdstring
providerstring
channelIdstring
threadIdstring
authorstring
startedByWho asked for the first turn,…string
areasWhich named areas of the workspace…string[]
ownerThe member answerable for this conversation:…object
emailWho answers for this conversation, as…string
nameWhat to call them, when the…string
sinceWhen they became its owner, in…number
participantsThe people who took part in…object[]
emailWho took part, lowercased, as the…string
nameWhat to call them, when their…string
sinceWhen they first took part, in…number
viaHow they first took part: they…"prompt" | "answer" | "land" | "mention"
notifyYour own answer to how much…object[]
emailWhose answer it is, lowercasedstring
levelWhat they asked to hear of…"all" | "asks" | "none"
atWhen they chose it, in millisecondsnumber
forkedFromThe conversation this one was cut…object
conversationIdstring
indexinteger
files"then" | "now"
freshSet on a conversation started on…object
ofThe conversation whose work it started…string
kindWhat it was opened for: a…"review" | "test" | "ask"
atWhen it started, in millisecondsnumber
byThe agent that opened it, when…string
branchesThe branches this conversation was started…object[]
repoWhich repositorystring
branchThe branch, by its short name:…string
sealSet on a private conversation: how…object
sealedThe caller cannot read this conversation:…true
viaHow the caller reads it"reader" | "grant" | "open"
untilUntil when the caller may read…number
readersobject[]
emailstring
namestring
grantsobject[]
emailstring
namestring
untilUntil when they may read it,…number
byWho let them, by addressstring
asksobject[]
emailstring
namestring
atnumber
opensobject[]
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
askedOn a sealed card: the caller…true
pendingAn opening without asking that waits…object
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
canOpenOn a sealed card: the caller…true
canApproveThe caller may agree to the…true
homeThis is its owner's home conversation…true
commitsA home conversation's latest lands as…object[]
landThe land's id, as its `landed`…string
atWhen it was committed, in millisecondsnumber
subjectThe commit's subject linestring
commitsThe commit each repository the land…object[]
repoWhich repository: "root" for the workspace…string
shaThe commit, in fullstring
freshPendingA home conversation whose next message…"asked" | "cleared"
baseThe commit its private copy started…string
costUsdWhat it has cost so far,…number
inputTokensUncached input tokens, excluding cache reads…number
outputTokensTokens receivednumber
contextTokensHow much of the window the…number
contextWindowHow large that window isnumber
promptCacheWhen this conversation's prompt cache was…object
atWhen its last request touched the…number
ttlMsHow long that entry lives from…number
rollsAtWhen the date written into the…number
keepableUntilPresent when this sandbox can keep…number
keepWarmWhether the sandbox is keeping this…object
sinceWhen keeping it warm started, in…number
untilWhen it stops by itself, in…number
refreshesRefreshes sent so farinteger
readTokensHow much the last refresh read…number
endedWhy keeping it warm stopped before…object
atWhen it stopped, in millisecondsnumber
reasonWhy: `elapsed` the time asked for…"elapsed" | "allowance" | "changed" | "cold" … (5)
detailThe specifics, when there are any:…string
activityWhat it is doing at this…object
toolThe last tool it reached forstring
targetWhat it reached for that tool…string
todoThe item on its own list…string
checklistHow far it is through its…object
doneItems it has completednumber
totalItems on the listnumber
doingItems it has marked in progress…number
landedMessageDraftThe whole story of this merge's…object
startedAtWhen the drafting began, in millisecondsnumber
stepsEach model that was asked, in…object[]
providerWhich provider was askedstring
modelWhich of its modelsstring
statusHow this one went"asking" | "answered" | "refused" | "skipped"
atWhen it started being asked, in…number
msHow long it tooknumber
reasonWhy it refused, in its own…string
outcomeHow it ended"written" | "failed"
reasonThe one-line account of a failure,…string
finishedAtWhen it ended, in millisecondsnumber
landedMessageWhat this conversation's merged work is…object
subjectOne line saying what the merged…string
noteThe same change said to somebody…string
breakingWhat this change takes away, for…string
testNoteWhy a test this change weakened…string
allowsExceptions the conversation declared for this…string[]
startedAtWhen the running turn started, in…number
runThe run under way right now:…string
queueMessages waiting for its next turn,…object
itemsWhat waits, in the order it…object[]
idThe message's id: what its sender…string
textThe words, as they will go…string
attachmentsFiles that go with it, as…string[]
voiceWho it is from: a person,…"person" | "sandbox" | "agent"
queuedAtWhen it joined the queue, in…number
revisionThe queue's revision when this message…integer
untilWhen this message goes out by…number
afterThe conversation whose finished work must…string
afterTurnSays `after` waits for that conversation's…true
reopenOfThe allowance this message's `until` waits…object
agentThe provider whose allowance it waits…string
accountWhich of its accountsstring
trialRetrySays `until` is the sandbox sending…object
madeWhich automatic try this booking is,…integer
maxHow many automatic tries the sandbox…integer
servesWho serves the turn this message…object
agentThe providerstring
harnessThe agentic loop"native" | "claude-code" | "codex" | "opencode" … (7)
modelThe modelstring
effortHow hard it thinks, where the…string
accountThe account that pays for itstring
continuesA continuation, not words: when it…true
revisionMoves with every change to the…integer
pausedWhy the messages with no booking…"stopped" | "refused" | "scheduled"
untilThe soonest booked message's time, in…number
afterThe conversation the first booked message…string
updatedAtWhen it last did something, in…number
answeredAtWhen its model provider last answered…number
seenAtWhen somebody last opened it, in…number
unsentAtSince when somebody's composer has held…number
attentionWhich kinds of waiting-for-you it is…object
planIt has proposed a plan and…boolean
questionIt has asked you somethingboolean
permissionIt wants to use a tool…boolean
capabilityIt needs something connected that is…boolean
credentialIt is waiting for a named…boolean
conflictIts work cannot be merged without…boolean
needIt asked a person for something…boolean
permissionAskThe oldest permission its running turn…object
requestIdWhich request this is: the id…string
askWhat it asks to do, on…string
programThe program it is holding, as…object
textWhat would runstring
languageWhich of the two backends it…"bash" | "javascript"
truncatedWhether this is an excerpt of…boolean
spansWhich fragments of the text the…object[]
startinteger
endinteger
landFailureThe last attempt to bring its…object
reasonWhy it failed, in the words…string
codeWhich kind of failure it was,…string
atWhen it failed, in millisecondsnumber
deliveryWhat became of its last land…object
state"delivered" | "partial" | "waiting" | "failed" … (5)
atWhen this state was reached, in…number
projectstring
folderThe folder on the owner's computer,…string
appliedFiles written, merged ones includedinteger
conflictsobject[]
pathstring
reason"edited" | "link" | "outside" | "missing-git"
pointThe machine's restore point taken before…string
reasonWhy it failed or waits, in…string
conflictCausesWhy its work will not merge,…"workspace" | "diverged" | "binary"[]
unfinishedWhat its last turn left open:…object
atWhen the turn that left this…number
stepsThe agent's own checklist where that…object
openItems on it that were never…number
totalItems on the whole listnumber
nextThe one it would have done…string
checkThe end-of-turn check that was still…string
proofWhat its last turn showed of…object
atWhen the turn that left this…number
verificationVerified: a check it ran passed…"verified" | "unproven" | "failing" | "no-code"
checkThe command that spoke, when one…string
unviewedHow many rendered files it changed…number
reviewThe latest code review this conversation…object
atWhen the turn that reported it…number
sourceWhich harness's reviewer reported it"claude" | "codex"
findingsHow many findings it reportedinteger
openHow many of those no re-report…integer
reachWhere its last turn's work went…object
atWhen the turn that left this…number
liveFiles it changed in place where…object[]
pathWhat it wrote, as it named…string
extensionThe extension, by its manifest id,…string
liveMoreHow many more such files there…number
strandedRepositories it cloned inside its own…object[]
dirThe clone, as a folder relative…string
uncommittedFiles changed in it and never…number
unpushedCommits in it its upstream does…number
commitsCommits it holds at all, 0…number
parentThe workspace repository it sits inside,…string
strandedMoreHow many more such clones there…number
publishedPushes it made with git that…object[]
dirThe folder it pushed from, as…string
remoteThe remote it pushed to, as…string
branchThe branch it pushed to, as…string
commandThe push itself, trimmed to one…string
publishedMoreHow many more such pushes there…number
turnsTurns it has finishednumber
toolUsesTools it has used, over its…number
subagentsSubagents this one started, in-process and…object
runningSubagents working right nownumber
totalSubagents it has started over its…number
diffEverything it has written, measured from…object
filesFiles touchednumber
insertionsLines addednumber
deletionsLines removednumber
modulesThe packages its changes fall in,…string[]
landedPresencePresent only when some of what…object
landedPaths this conversation merged innumber
presentHow many of them are still…number
removedByWho took them out, when the…object
when kind is "agent"shape
idThe conversation that took them outstring
titleWhat that conversation is calledstring
when kind is "person"shape
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
loopThe loop driving this conversation, if…object
stateHow the loop is going"running" | "done" | "exhausted" | "stalled" … (8)
iterationWhich round it is oninteger
maxIterationsHow many rounds it will attempt…integer
goalWhat it is looping towardsstring
workflowThe workflow run this conversation is…object
runIdThe run this belongs to, which…string
nameThe workflow's namestring
stepWhich step this conversation is on…string
indexThis step's place in the workflow,…integer
totalHow many steps the workflow hasinteger
awaitingWakeWhether this conversation runs again by…boolean
watchesOutside conditions this conversation is parked…object[]
idThe daemon's handle for this watch,…string
noteThe agent's own line on what…string
intervalSecondsHow often the check runsinteger
deadlineAtWhen it gives up and wakes…number
needsWhat it is waiting on people…object[]
idstring
kindWhat is being asked for: a…"capability" | "secret" | "grant" | "release" … (8)
titlestring
statusWhere it stands: open (waiting on…"open" | "working" | "met" | "declined" … (5)
jobsCommands this conversation left running in…object[]
idThe daemon's handle for this job,…string
labelWhat the job is, in the…string
sessionThe terminal session its pane runs…string
startedAtWhen it started, in millisecondsnumber
endedAtWhen the command exited, in millisecondsnumber
exitCodeThe code it exited withinteger
watchThe watch its exit wakes this…string
handedLeft running for the person: the…boolean
portsThe ports it was listening on…integer[]
stoppedByWho stopped it: the sandbox, when…"turn" | "person" | "agent"
inputWaitPresent while it sits blocked reading…object
sinceWhen it went still, in millisecondsnumber
programThe process blocked reading the terminal,…string
scriptRunsWorkflow runs this conversation started that…object[]
idThe run's id, the one its…string
nameThe workflow's name, from its script's…string
callsHow many subagents it has started…integer
workingHow many of its subagents are…integer
failedHow many of its calls failed…integer
phaseThe phase its script last markedstring
startedAtWhen it started, in millisecondsnumber
archivedAtWhen it was put away, in…number
Try itanswered in this tab
curl
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
import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.seal.answer({
  "id": "a1b2c3d4",
  "email": "ada@example.com",
  "answer": "day"
});
POST/seal/{id}/openOpen 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

FieldTypeWhere
idrequiredThe conversationstringaddress
reasonrequiredstringbody

What comes back

FieldType
idThe conversation id, which is how…string
sessionIdThe provider session behind the last…string
titleWhat to call it: the first…string
titleActionOne word for the kind of…string
statusWhat it is doing"idle" | "running" | "awaiting" | "stopping" … (13)
failureWhy the last turn failed, in…string
failureCodeWhich kind of failure it was,…string
failureOwnWhether `failure` is the sandbox's own…boolean
failureRepeatsHow many turns in a row…integer
limitResetsAtWhen the spent allowance reopens, in…number
limitHeldWhether the refused turn is held…boolean
limitScheduledSent only by sandboxes older than…boolean
limitMovingSent only by sandboxes older than…string
limitNextAtSent only by sandboxes older than…number
nextWhat carries it on next with…object
when kind is "rerun"shape
atWhen the held turn goes again,…number
ontoThe account the owner's answer to…string
when kind is "room"shape
when kind is "send"shape
atWhen the soonest booked message goes,…number
countHow many messages are booked to…integer
when kind is "land"shape
afterThe conversation whose landed work the…string
turnSet when that message waits for…true
countHow many messages are booked to…integer
pressThe daemon's one reading of what…object
when kind is "none"shape
when kind is "continue"shape
endingHow the last turn ended, which…object
reasonWhich ending left the work here:…"limit" | "outage" | "stopped" | "flagged"
resetsAtWhen the spent allowance reopens, in…number
heldPresent when the daemon still holds…object
scheduledWhether something other than the user…boolean
nextAtWhen the booked send actually fires,…number
retriesHow many automatic re-runs a stopped…object
providerWhich model provider it runs onstring
harnessWhich agentic loop it runs on"native" | "claude-code" | "codex" | "opencode" … (7)
runnerThe runner this conversation runs onstring
startInWhich folder it opened in, relative…string
actsAsWhich role its first turn acted…string
lastActsAsWhich role its last turn acted…string
modelWhat its last turn ran withstring
effortHow hard that turn was told…string
thinkingWhether that turn showed its reasoningboolean
fastWhether that turn asked for higher…boolean
accountWhich connected account paid for itstring
branchThe branch its private copy works…string
autoLandThis conversation's own answer to whether…boolean
limitPolicy"wait" | "resend" | "move"
outagePolicy"wait" | "retry"
stopPolicy"wait" | "retry"
memoryPolicy"wait" | "resend"
memoryKillPolicyThis conversation's own answer to a…"wait" | "resume"
proceedWithoutAskingThis conversation's own answer to whether…boolean
autoApproveWhether every permission this conversation asks…"own" | "inherited"
landRequestedA collaborator has asked a maintainer…object
emailWho askedstring
nameTheir display namestring
atWhen they asked, in millisecondsnumber
reactionsWhat people have marked this conversation…object[]
emojiThe mark itself, one emoji, carried…string
byEveryone wearing this mark, oldest first,…object[]
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
atWhen they marked it, in millisecondsnumber
originWhere the conversation came from when…object
automationIdstring
providerstring
channelIdstring
threadIdstring
authorstring
startedByWho asked for the first turn,…string
areasWhich named areas of the workspace…string[]
ownerThe member answerable for this conversation:…object
emailWho answers for this conversation, as…string
nameWhat to call them, when the…string
sinceWhen they became its owner, in…number
participantsThe people who took part in…object[]
emailWho took part, lowercased, as the…string
nameWhat to call them, when their…string
sinceWhen they first took part, in…number
viaHow they first took part: they…"prompt" | "answer" | "land" | "mention"
notifyYour own answer to how much…object[]
emailWhose answer it is, lowercasedstring
levelWhat they asked to hear of…"all" | "asks" | "none"
atWhen they chose it, in millisecondsnumber
forkedFromThe conversation this one was cut…object
conversationIdstring
indexinteger
files"then" | "now"
freshSet on a conversation started on…object
ofThe conversation whose work it started…string
kindWhat it was opened for: a…"review" | "test" | "ask"
atWhen it started, in millisecondsnumber
byThe agent that opened it, when…string
branchesThe branches this conversation was started…object[]
repoWhich repositorystring
branchThe branch, by its short name:…string
sealSet on a private conversation: how…object
sealedThe caller cannot read this conversation:…true
viaHow the caller reads it"reader" | "grant" | "open"
untilUntil when the caller may read…number
readersobject[]
emailstring
namestring
grantsobject[]
emailstring
namestring
untilUntil when they may read it,…number
byWho let them, by addressstring
asksobject[]
emailstring
namestring
atnumber
opensobject[]
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
askedOn a sealed card: the caller…true
pendingAn opening without asking that waits…object
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
canOpenOn a sealed card: the caller…true
canApproveThe caller may agree to the…true
homeThis is its owner's home conversation…true
commitsA home conversation's latest lands as…object[]
landThe land's id, as its `landed`…string
atWhen it was committed, in millisecondsnumber
subjectThe commit's subject linestring
commitsThe commit each repository the land…object[]
repoWhich repository: "root" for the workspace…string
shaThe commit, in fullstring
freshPendingA home conversation whose next message…"asked" | "cleared"
baseThe commit its private copy started…string
costUsdWhat it has cost so far,…number
inputTokensUncached input tokens, excluding cache reads…number
outputTokensTokens receivednumber
contextTokensHow much of the window the…number
contextWindowHow large that window isnumber
promptCacheWhen this conversation's prompt cache was…object
atWhen its last request touched the…number
ttlMsHow long that entry lives from…number
rollsAtWhen the date written into the…number
keepableUntilPresent when this sandbox can keep…number
keepWarmWhether the sandbox is keeping this…object
sinceWhen keeping it warm started, in…number
untilWhen it stops by itself, in…number
refreshesRefreshes sent so farinteger
readTokensHow much the last refresh read…number
endedWhy keeping it warm stopped before…object
atWhen it stopped, in millisecondsnumber
reasonWhy: `elapsed` the time asked for…"elapsed" | "allowance" | "changed" | "cold" … (5)
detailThe specifics, when there are any:…string
activityWhat it is doing at this…object
toolThe last tool it reached forstring
targetWhat it reached for that tool…string
todoThe item on its own list…string
checklistHow far it is through its…object
doneItems it has completednumber
totalItems on the listnumber
doingItems it has marked in progress…number
landedMessageDraftThe whole story of this merge's…object
startedAtWhen the drafting began, in millisecondsnumber
stepsEach model that was asked, in…object[]
providerWhich provider was askedstring
modelWhich of its modelsstring
statusHow this one went"asking" | "answered" | "refused" | "skipped"
atWhen it started being asked, in…number
msHow long it tooknumber
reasonWhy it refused, in its own…string
outcomeHow it ended"written" | "failed"
reasonThe one-line account of a failure,…string
finishedAtWhen it ended, in millisecondsnumber
landedMessageWhat this conversation's merged work is…object
subjectOne line saying what the merged…string
noteThe same change said to somebody…string
breakingWhat this change takes away, for…string
testNoteWhy a test this change weakened…string
allowsExceptions the conversation declared for this…string[]
startedAtWhen the running turn started, in…number
runThe run under way right now:…string
queueMessages waiting for its next turn,…object
itemsWhat waits, in the order it…object[]
idThe message's id: what its sender…string
textThe words, as they will go…string
attachmentsFiles that go with it, as…string[]
voiceWho it is from: a person,…"person" | "sandbox" | "agent"
queuedAtWhen it joined the queue, in…number
revisionThe queue's revision when this message…integer
untilWhen this message goes out by…number
afterThe conversation whose finished work must…string
afterTurnSays `after` waits for that conversation's…true
reopenOfThe allowance this message's `until` waits…object
agentThe provider whose allowance it waits…string
accountWhich of its accountsstring
trialRetrySays `until` is the sandbox sending…object
madeWhich automatic try this booking is,…integer
maxHow many automatic tries the sandbox…integer
servesWho serves the turn this message…object
agentThe providerstring
harnessThe agentic loop"native" | "claude-code" | "codex" | "opencode" … (7)
modelThe modelstring
effortHow hard it thinks, where the…string
accountThe account that pays for itstring
continuesA continuation, not words: when it…true
revisionMoves with every change to the…integer
pausedWhy the messages with no booking…"stopped" | "refused" | "scheduled"
untilThe soonest booked message's time, in…number
afterThe conversation the first booked message…string
updatedAtWhen it last did something, in…number
answeredAtWhen its model provider last answered…number
seenAtWhen somebody last opened it, in…number
unsentAtSince when somebody's composer has held…number
attentionWhich kinds of waiting-for-you it is…object
planIt has proposed a plan and…boolean
questionIt has asked you somethingboolean
permissionIt wants to use a tool…boolean
capabilityIt needs something connected that is…boolean
credentialIt is waiting for a named…boolean
conflictIts work cannot be merged without…boolean
needIt asked a person for something…boolean
permissionAskThe oldest permission its running turn…object
requestIdWhich request this is: the id…string
askWhat it asks to do, on…string
programThe program it is holding, as…object
textWhat would runstring
languageWhich of the two backends it…"bash" | "javascript"
truncatedWhether this is an excerpt of…boolean
spansWhich fragments of the text the…object[]
startinteger
endinteger
landFailureThe last attempt to bring its…object
reasonWhy it failed, in the words…string
codeWhich kind of failure it was,…string
atWhen it failed, in millisecondsnumber
deliveryWhat became of its last land…object
state"delivered" | "partial" | "waiting" | "failed" … (5)
atWhen this state was reached, in…number
projectstring
folderThe folder on the owner's computer,…string
appliedFiles written, merged ones includedinteger
conflictsobject[]
pathstring
reason"edited" | "link" | "outside" | "missing-git"
pointThe machine's restore point taken before…string
reasonWhy it failed or waits, in…string
conflictCausesWhy its work will not merge,…"workspace" | "diverged" | "binary"[]
unfinishedWhat its last turn left open:…object
atWhen the turn that left this…number
stepsThe agent's own checklist where that…object
openItems on it that were never…number
totalItems on the whole listnumber
nextThe one it would have done…string
checkThe end-of-turn check that was still…string
proofWhat its last turn showed of…object
atWhen the turn that left this…number
verificationVerified: a check it ran passed…"verified" | "unproven" | "failing" | "no-code"
checkThe command that spoke, when one…string
unviewedHow many rendered files it changed…number
reviewThe latest code review this conversation…object
atWhen the turn that reported it…number
sourceWhich harness's reviewer reported it"claude" | "codex"
findingsHow many findings it reportedinteger
openHow many of those no re-report…integer
reachWhere its last turn's work went…object
atWhen the turn that left this…number
liveFiles it changed in place where…object[]
pathWhat it wrote, as it named…string
extensionThe extension, by its manifest id,…string
liveMoreHow many more such files there…number
strandedRepositories it cloned inside its own…object[]
dirThe clone, as a folder relative…string
uncommittedFiles changed in it and never…number
unpushedCommits in it its upstream does…number
commitsCommits it holds at all, 0…number
parentThe workspace repository it sits inside,…string
strandedMoreHow many more such clones there…number
publishedPushes it made with git that…object[]
dirThe folder it pushed from, as…string
remoteThe remote it pushed to, as…string
branchThe branch it pushed to, as…string
commandThe push itself, trimmed to one…string
publishedMoreHow many more such pushes there…number
turnsTurns it has finishednumber
toolUsesTools it has used, over its…number
subagentsSubagents this one started, in-process and…object
runningSubagents working right nownumber
totalSubagents it has started over its…number
diffEverything it has written, measured from…object
filesFiles touchednumber
insertionsLines addednumber
deletionsLines removednumber
modulesThe packages its changes fall in,…string[]
landedPresencePresent only when some of what…object
landedPaths this conversation merged innumber
presentHow many of them are still…number
removedByWho took them out, when the…object
when kind is "agent"shape
idThe conversation that took them outstring
titleWhat that conversation is calledstring
when kind is "person"shape
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
loopThe loop driving this conversation, if…object
stateHow the loop is going"running" | "done" | "exhausted" | "stalled" … (8)
iterationWhich round it is oninteger
maxIterationsHow many rounds it will attempt…integer
goalWhat it is looping towardsstring
workflowThe workflow run this conversation is…object
runIdThe run this belongs to, which…string
nameThe workflow's namestring
stepWhich step this conversation is on…string
indexThis step's place in the workflow,…integer
totalHow many steps the workflow hasinteger
awaitingWakeWhether this conversation runs again by…boolean
watchesOutside conditions this conversation is parked…object[]
idThe daemon's handle for this watch,…string
noteThe agent's own line on what…string
intervalSecondsHow often the check runsinteger
deadlineAtWhen it gives up and wakes…number
needsWhat it is waiting on people…object[]
idstring
kindWhat is being asked for: a…"capability" | "secret" | "grant" | "release" … (8)
titlestring
statusWhere it stands: open (waiting on…"open" | "working" | "met" | "declined" … (5)
jobsCommands this conversation left running in…object[]
idThe daemon's handle for this job,…string
labelWhat the job is, in the…string
sessionThe terminal session its pane runs…string
startedAtWhen it started, in millisecondsnumber
endedAtWhen the command exited, in millisecondsnumber
exitCodeThe code it exited withinteger
watchThe watch its exit wakes this…string
handedLeft running for the person: the…boolean
portsThe ports it was listening on…integer[]
stoppedByWho stopped it: the sandbox, when…"turn" | "person" | "agent"
inputWaitPresent while it sits blocked reading…object
sinceWhen it went still, in millisecondsnumber
programThe process blocked reading the terminal,…string
scriptRunsWorkflow runs this conversation started that…object[]
idThe run's id, the one its…string
nameThe workflow's name, from its script's…string
callsHow many subagents it has started…integer
workingHow many of its subagents are…integer
failedHow many of its calls failed…integer
phaseThe phase its script last markedstring
startedAtWhen it started, in millisecondsnumber
archivedAtWhen it was put away, in…number
Try itanswered in this tab
curl
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
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/approveAgree 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

FieldTypeWhere
idrequiredThe conversationstringaddress
openrequiredWhich openingstringbody
agreerequiredbooleanbody

What comes back

FieldType
idThe conversation id, which is how…string
sessionIdThe provider session behind the last…string
titleWhat to call it: the first…string
titleActionOne word for the kind of…string
statusWhat it is doing"idle" | "running" | "awaiting" | "stopping" … (13)
failureWhy the last turn failed, in…string
failureCodeWhich kind of failure it was,…string
failureOwnWhether `failure` is the sandbox's own…boolean
failureRepeatsHow many turns in a row…integer
limitResetsAtWhen the spent allowance reopens, in…number
limitHeldWhether the refused turn is held…boolean
limitScheduledSent only by sandboxes older than…boolean
limitMovingSent only by sandboxes older than…string
limitNextAtSent only by sandboxes older than…number
nextWhat carries it on next with…object
when kind is "rerun"shape
atWhen the held turn goes again,…number
ontoThe account the owner's answer to…string
when kind is "room"shape
when kind is "send"shape
atWhen the soonest booked message goes,…number
countHow many messages are booked to…integer
when kind is "land"shape
afterThe conversation whose landed work the…string
turnSet when that message waits for…true
countHow many messages are booked to…integer
pressThe daemon's one reading of what…object
when kind is "none"shape
when kind is "continue"shape
endingHow the last turn ended, which…object
reasonWhich ending left the work here:…"limit" | "outage" | "stopped" | "flagged"
resetsAtWhen the spent allowance reopens, in…number
heldPresent when the daemon still holds…object
scheduledWhether something other than the user…boolean
nextAtWhen the booked send actually fires,…number
retriesHow many automatic re-runs a stopped…object
providerWhich model provider it runs onstring
harnessWhich agentic loop it runs on"native" | "claude-code" | "codex" | "opencode" … (7)
runnerThe runner this conversation runs onstring
startInWhich folder it opened in, relative…string
actsAsWhich role its first turn acted…string
lastActsAsWhich role its last turn acted…string
modelWhat its last turn ran withstring
effortHow hard that turn was told…string
thinkingWhether that turn showed its reasoningboolean
fastWhether that turn asked for higher…boolean
accountWhich connected account paid for itstring
branchThe branch its private copy works…string
autoLandThis conversation's own answer to whether…boolean
limitPolicy"wait" | "resend" | "move"
outagePolicy"wait" | "retry"
stopPolicy"wait" | "retry"
memoryPolicy"wait" | "resend"
memoryKillPolicyThis conversation's own answer to a…"wait" | "resume"
proceedWithoutAskingThis conversation's own answer to whether…boolean
autoApproveWhether every permission this conversation asks…"own" | "inherited"
landRequestedA collaborator has asked a maintainer…object
emailWho askedstring
nameTheir display namestring
atWhen they asked, in millisecondsnumber
reactionsWhat people have marked this conversation…object[]
emojiThe mark itself, one emoji, carried…string
byEveryone wearing this mark, oldest first,…object[]
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
atWhen they marked it, in millisecondsnumber
originWhere the conversation came from when…object
automationIdstring
providerstring
channelIdstring
threadIdstring
authorstring
startedByWho asked for the first turn,…string
areasWhich named areas of the workspace…string[]
ownerThe member answerable for this conversation:…object
emailWho answers for this conversation, as…string
nameWhat to call them, when the…string
sinceWhen they became its owner, in…number
participantsThe people who took part in…object[]
emailWho took part, lowercased, as the…string
nameWhat to call them, when their…string
sinceWhen they first took part, in…number
viaHow they first took part: they…"prompt" | "answer" | "land" | "mention"
notifyYour own answer to how much…object[]
emailWhose answer it is, lowercasedstring
levelWhat they asked to hear of…"all" | "asks" | "none"
atWhen they chose it, in millisecondsnumber
forkedFromThe conversation this one was cut…object
conversationIdstring
indexinteger
files"then" | "now"
freshSet on a conversation started on…object
ofThe conversation whose work it started…string
kindWhat it was opened for: a…"review" | "test" | "ask"
atWhen it started, in millisecondsnumber
byThe agent that opened it, when…string
branchesThe branches this conversation was started…object[]
repoWhich repositorystring
branchThe branch, by its short name:…string
sealSet on a private conversation: how…object
sealedThe caller cannot read this conversation:…true
viaHow the caller reads it"reader" | "grant" | "open"
untilUntil when the caller may read…number
readersobject[]
emailstring
namestring
grantsobject[]
emailstring
namestring
untilUntil when they may read it,…number
byWho let them, by addressstring
asksobject[]
emailstring
namestring
atnumber
opensobject[]
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
askedOn a sealed card: the caller…true
pendingAn opening without asking that waits…object
emailstring
namestring
idThe opening's own idstring
atWhen it was asked for, in…number
untilUntil when it may be read,…number
reasonWhy, in the opener's words, as…string
approvedByobject
emailstring
namestring
atnumber
refusedByobject
emailstring
namestring
atnumber
pendingtrue
canOpenOn a sealed card: the caller…true
canApproveThe caller may agree to the…true
homeThis is its owner's home conversation…true
commitsA home conversation's latest lands as…object[]
landThe land's id, as its `landed`…string
atWhen it was committed, in millisecondsnumber
subjectThe commit's subject linestring
commitsThe commit each repository the land…object[]
repoWhich repository: "root" for the workspace…string
shaThe commit, in fullstring
freshPendingA home conversation whose next message…"asked" | "cleared"
baseThe commit its private copy started…string
costUsdWhat it has cost so far,…number
inputTokensUncached input tokens, excluding cache reads…number
outputTokensTokens receivednumber
contextTokensHow much of the window the…number
contextWindowHow large that window isnumber
promptCacheWhen this conversation's prompt cache was…object
atWhen its last request touched the…number
ttlMsHow long that entry lives from…number
rollsAtWhen the date written into the…number
keepableUntilPresent when this sandbox can keep…number
keepWarmWhether the sandbox is keeping this…object
sinceWhen keeping it warm started, in…number
untilWhen it stops by itself, in…number
refreshesRefreshes sent so farinteger
readTokensHow much the last refresh read…number
endedWhy keeping it warm stopped before…object
atWhen it stopped, in millisecondsnumber
reasonWhy: `elapsed` the time asked for…"elapsed" | "allowance" | "changed" | "cold" … (5)
detailThe specifics, when there are any:…string
activityWhat it is doing at this…object
toolThe last tool it reached forstring
targetWhat it reached for that tool…string
todoThe item on its own list…string
checklistHow far it is through its…object
doneItems it has completednumber
totalItems on the listnumber
doingItems it has marked in progress…number
landedMessageDraftThe whole story of this merge's…object
startedAtWhen the drafting began, in millisecondsnumber
stepsEach model that was asked, in…object[]
providerWhich provider was askedstring
modelWhich of its modelsstring
statusHow this one went"asking" | "answered" | "refused" | "skipped"
atWhen it started being asked, in…number
msHow long it tooknumber
reasonWhy it refused, in its own…string
outcomeHow it ended"written" | "failed"
reasonThe one-line account of a failure,…string
finishedAtWhen it ended, in millisecondsnumber
landedMessageWhat this conversation's merged work is…object
subjectOne line saying what the merged…string
noteThe same change said to somebody…string
breakingWhat this change takes away, for…string
testNoteWhy a test this change weakened…string
allowsExceptions the conversation declared for this…string[]
startedAtWhen the running turn started, in…number
runThe run under way right now:…string
queueMessages waiting for its next turn,…object
itemsWhat waits, in the order it…object[]
idThe message's id: what its sender…string
textThe words, as they will go…string
attachmentsFiles that go with it, as…string[]
voiceWho it is from: a person,…"person" | "sandbox" | "agent"
queuedAtWhen it joined the queue, in…number
revisionThe queue's revision when this message…integer
untilWhen this message goes out by…number
afterThe conversation whose finished work must…string
afterTurnSays `after` waits for that conversation's…true
reopenOfThe allowance this message's `until` waits…object
agentThe provider whose allowance it waits…string
accountWhich of its accountsstring
trialRetrySays `until` is the sandbox sending…object
madeWhich automatic try this booking is,…integer
maxHow many automatic tries the sandbox…integer
servesWho serves the turn this message…object
agentThe providerstring
harnessThe agentic loop"native" | "claude-code" | "codex" | "opencode" … (7)
modelThe modelstring
effortHow hard it thinks, where the…string
accountThe account that pays for itstring
continuesA continuation, not words: when it…true
revisionMoves with every change to the…integer
pausedWhy the messages with no booking…"stopped" | "refused" | "scheduled"
untilThe soonest booked message's time, in…number
afterThe conversation the first booked message…string
updatedAtWhen it last did something, in…number
answeredAtWhen its model provider last answered…number
seenAtWhen somebody last opened it, in…number
unsentAtSince when somebody's composer has held…number
attentionWhich kinds of waiting-for-you it is…object
planIt has proposed a plan and…boolean
questionIt has asked you somethingboolean
permissionIt wants to use a tool…boolean
capabilityIt needs something connected that is…boolean
credentialIt is waiting for a named…boolean
conflictIts work cannot be merged without…boolean
needIt asked a person for something…boolean
permissionAskThe oldest permission its running turn…object
requestIdWhich request this is: the id…string
askWhat it asks to do, on…string
programThe program it is holding, as…object
textWhat would runstring
languageWhich of the two backends it…"bash" | "javascript"
truncatedWhether this is an excerpt of…boolean
spansWhich fragments of the text the…object[]
startinteger
endinteger
landFailureThe last attempt to bring its…object
reasonWhy it failed, in the words…string
codeWhich kind of failure it was,…string
atWhen it failed, in millisecondsnumber
deliveryWhat became of its last land…object
state"delivered" | "partial" | "waiting" | "failed" … (5)
atWhen this state was reached, in…number
projectstring
folderThe folder on the owner's computer,…string
appliedFiles written, merged ones includedinteger
conflictsobject[]
pathstring
reason"edited" | "link" | "outside" | "missing-git"
pointThe machine's restore point taken before…string
reasonWhy it failed or waits, in…string
conflictCausesWhy its work will not merge,…"workspace" | "diverged" | "binary"[]
unfinishedWhat its last turn left open:…object
atWhen the turn that left this…number
stepsThe agent's own checklist where that…object
openItems on it that were never…number
totalItems on the whole listnumber
nextThe one it would have done…string
checkThe end-of-turn check that was still…string
proofWhat its last turn showed of…object
atWhen the turn that left this…number
verificationVerified: a check it ran passed…"verified" | "unproven" | "failing" | "no-code"
checkThe command that spoke, when one…string
unviewedHow many rendered files it changed…number
reviewThe latest code review this conversation…object
atWhen the turn that reported it…number
sourceWhich harness's reviewer reported it"claude" | "codex"
findingsHow many findings it reportedinteger
openHow many of those no re-report…integer
reachWhere its last turn's work went…object
atWhen the turn that left this…number
liveFiles it changed in place where…object[]
pathWhat it wrote, as it named…string
extensionThe extension, by its manifest id,…string
liveMoreHow many more such files there…number
strandedRepositories it cloned inside its own…object[]
dirThe clone, as a folder relative…string
uncommittedFiles changed in it and never…number
unpushedCommits in it its upstream does…number
commitsCommits it holds at all, 0…number
parentThe workspace repository it sits inside,…string
strandedMoreHow many more such clones there…number
publishedPushes it made with git that…object[]
dirThe folder it pushed from, as…string
remoteThe remote it pushed to, as…string
branchThe branch it pushed to, as…string
commandThe push itself, trimmed to one…string
publishedMoreHow many more such pushes there…number
turnsTurns it has finishednumber
toolUsesTools it has used, over its…number
subagentsSubagents this one started, in-process and…object
runningSubagents working right nownumber
totalSubagents it has started over its…number
diffEverything it has written, measured from…object
filesFiles touchednumber
insertionsLines addednumber
deletionsLines removednumber
modulesThe packages its changes fall in,…string[]
landedPresencePresent only when some of what…object
landedPaths this conversation merged innumber
presentHow many of them are still…number
removedByWho took them out, when the…object
when kind is "agent"shape
idThe conversation that took them outstring
titleWhat that conversation is calledstring
when kind is "person"shape
emailWho it was, as the sandbox…string
nameWhat to call them, when their…string
loopThe loop driving this conversation, if…object
stateHow the loop is going"running" | "done" | "exhausted" | "stalled" … (8)
iterationWhich round it is oninteger
maxIterationsHow many rounds it will attempt…integer
goalWhat it is looping towardsstring
workflowThe workflow run this conversation is…object
runIdThe run this belongs to, which…string
nameThe workflow's namestring
stepWhich step this conversation is on…string
indexThis step's place in the workflow,…integer
totalHow many steps the workflow hasinteger
awaitingWakeWhether this conversation runs again by…boolean
watchesOutside conditions this conversation is parked…object[]
idThe daemon's handle for this watch,…string
noteThe agent's own line on what…string
intervalSecondsHow often the check runsinteger
deadlineAtWhen it gives up and wakes…number
needsWhat it is waiting on people…object[]
idstring
kindWhat is being asked for: a…"capability" | "secret" | "grant" | "release" … (8)
titlestring
statusWhere it stands: open (waiting on…"open" | "working" | "met" | "declined" … (5)
jobsCommands this conversation left running in…object[]
idThe daemon's handle for this job,…string
labelWhat the job is, in the…string
sessionThe terminal session its pane runs…string
startedAtWhen it started, in millisecondsnumber
endedAtWhen the command exited, in millisecondsnumber
exitCodeThe code it exited withinteger
watchThe watch its exit wakes this…string
handedLeft running for the person: the…boolean
portsThe ports it was listening on…integer[]
stoppedByWho stopped it: the sandbox, when…"turn" | "person" | "agent"
inputWaitPresent while it sits blocked reading…object
sinceWhen it went still, in millisecondsnumber
programThe process blocked reading the terminal,…string
scriptRunsWorkflow runs this conversation started that…object[]
idThe run's id, the one its…string
nameThe workflow's name, from its script's…string
callsHow many subagents it has started…integer
workingHow many of its subagents are…integer
failedHow many of its calls failed…integer
phaseThe phase its script last markedstring
startedAtWhen it started, in millisecondsnumber
archivedAtWhen it was put away, in…number
Try itanswered in this tab
curl
curl -X POST "$SANDBOX/seal/a1b2c3d4/open/approve" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"open":"…","agree":true}'
TypeScript
import { sandbox } from "@intentic/sandbox-client";

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

Type to search every page, in the docs and the API reference.