---
title: "Refresh the Slack channel catalog"
method: POST
path: "/v1/integrations/slack/channels/refresh"
tags: ["integrations"]
---

# Refresh the Slack channel catalog

`POST /v1/integrations/slack/channels/refresh`

Queue a fresh walk of the workspace's channels into the local catalog.

## Query parameters

- `installation_id` string, uuid, required — Slack installation ID

## Response `200`

Slack channel selection with a refreshed catalog sync in progress

- SlackChannelSelectionResponse — Slack channel selection response.
  - `data` SlackChannelSelection, required — Slack channel selection for a store connector.
    - `is_installed` boolean, required — Whether Slack is installed for the organization
    - `installation_id` string, nullable — Slack installation ID
    - `team_id` string, nullable — Slack team ID
    - `team_name` string, nullable — Slack team name
    - `store_id` string, nullable — Mixedbread store ID
    - `store_name` string, nullable — Mixedbread store name
    - `channels` SlackChannel[], required — Public Slack channels for the current page
      - `id` string, required — Slack channel ID
      - `name` string, required — Slack channel name
      - `is_archived` boolean, required — Whether the Slack channel is archived
      - `is_member` boolean, required — Whether the Slack app bot is a member
      - `is_selected` boolean, required — Whether this channel is selected for store ingestion
      - `num_members` integer, nullable — Approximate Slack channel member count
      - `sync_status` 'syncing' | 'not_syncing' | 'error' — Current Slack ingestion status
      - `last_synced_at` string, date-time, nullable — Last successful Slack sync time
      - `sync_error` string, nullable — Last Slack sync error
      - `sync_error_retryable` boolean — Whether retrying the channel-level Slack sync error may succeed
      - `last_sync_status` 'queued' | 'in_progress' | 'completed' | 'skipped' | 'error', nullable — Most recent Slack history import status
      - `last_sync_started_at` string, date-time, nullable — Most recent Slack history import start time
      - `last_sync_completed_at` string, date-time, nullable — Most recent Slack history import completion time
      - `last_sync_message_count` integer, nullable — Messages fetched in the last Slack history import
      - `last_sync_store_file_count` integer, nullable — Store files written in the last Slack history import
      - `last_sync_skipped_message_count` integer, nullable — Timeline messages skipped as non-ingestable (bot/app posts, system events)
      - `last_sync_run_id` string, nullable — Most recent Slack history import run ID
      - `syncs_in_progress` integer — Number of active Slack history imports for this channel
      - `last_sync_warning` string, nullable — Most recent Slack item-level sync warning
      - `last_sync_failed_item_count` integer — Number of Slack items that failed in the most recent import
      - `last_sync_failed_items` SlackItemFailure[] — Bounded, user-safe Slack item failures from the most recent import
        - `code` string, required — Stable Slack item failure code
        - `message` string, required — User-safe explanation of the failure
        - `retryable` boolean, required — Whether retrying the item may succeed without user changes
        - `source_message_ts` string, nullable — Slack timestamp for the message associated with the failed item
        - `source_url` string, nullable — Slack permalink for the message associated with the failed item
    - `selected_channel_ids` string[] — Every Slack channel ID selected for ingestion, across all pages
    - `next_cursor` string, nullable — Cursor for the next page of Slack channels, or null when there are no more
    - `catalog_status` 'pending' | 'syncing' | 'ready' | 'failed' — State of the background channel-catalog sync that backs this listing
    - `total_channels` integer — Total channels matching the current search across all pages
    - `history_imports_in_progress` integer — Total active Slack history imports across all channels

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/versions/2eece97b5ae5/schema)