Create or update a contact memory entry

Create or upsert a memory entry by name. Returns { ok: true, entries: <count after the write> }; invalid input returns 400 and an unknown session 404. Staff writes work even when the project’s contact-memory feature is disabled.

POST /sessions/{sessionId}/memory

Create or update a contact memory entry

cURL

curl --request POST \
  --url https://api.gleap.io/v3/sessions/{sessionId}/memory \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'project: <project>' \
  --data '
{
  "name": "<string>",
  "content": "<string>",
  "description": "<string>"
}
'

200

{
  "ok": true,
  "consolidationEnqueued": true,
  "entries": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

project · string · required

Path Parameters

sessionId · string · required

Body

application/json

name · string · required

Trimmed and truncated to 80 characters; the entry is keyed by this value.

content · string · required

Required. Truncated to 4000 characters.

description · string

Optional. Omitting it clears the stored description on update (full replace). Truncated to 240 characters.

Response

200 - application/json

Ok

ok · boolean · required

reason · enum<string>

Only set on internal (non-admin) calls; never present in an admin API 200 response.

Available options: disabled, no_userId, invalid_input, session_not_found

consolidationEnqueued · boolean

entries · number<double>