Skip to main content
GET
Python

Authorizations

Authorization
string
header
required

nia_sk_...

Headers

if-none-match
string | null

The etag you already hold. Unchanged, the answer is 304.

Query Parameters

max_tokens
integer
default:300

Token budget of the block, 50 to 2,000; 300 by default.

Required range: 50 <= x <= 2000
tags
string[] | null

Notes with these tags come first. Up to 8.

Maximum array length: 8
Pattern: ^[a-z0-9][a-z0-9_.:-]{0,63}$
view
string | null

The view or task the agent works in, so notes tagged for it come first.

source_id
string<uuid> | null

People only: the agent whose block to preview.

Response

The block, with the ETag in the header.

The block that goes into the prompt after the agent's instructions and before the customer's context: stable between customers, so it stays in the cacheable prefix.

etag
string
required
text
string
required

Empty when there is nothing to show or agent memory is off.

enabled
boolean
default:true

False when the space has agent memory turned off.

notes
string<uuid>[]

The notes the text carries, in order.

tokens
integer
default:0