ContactMemory

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

https://api.gleap.io/v3/sessions/{sessionId}/memory

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Path parameters

sessionIdstringrequired

Headers

projectstringrequired

Bodyapplication/jsonrequired

namestringrequired

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

descriptionstring

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

contentstringrequired

Required. Truncated to 4000 characters.

Response

application/json

okbooleanrequired

reasonenum<string>

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

Allowed values: disabledno_userIdinvalid_inputsession_not_found

consolidationEnqueuedboolean

entriesnumber<double>

Updated November 1, 2026

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

{
  "ok": true,
  "reason": "disabled",
  "consolidationEnqueued": true,
  "entries": 0
}