Set Sync

Configure or disable recurring Slack history sync for a dataset.

Returns the stored settings, with the selection’s days window resolved into a fixed oldest date so the boundary does not move between runs. An invalid or missing selection returns 400, whether enabling or disabling; enabling without read, write and delete access to the target dataset returns 403.

Path Parameters

• team_id (str): Slack workspace (team) id whose sync settings are written. Configuring or disabling a sync is allowed only for the owner of the active Slack connection.

Request Parameters

• enabled (bool): When true the stored selection is refreshed on the interval and the caller is checked for access to its dataset; a selection is then required. Refreshes run only while the sync worker is enabled (worker_enabled on GET /api/v1/slack/history/{team_id}). When false the sync is turned off. Defaults to False.
• interval_seconds (int): How often the stored selection is refreshed once sync is enabled; after a run that did not complete, the next attempt comes after 600 seconds instead. Must be between 600 and 604800. Defaults to 21600.
• selection (Optional[SlackHistoryRequest]): Import selection naming the dataset to configure or disable; required in both cases, and its latest date must be unset. Its days window is resolved once and stored as a fixed oldest date.

PUT /api/v1/slack/history/{team_id}/sync

Set Sync

cURL

curl --request PUT \
  --url https://{tenant}.aws.cognee.ai/api/v1/slack/history/{team_id}/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "enabled": false,
  "selection": {
    "dataset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "channel_ids": [
      "<string>"
    ],
    "thread_links": [
      "<string>"
    ],
    "threads": [
      {
        "channel_id": "<string>",
        "ts": "<string>"
      }
    ],
    "days": 1825,
    "oldest": "2023-11-07T05:31:56Z",
    "latest": "2023-11-07T05:31:56Z",
    "thread_mode": "started",
    "max_requests": 1000,
    "max_messages": 50000
  },
  "interval_seconds": 21600
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

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

Path Parameters

team_id · string · required

Body

application/json

enabled · boolean · default: false

selection · SlackHistoryRequest · object | null

Date bounds select conversations; selected threads include all available replies.

started selects roots in the window. active also scans older roots and selects threads with a message in the window. Neither is a retention policy. Explicit thread links select entire conversations independently of the date window. All bounds are timezone-aware.

Show child attributes

interval_seconds · integer · default: 21600

Required range: 600 <= x <= 604800

Response

200

application/json

Successful Response

enabled · boolean · default: false

selection · SlackHistoryRequest · object | null

Date bounds select conversations; selected threads include all available replies.

started selects roots in the window. active also scans older roots and selects threads with a message in the window. Neither is a retention policy. Explicit thread links select entire conversations independently of the date window. All bounds are timezone-aware.

Show child attributes

interval_seconds · integer · default: 21600

Required range: 600 <= x <= 604800