Get contact memory

Read the rolling memory brief kept for one contact.

GEThttps://api.tried.com.au/contacts/{id}/memory

Returns the contact's memory: a short brief rewritten after each conversation saved to it. Agents with contact_memory_config.enable_read receive it as {{contact_memory}}. Agents with contact_memory_config.enable_update save each ended call to it automatically. See Build agents for the agent settings.

Request#

Field	Type	Required	Description
`id`	string	Yes	Path parameter. The `contact_id`.

Example request#

curl https://api.tried.com.au/contacts/contact_4b8e2f1a9c3d5e7f6a0b2c4d/memory \
  -H "Authorization: Bearer $TRIED_API_KEY"

const id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d";
const res = await fetch(`https://api.tried.com.au/contacts/${id}/memory`, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const memory = await res.json();

import os, requests

contact_id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d"
res = requests.get(
    f"https://api.tried.com.au/contacts/{contact_id}/memory",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
memory = res.json()

Response#

200 OK

{
  "contact_id": "contact_4b8e2f1a9c3d5e7f6a0b2c4d",
  "memory": "- Prefers morning appointments.\n- Moved the Tuesday 3pm booking to Thursday 10am.\n- Asked for an SMS reminder the day before.",
  "memory_updated_timestamp": 1760853700000,
  "memory_conversation_count": 3
}

Field	Type	Description
`memory`	string or null	The brief, up to 2000 characters. `null` when empty.
`memory_updated_timestamp`	integer or null	Unix ms of the last change, by a saved conversation or by Update contact memory.
`memory_conversation_count`	integer	Conversations saved to memory.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `calls` scope.
`404`	`Contact <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.