Skip to Content
Recall
REST API

People

List the people named in a container's facts, and get one person with the facts that mention them.

See People for where people come from and how names are matched.

GET /v1/people

Lists the people in a container, most recently mentioned first.

NameTypeRequiredDefaultLimits
containerstringnoserver default1 to 128 characters
qstringnoup to 200 characters. Matches name, aliases, role, organization, emails and handles, ignoring case
sortrecent or namenorecentrecent: last mentioned first. name: A to Z
limitintegerno501 to 200
offsetintegerno0nextOffset from the previous page
curl "https://recall.zakiego.com/v1/people?container=alice&q=vorneo" \
  -H "Authorization: Bearer $RECALL_KEY"
{
  "container": "alice",
  "people": [
    {
      "id": "per_...",
      "container": "alice",
      "name": "Clara Simmons",
      "aliases": ["Clara"],
      "role": "Product designer",
      "organization": "Vorneo",
      "emails": ["clara.simmons@vorneo.id"],
      "handles": ["@clara.designs"],
      "summary": "Leads the Vorneo listing page redesign.",
      "factCount": 3,
      "lastMentionedAt": 1762737600000,
      "edited": false,
      "createdAt": 1762737600000,
      "updatedAt": 1762737600000
    }
  ],
  "total": 1,
  "nextOffset": null
}
FieldMeaning
factCountCurrent facts that mention them
lastMentionedAtWhen the newest fact that mentions them was written (any version), or null
editedtrue once someone edited them in the dashboard. Extraction then keeps their name, role, organization and summary

GET /v1/people/:id

One person and the facts that mention them, newest first.

NameTypeRequiredDefaultNotes
history1, 0, true, falsenofalseAlso include older versions of those facts
curl "https://recall.zakiego.com/v1/people/per_..." -H "Authorization: Bearer $RECALL_KEY"
{
  "person": { "id": "per_...", "name": "Clara Simmons", "...": "same fields as the list" },
  "facts": [
    {
      "id": "mem_...",
      "fact": "Meets Clara every Tuesday to review Figma mockups",
      "kind": "dynamic",
      "current": true,
      "createdAt": 1762737600000,
      "source": { "id": "doc_...", "title": "Weekly notes", "type": "text", "url": null }
    }
  ]
}

source is null for facts added by hand. reviewNote is present on facts flagged as conflicting. A person in another workspace, or one that was merged or deleted, returns 404 with {"error":{"type":"not_found","message":"no such person"}}.

Edits, merges and deletes are in the dashboard only.

On this page