Skip to main content
GET
Read context by profile

Authorizations

Authorization
string
header
required

nia_sk_...

Headers

if-none-match
string | null

The ETag you already hold. When it still matches, the answer is 304.

Query Parameters

profile_id
string<uuid>
required

The profile, as returned by the identity and profile routes.

view
string
default:chat

Channel, subject or task view, such as voice, chat or task:billing.

verification
enum<string>
default:V0

The level proven in this conversation; the effective level is never above the ceiling of the source. Session verification levels. no_customer sits outside the V0-V4 scale.

Available options:
V0,
V1,
V2,
V3,
V4,
no_customer
conversation_id
string | null

Pins the pack to the conversation, so every turn gets the same bytes.

task_id
string | null

For internal agents, in place of conversation_id.

format
enum<string>
default:text
Available options:
text,
json

Response

The pack.

etag
string
required
path
enum<string>
required

Which read tier answered a context() call.

Available options:
t0,
t1,
t2,
t3,
t4,
holdout,
not_modified
verification
VerificationResult · object
required
version
string
required

Generation of the pack, such as g42. The spec version of the pack as data is pack.spec; the text carries no version attribute.

about_unlinked
boolean
default:false

about named an account or partner with no active link to the subject: the pack is the subject's own, without that organization's block. It never says whether the organization exists.

as_of
string<date-time> | null

The pack reflects events up to this instant.

budget
BudgetBlock · object | null

With include: ["budget"]: what the pack costs per section, what this agent already spent in the conversation and the case, and what the measurement says can go; shown, never enforced.

cache
CacheDirectives · object | null
constraints
ConstraintsBlock · object | null

With include: ["constraints"]: what the subject wants, refuses and is, for the tools of this turn (constraints.v0).

coordination
CoordinationBlock · object | null

With include: ["coordination"]: who holds the subject, the purposes it may not be contacted for, the contacts each purpose with a budget has left and the commitments that hold. Advice for the turn: only a check decides.

coverage
SourceCoverage · object[]
degraded
boolean
default:false
delta
string | null

With delta: what memory learned since this agent's last read, for the end of the prompt. The turn block after text is live, then slots, then delta.

guards
PackGuard · object[]

What the guard lines among slots state, typed. An SDK checks the agent's answer against them and names a guard the answer went against on the agent's turn (backing.guard_violations).

lag_seconds
number | null
live
LiveTurn · object[]

Recent turns of the customer's other conversations not yet in the compiled context, oldest first: at most the newest 50, from the newest 100 turns of each of the customer's handles.

live_complete
boolean
default:true

False when the hot layer was unavailable, a turn could not be read, or a handle had more recent turns than were read.

manifest_hash
string | null

Hash of the provenance manifest behind this pack. The receipt points to it.

not_modified
boolean
default:false
pack
ContextPack · object | null

With format: "json"; absent when text is absent.

slots
string | null

With query: what the customer's last turn selected from memory for this turn. It goes in the turn block after text, in this order: the live turns, then slots, then delta. Never part of text, which stays the same bytes for the whole conversation.

state
StateView · object | null

With include: ["state"]: the subject's objects of the declared types, each as a display read serves it (object-state.v1): values with their logical value, stamps, source and freshness computed now, and what may not be claimed with them.

text
string | null

The Context Pack, ready for the prompt.

timing
Timing · object

Milliseconds per step.

variables
Variables · object

The same content as named variables, for templates.

withheld
integer
default:0

Items and live turns the policy left out for this reader and level.