Skip to main content
POST
Distill a note

Authorizations

Authorization
string
header
required

nia_sk_...

Body

application/json

Asks for a proposed note from one conversation or task, read already masked (10, C.5).

source_id
string<uuid>
required

The agent whose memory the note would join.

conversation_id
string | null
Required string length: 1 - 512
task_id
string | null
Required string length: 1 - 512

Response

The proposal, still without text; read GET /v1/agent-memory/proposals for the result.

body
string
required
created_at
string<date-time>
required
kind
enum<string>
required
Available options:
procedure,
tool_note,
process_note,
pitfall
origin
enum<string>
required

distilled from a conversation or task; agent when the space holds agent writes for a person.

Available options:
distilled,
agent
proposal_id
string<uuid>
required
source_id
string<uuid>
required
status
enum<string>
required
Available options:
drafting,
pending,
approved,
rejected,
failed
title
string
required
decided_at
string<date-time> | null
decided_by
string | null
evidence
Evidence · object | null

Where the note came from: an id only, never the text of the conversation or task.

note_id
string<uuid> | null

The note an approval created.

problem
string | null

Why a distillation failed: nothing_to_propose, personal_data, no_turns, or unconfirmed_link (the conversation spoke only through a link a claim made and nobody confirmed yet; ask again once it is confirmed).

tags
string[]
visibility
enum<string>
default:source
Available options:
source,
vendor,
space