Skip to main content
POST
Ingest a chat transcript

Authorizations

X-API-Key
string
header
required

API key created from the MemContext dashboard. Keys are prefixed with mc_, bound to one workspace, and API-key requests cannot override that workspace.

Body

application/json
sessionId
string
required
Maximum string length: 200
messages
object[]
required
Maximum array length: 1000
client
string
project
string
scope
string
date
string

Conversation date, used to resolve relative dates like "next Friday".

final
boolean
default:true
handoff
object

Response

202 - application/json

Accepted for background extraction.

accepted
integer
required

Transcript chunks queued for extraction.

skipped
integer
required

Chunks already ingested earlier (idempotent resend).

jobIds
string<uuid>[]
required
redacted
integer
required

Secrets removed before anything was stored.

deferred
integer

Chunks not queued in this request (max 30 per request, or memory limit reached). Resend later; already-queued chunks are skipped.

limitExceeded
boolean
handoff
object