Get connection (by provider)

POST/v3/connections/{provider}/connection

Get connection details with provider and container tags

Path ParametersExpand Collapse

provider: "notion" or "google-drive" or "onedrive" or 5 more

One of the following:

"notion"

"google-drive"

"onedrive"

"gmail"

"github"

"web-crawler"

"s3"

"granola"

Body ParametersJSONExpand Collapse

containerTags: array of string

Comma-separated list of container tags to filter connection 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]

Get connection (by provider)

curl https://api.supermemory.ai/v3/connections/$PROVIDER/connection \
    -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"
  }
}