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.

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

Context Pack spec version.

as_of
string<date-time> | null

The pack reflects events up to this instant.

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

What changed since your last read, when delta was requested.

lag_seconds
number | null
live
LiveTurn · object[]
live_complete
boolean
default:true
manifest_hash
string | null

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

not_modified
boolean
default:false
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 the policy held back at this verification level. Verifying releases more.