Skip to main content
GET
/
api
/
v1
/
skills
/
{id}
/
memories
List memories for a skill
curl --request GET \
  --url https://api.staging.getmodus.com/api/v1/skills/{id}/memories \
  --header 'Authorization: Bearer <token>'
{
  "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

Query Parameters

​
pageToken
string

Opaque page token from a previous response's nextPageToken. Omit for the first page. AIP-158.

Example:

"eyJvZmZzZXQiOjAsInBhZ2VTaXplIjoyNX0"

​
pageSize
number

Items per page. Defaults to 100 when no pagination params are sent (legacy); otherwise 25, clamped to 100.

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

100

​
userId
string

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

Example:

"user_clerk_X"

​
limit
number

Deprecated alias for pageSize (legacy default was 100). Prefer pageSize.

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

100

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"