Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-253903.6 MB
Documents

List documents

Retrieves a paginated list of documents with their metadata and workflow status

post/v3/documents/list

Request body

containerTagsstring[]

Optional tags this document should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to group documents.

includeContentboolean

Whether to include the content field in the response. Warning: This can make responses significantly larger.

order'asc' | 'desc'

Sort order

sort'createdAt' | 'updatedAt'

Field to sort by

filepathstring

Filter documents by filepath. Exact match for full paths, prefix match if ending with /

Example request

{
  "filters": {
    "AND": [
      {
        "filterType": "metadata",
        "key": "group",
        "negate": false,
        "value": "jira_users"
      },
      {
        "filterType": "numeric",
        "key": "timestamp",
        "negate": false,
        "numericOperator": ">",
        "value": "1742745777"
      }
    ]
  },
  "limit": 10,
  "order": "desc",
  "page": 1,
  "sort": "createdAt"
}

Response

Successfully retrieved documents

Example response

{
  "memories": [
    {
      "connectionId": "conn_123",
      "containerTags": [
        "user_123"
      ],
      "createdAt": "1970-01-01T00:00:00.000Z",
      "customId": "mem_abc123",
      "id": "acxV5LHMEsG2hMSNb4umbn",
      "metadata": {
        "category": "technology",
        "isPublic": true,
        "readingTime": 5,
        "source": "web",
        "tag_1": "ai",
        "tag_2": "machine-learning"
      },
      "status": "done",
      "summary": "A comprehensive guide to understanding the basics of machine learning and its applications.",
      "title": "Introduction to Machine Learning",
      "type": "text",
      "updatedAt": "1970-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "limit": 10,
    "totalItems": 100,
    "totalPages": 10
  }
}