Skip to content
Get started

List connections

POST/v3/connections/list

List all connections

Body ParametersJSONExpand Collapse
containerTags: optional array of string

Optional comma-separated list of container tags to filter documents by

ReturnsExpand Collapse
id: string
createdAt: string
formatdatetime
provider: string
DeprecatedcontainerTags: optional array of string
documentLimit: optional number
email: optional string
expiresAt: optional string
formatdatetime
lastSyncRun: optional object { status, completedAt, error, 2 more }
status: string
completedAt: optional string
formatdatetime
error: optional string
errorCode: optional "auth_expired" or "rate_limited" or "plan_required" or 2 more
One of the following:
"auth_expired"
"rate_limited"
"plan_required"
"provider_unavailable"
"internal"
startedAt: optional string
formatdatetime
metadata: optional map[unknown]

List connections

curl https://api.supermemory.ai/v3/connections/list \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -d '{
          "containerTags": [
            "user_123",
            "project_123"
          ]
        }'
[
  {
    "id": "id",
    "createdAt": "createdAt",
    "provider": "provider",
    "containerTags": [
      "string"
    ],
    "documentLimit": 0,
    "email": "email",
    "expiresAt": "expiresAt",
    "lastSyncRun": {
      "status": "status",
      "completedAt": "completedAt",
      "error": "error",
      "errorCode": "auth_expired",
      "startedAt": "startedAt"
    },
    "metadata": {
      "foo": "bar"
    }
  }
]
Returns Examples
[
  {
    "id": "id",
    "createdAt": "createdAt",
    "provider": "provider",
    "containerTags": [
      "string"
    ],
    "documentLimit": 0,
    "email": "email",
    "expiresAt": "expiresAt",
    "lastSyncRun": {
      "status": "status",
      "completedAt": "completedAt",
      "error": "error",
      "errorCode": "auth_expired",
      "startedAt": "startedAt"
    },
    "metadata": {
      "foo": "bar"
    }
  }
]