Skip to main content
POST
/
api
/
v1
/
skills
/
{id}
/
memories
/
search
curl --request POST \
  --url https://api.staging.getmodus.com/api/v1/skills/{id}/memories/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "user preferences for response style"
}
'
{
  "memories": [
    {
      "id": "mem_01HRQX...ABC",
      "memory": "User prefers concise summaries with bullet points.",
      "hash": "<string>",
      "metadata": {
        "source": "agent_run_42",
        "topic": "preferences"
      },
      "createdAt": "2026-05-01T10:00:00.000Z",
      "updatedAt": "2026-05-01T10:00:00.000Z"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjI1LCJwYWdlU2l6ZSI6MjV9"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
number
required

Numeric skill id.

Example:

42

Body

application/json
​
query
string
required

Search query string (semantic search over the skill's memories).

Example:

"user preferences for response style"

​
userId
string

Narrow results to memories tagged with this end-user id (mem0 per-user scope).

Example:

"user_clerk_X"

​
limit
number

Override the default page size for search results (legacy default is 10).

Required range: 1 <= x <= 1000
Example:

10

Response

​
memories
object[]
required

Memories belonging to the skill.

​
nextPageToken
string | null
required

Opaque token for the next page; null when this was the last page. Pass as pageToken on the next request. AIP-158.

Example:

"eyJvZmZzZXQiOjI1LCJwYWdlU2l6ZSI6MjV9"