Skip to main content
PATCH
/
v1
/
memory
/
contact
/
{memory_id}
/
facts
Update Contact Facts
curl --request PATCH \
  --url https://api.bland.ai/v1/memory/contact/{memory_id}/facts \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "facts": {}
}'
{
  "data": {
    "id": "mem-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "org_id": "11111111-2222-3333-4444-555555555555",
    "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "persona_id": "persona-12345678",
    "agent_number": null,
    "summary": "Customer is a premium plan subscriber.",
    "facts": {
      "name": "John Doe",
      "company": "Acme Corp",
      "role": "CTO",
      "preferred_contact": "phone",
      "timezone": "America/New_York"
    },
    "recent_messages": [...],
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T16:00:00.000Z"
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
memory_id
string
required
The unique identifier of the contact memory record.

​
Body Parameters

​
facts
object
required
Key-value pairs to merge with existing facts. New keys are added, existing keys are updated.

​
Response

​
data
object
The updated contact memory object.
​
data.id
string
Unique identifier for the contact memory.
​
data.facts
object
The merged facts object.
​
errors
null
Error array (null on success).

​
Facts Examples

Facts can store any structured information about the contact: 
{
  "facts": {
    "name": "John Doe",
    "company": "Acme Corp",
    "role": "CTO",
    "preferred_contact": "phone",
    "timezone": "America/New_York",
    "plan": "premium",
    "account_number": "ACC-12345"
  }
}

{
  "data": {
    "id": "mem-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "org_id": "11111111-2222-3333-4444-555555555555",
    "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "persona_id": "persona-12345678",
    "agent_number": null,
    "summary": "Customer is a premium plan subscriber.",
    "facts": {
      "name": "John Doe",
      "company": "Acme Corp",
      "role": "CTO",
      "preferred_contact": "phone",
      "timezone": "America/New_York"
    },
    "recent_messages": [...],
    "created_at": "2025-07-20T10:30:00.000Z",
    "updated_at": "2025-07-22T16:00:00.000Z"
  },
  "errors": null
}
Docs for agents: llms.txt