---
title: "List connections"
method: POST
path: "/v3/connections/list"
tags: ["Connections"]
---

# List connections

`POST /v3/connections/list`

List all connections

## Request body

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

## Response `200`

Connections

- object[]
  - `createdAt` string, datetime, required
  - `documentLimit` number
  - `email` string
  - `expiresAt` string, datetime
  - `id` string, required
  - `metadata` object
  - `provider` string, required
  - `containerTags` string[]

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-03-12** `7386f0fb8043` — 1 warning
  - changed the pattern of the request property `containerTags/items/` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
- **2026-03-09** `8d6903994bad` — 1 breaking, 1 warning
  - added the pattern `^[a-zA-Z0-9_-]+$` to the request property `containerTags/items/`
  - the `containerTags/items/` request property's maxLength was set to `100`
- **2026-02-09** `4b4ababc7fb5` — 1 info
  - response property `items/containerTags` deprecated
- **2026-01-13** `c60ddacf028e` — 1 info
  - added the optional property `items/containerTags` to the response with the `200` status

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

---

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