Update contact memory

Replace or clear the memory brief of one contact.

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

Sets the contact's memory to the text you send, or clears it. Use it to correct the brief by hand. The change is free and does not count as a saved conversation.

Request#

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

Body:

Field	Type	Required	Description
`memory`	string or null	Yes	New brief, up to 2000 characters. `null`, an empty string or whitespace clears it.

Example request#

curl -X PUT https://api.tried.com.au/contacts/contact_4b8e2f1a9c3d5e7f6a0b2c4d/memory \
  -H "Authorization: Bearer $TRIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "memory": "- Prefers morning appointments.\n- Speaks Vietnamese and English." }'

const id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d";
const res = await fetch(`https://api.tried.com.au/contacts/${id}/memory`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.TRIED_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ memory: "- Prefers morning appointments.\n- Speaks Vietnamese and English." }),
});
const contact = await res.json();

import os, requests

contact_id = "contact_4b8e2f1a9c3d5e7f6a0b2c4d"
res = requests.put(
    f"https://api.tried.com.au/contacts/{contact_id}/memory",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    json={"memory": "- Prefers morning appointments.\n- Speaks Vietnamese and English."},
)
contact = res.json()

Response#

200 OK

The contact with its memory fields.

{
  "contact_id": "contact_4b8e2f1a9c3d5e7f6a0b2c4d",
  "phone_number": "+61412345678",
  "first_name": "Sam",
  "last_name": "Nguyen",
  "email": "sam@example.com",
  "custom_fields": { "plan": "Pro" },
  "do_not_call": false,
  "created_timestamp": 1760850000000,
  "last_modification_timestamp": 1760857200000,
  "memory": "- Prefers morning appointments.\n- Speaks Vietnamese and English.",
  "memory_updated_timestamp": 1760857200000,
  "memory_conversation_count": 3
}

The memory fields are described in Get contact memory, the others in Create contact.

Errors#

Status	When
`400`	Body fails validation, for example `memory: String must contain at most 2000 character(s)`.
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request, or the caller has the read-only member role. This route needs the `calls` scope.
`404`	`Contact <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.