Get connection (by provider)

JavaScript

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({containerTags: ['user_123', 'project_123']})
};

fetch('https://api.supermemory.ai/v3/connections/{provider}/connection', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Status Codes

• 200
• 401
• 404
• 500

Response Example

{
  "createdAt": "<string>",
  "id": "<string>",
  "provider": "<string>",
  "documentLimit": 123,
  "email": "<string>",
  "expiresAt": "<string>",
  "metadata": {},
  "containerTags": [
    "<string>"
  ]
}

Authorizations

Authorization: string (header, required)

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

provider: enum (required)

Available options:

• notion
• google-drive
• onedrive
• gmail
• github
• web-crawler
• s3

Body

containerTags: string[] (required)

Comma-separated list of container tags to filter connection by.

• Minimum array length: 1
• Maximum string length: 100
• Pattern: ^[a-zA-Z0-9_:-]+$

Example:

["user_123", "project_123"]

Response Structure

200 (application/json): Connection details

• createdAt: string (required)
• id: string (required)
• provider: string (required)
• documentLimit: number
• email: string
• expiresAt: string
• metadata: object
• containerTags: string[] (deprecated)