Skip to main content
POST
Ingestion status

Authorizations

Authorization
string
header
required

nia_sk_...

Body

application/json

POST /v1/ingest/status: the conversation or task goes in the body, never in a URL.

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

Response

Successful Response

Whether what was sent for a conversation or task became memory yet. No content, only states.

state
enum<string>
required

open: still receiving turns, memory comes after it closes by inactivity or conversation.ended. processing: closed, extraction queued or running. ready: extracted, memory applies it within seconds. failed: the extraction failed and a template episode stands in; the nightly pass extracts again. unknown: nothing was received under this id.

Available options:
unknown,
open,
processing,
ready,
failed
close_reason
string | null
closed_at
string<date-time> | null
extraction
enum<string> | null

The latest extraction run of the last closed session, when there is one.

Available options:
ok,
minimal,
invalid,
failed
last_event_at
string<date-time> | null
masked
Masked · object | null

Values held back from this conversation's or task's events before storage, by type (card, cvv, password, secret); absent when none was.