Skip to main content
POST
Create writeback envelope (user)

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.

Body

application/json
payload
object
required

Run writeback payload.

run_id
string<uuid>
source
enum<string>
default:manual
Available options:
hermes,
brain_bus,
manual,
document_ingest,
maintenance
idempotency_key
string
Maximum string length: 255

Response

Existing envelope reused (idempotency key replay).

envelope
object

Writeback envelope (contracts/brain-ops.ts formatWritebackEnvelope).

proposals
object[]
mode
string
reused
enum<boolean>
Available options:
true