---
title: "List documents"
method: POST
path: "/v3/connections/{provider}/documents"
tags: ["Connections"]
---

# List documents

`POST /v3/connections/{provider}/documents`

List documents indexed for a provider and container tags

## Path parameters

- `provider` 'notion' | 'google-drive' | 'onedrive' | 'gmail' | 'github' | 'web-crawler' | 's3' | 'granola', required

## Request body

- object
  - `containerTags` string[] — Optional comma-separated list of container tags to filter documents by

## Response `200`

List of documents

- object[]
  - `createdAt` string, datetime, required
  - `id` string, nullable, required
  - `status` string, required
  - `summary` string, nullable, required
  - `title` string, nullable, required
  - `type` string, required
  - `updatedAt` string, datetime, required

## Other responses

- `401` — Unauthorized
- `404` — Provider not found
- `500` — Internal server error

## Changes

- **2026-08-15** `b8c2dbc8f2b5` — 2 breaking
  - response property `items/id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `items/status` response's property type/format changed from `string`/`datetime` to `string`/`` for status `200`

[Change history](https://skmtc.dev/supermemory/apis/supermemory-api/changes/v3/connections/:provider/documents/post.md)

---

[API](https://skmtc.dev/supermemory/apis/supermemory-api.md) · [All operations](https://skmtc.dev/supermemory/apis/supermemory-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supermemory/supermemory-api/revisions/b8c2dbc8f2b5/schema)