List memories

Retrieve paginated memories for a project, with optional search and filtering.

GET /v1/projects/{projectId}/memory

List memories

cURL

curl --request GET \
  --url https://api.example.com/v1/projects/{projectId}/memory

200

{
  "data": [
    {
      "id": "<string>",
      "content": "<string>",
      "category": "<string>",
      "summary": "<string>",
      "status": "<string>",
      "linkedNodeIds": [
        {}
      ],
      "entities": [
        {}
      ],
      "confidence": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

projectId · string · required

Project UUID.

q · string

Search query. Uses semantic similarity matching via vector embeddings.

category · string

Filter by category. One of decision, learning, progress, preference.

status · string

Filter by status. One of active, superseded, conflicting, archived.

cursor · string

Pagination cursor.

limit · number · default: "20"

Items per page (1-100).

data · array

Show Memory object

id · string · required

UUID

content · string · required

Memory content (1-10,000 chars)

category · string

decision, learning, progress, or preference

summary · string

Auto-generated summary

status · string · required

active, superseded, conflicting, or archived

linkedNodeIds · array

Associated node UUIDs

entities · array

Extracted entities

confidence · number

Confidence score

createdAt · string · required

ISO 8601

updatedAt · string · required

ISO 8601

nextCursor · string

Request

curl "https://api.getkommit.ai/v1/projects/a1b2c3d4-e5f6-7890-abcd-ef1234567890/memory?category=decision&limit=5" \
  -H "Authorization: Bearer km_your_api_key"