Skip to main content
GET
List writeback envelopes

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Headers

X-Naive-Project-Id
string<uuid>

Act inside this project. The header form of the /v1/projects/{project_id}/... prefix, for clients that cannot rewrite their base path. Lower precedence than the path, higher than the key's pinned project; omitted resolves to the organization's default project.

Path Parameters

user_id
string
required

Tenant user UUID, or default / me for the account's default agentProfile.

Query Parameters

run_id
string<uuid>

Filter by agent run id.

source
enum<string>

Filter by writeback source.

Available options:
hermes,
brain_bus,
manual,
document_ingest,
maintenance
status
enum<string>

Filter by envelope status.

Available options:
received,
scored,
routed,
failed
limit
integer
default:50

Max rows to return.

Required range: 1 <= x <= 200

Response

Writebacks.

writebacks
object[]
count
integer