integrations

Integration Resources

List selectable resources for a connected integration.

/folders and /labels are readable aliases for SDK callers that want provider vocabulary; /resources is the stable generic path. The returned selection is three-state: null means all resources, an empty list means none, and a non-empty list is an allowlist.

Path Parameters

provider (str): Key of a registered OAuth provider (see GET /api/v1/integrations/status).

Query Parameters

account_id (Optional[str]): Connection to use (from GET /api/v1/integrations/{provider}/connections); the newest one is used when omitted. An id that is not the caller’s returns 404 and never falls back to another connection; a blank id returns 422.

GET

api

integrations

{provider}

folders

Integration Resources

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/folders \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/folders"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "resources": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "attributes": {},
      "selected": false
    }
  ],
  "selected": [
    "<string>"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

provider

string

required

Query Parameters

account_id

string | null

Response

Successful Response

resources

IntegrationResourceDTO · object[]

required

Show child attributes

selected

string[] | null

⌘I

Integration Resources

curl --request GET \
  --url https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/folders \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/folders"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "resources": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "attributes": {},
      "selected": false
    }
  ],
  "selected": [
    "<string>"
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}