integrations

Set Integration Resources

Persist a full resource selection for a connected integration.

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.

Request Parameters

resourceIds (Optional[List[str]]): Full replacement list of selected resource ids; duplicates are dropped, blank or whitespace-only ids give 422. Null (also the value when omitted) means every resource and is a 422 for providers that do not allow it.

PUT

api

integrations

{provider}

labels

Set Integration Resources

curl --request PUT \
  --url https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/labels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resourceIds": [
    "<string>"
  ]
}
'

import requests

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

payload = { "resourceIds": ["<string>"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "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

Body

application/json

resourceIds

string[] | null

Response

Successful Response

selected

string[] | null

⌘I

Set Integration Resources

curl --request PUT \
  --url https://{tenant}.aws.cognee.ai/api/v1/integrations/{provider}/labels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resourceIds": [
    "<string>"
  ]
}
'

import requests

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

payload = { "resourceIds": ["<string>"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

{
  "selected": [
    "<string>"
  ]
}

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