AGNTDocs

Context

Memories

Facts and preferences the assistant saves and recalls for each user.

GET/memories

List memories

Returns the user's memories, filtered by `tags`, `type`, `scope` or a text search.

Query parameters

pageinteger
perPageinteger
tagsstringComma-separated tag filter
typestring
searchstring
scopestring
contactEmailstringShorthand for tags=contact:<email>
companyIdstringShorthand for tags=company:<id>

Responses

200Paginated memory list
ok reqenumtrue
memories reqobject[]
id reqstring
account reqstring
user reqstring
kindenumunstructuredstructured
resourceTypestring | null
tags reqstring[]
contentstring | null
dataobject | null
source reqenumsystemuser
scopeenumuserteam
visibilityenumauthor_onlycoordinatorsall
authoredBystring | null
assistantstring | null
teamstring | null
startDatestring | null
endDatestring | null
isActive reqboolean
isExpired reqboolean
pinnedboolean
metadataobject
createdAt reqstring
updatedAt reqstring
pageinteger
perPageinteger
totalinteger
401No user on the call: send X-User-Email with an account key, or use a user-scoped key
statusinteger
error_codestring
errorstring

Request

curl 'https://api.agnt.ai/memories' \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]"

Response

{
  "ok": true,
  "memories": [
    {
      "id": "6702c7f3a4b5c6d7e8f9a0b1",
      "user": "6702b1e8f9a0b1c2d3e4f5a6",
      "content": "Prefers vendor quotes summarized in a table with price, lead time and warranty.",
      "tags": [
        "general"
      ],
      "source": "user",
      "scope": "user",
      "isActive": true,
      "createdAt": "2026-10-01T15:04:05Z"
    }
  ]
}
POST/memories

Create a memory

Saves a memory for the user. Tags come from a fixed vocabulary, and a `date-memory` requires `startDate`.

Request body

content reqstringThe fact to remember
tagsstring[]At least one; defaults to general. Use general, profile, date-memory or assistant-style, or a prefix: contact:<email>, company:<id>, event:<id>, task:<id>, file:<id>, workflow:<id>, skill:<name>, repo:<owner/repo>, title:<text>, profile:<slot>.
scopeenumteam shares it with a team the user belongs touserteam
teamstringTeam id, with scope team
startDatestringRequired with the date-memory tag
endDatestring
metadataobject

Responses

201Created memory
ok reqenumtrue
memory reqobject
id reqstring
account reqstring
user reqstring
kindenumunstructuredstructured
resourceTypestring | null
tags reqstring[]
contentstring | null
dataobject | null
source reqenumsystemuser
scopeenumuserteam
visibilityenumauthor_onlycoordinatorsall
authoredBystring | null
assistantstring | null
teamstring | null
startDatestring | null
endDatestring | null
isActive reqboolean
isExpired reqboolean
pinnedboolean
metadataobject
createdAt reqstring
updatedAt reqstring
400A tag outside the vocabulary, or a date-memory without startDate
status reqinteger
error_codestring
error reqstring
401No user on the call: send X-User-Email with an account key, or use a user-scoped key
statusinteger
error_codestring
errorstring

Request

curl 'https://api.agnt.ai/memories' \
  -X POST \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Prefers vendor quotes summarized in a table with price, lead time and warranty.",
  "tags": [
    "general"
  ]
}'

Response

{
  "ok": true,
  "memory": {
    "id": "6702c7f3a4b5c6d7e8f9a0b1",
    "user": "6702b1e8f9a0b1c2d3e4f5a6",
    "content": "Prefers vendor quotes summarized in a table with price, lead time and warranty.",
    "tags": [
      "general"
    ],
    "source": "user",
    "scope": "user",
    "isActive": true,
    "createdAt": "2026-10-01T15:04:05Z"
  }
}
GET/memories/{memoryId}

Retrieve a memory

Retrieves one of the user's memories.

Path parameters

memoryId reqstring

Responses

200Memory
ok reqenumtrue
memory reqobject
id reqstring
account reqstring
user reqstring
kindenumunstructuredstructured
resourceTypestring | null
tags reqstring[]
contentstring | null
dataobject | null
source reqenumsystemuser
scopeenumuserteam
visibilityenumauthor_onlycoordinatorsall
authoredBystring | null
assistantstring | null
teamstring | null
startDatestring | null
endDatestring | null
isActive reqboolean
isExpired reqboolean
pinnedboolean
metadataobject
createdAt reqstring
updatedAt reqstring
401No user on the call: send X-User-Email with an account key, or use a user-scoped key
statusinteger
error_codestring
errorstring
404Not found
status reqinteger
error_codestring
error reqstring

Request

curl 'https://api.agnt.ai/memories/<memoryId>' \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]"

Response

{
  "ok": true,
  "memory": {
    "id": "6702c7f3a4b5c6d7e8f9a0b1",
    "user": "6702b1e8f9a0b1c2d3e4f5a6",
    "content": "Prefers vendor quotes summarized in a table with price, lead time and warranty.",
    "tags": [
      "general"
    ],
    "source": "user",
    "scope": "user",
    "isActive": true,
    "createdAt": "2026-10-01T15:04:05Z"
  }
}
PUT/memories/{memoryId}

Update a memory

Updates a memory. Only the fields you send change, and tags are validated as on create.

Path parameters

memoryId reqstring

Request body

contentstring
tagsstring[]
scopeenumuserteam
teamstring | null
startDatestring | null
endDatestring | null
metadataobject

Responses

200Updated memory
ok reqenumtrue
memory reqobject
id reqstring
account reqstring
user reqstring
kindenumunstructuredstructured
resourceTypestring | null
tags reqstring[]
contentstring | null
dataobject | null
source reqenumsystemuser
scopeenumuserteam
visibilityenumauthor_onlycoordinatorsall
authoredBystring | null
assistantstring | null
teamstring | null
startDatestring | null
endDatestring | null
isActive reqboolean
isExpired reqboolean
pinnedboolean
metadataobject
createdAt reqstring
updatedAt reqstring
401No user on the call: send X-User-Email with an account key, or use a user-scoped key
statusinteger
error_codestring
errorstring

Request

curl 'https://api.agnt.ai/memories/<memoryId>' \
  -X PUT \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Prefers vendor quotes summarized in a table with price, lead time, warranty and insurance expiry.",
  "tags": [
    "general"
  ]
}'

Response

{
  "ok": true,
  "memory": {
    "id": "6702c7f3a4b5c6d7e8f9a0b1",
    "user": "6702b1e8f9a0b1c2d3e4f5a6",
    "content": "Prefers vendor quotes summarized in a table with price, lead time and warranty.",
    "tags": [
      "general"
    ],
    "source": "user",
    "scope": "user",
    "isActive": true,
    "createdAt": "2026-10-01T15:04:05Z"
  }
}
DELETE/memories/{memoryId}

Delete a memory

Deletes a memory.

Path parameters

memoryId reqstring

Responses

200Deleted
ok reqenumtrue
memory reqobject
id reqstring
deletedboolean
messagestring
401No user on the call: send X-User-Email with an account key, or use a user-scoped key
statusinteger
error_codestring
errorstring

Request

curl 'https://api.agnt.ai/memories/<memoryId>' \
  -X DELETE \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]"

Response

{
  "ok": true,
  "memory": {
    "id": "6660c4a1f2e3b7d8a9c01234"
  }
}