---
title: "Replace the settings of the brand's Slack destination; paused pauses or resumes it. Keeping its channel does not check Slack, so a destination whose channel or connection broke can still be paused or edited; choosing another channel or workspace clears its error."
method: PUT
path: "/v2/settings/brands/{brand-id}/slack-destinations/{destination-id}"
tags: ["Brand Slack Destinations Api Service"]
---

# Replace the settings of the brand's Slack destination; paused pauses or resumes it. Keeping its channel does not check Slack, so a destination whose channel or connection broke can still be paused or edited; choosing another channel or workspace clears its error.

`PUT /v2/settings/brands/{brand-id}/slack-destinations/{destination-id}`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/brands/{brand-id}/slack-destinations/{destination-id}`
- Auth: none declared

## Path parameters

- `brand-id` integer, required
- `destination-id` integer, required

## Request body

- SaveSlackDestinationRequest: The settings of a brand's Slack destination.
  - `connectionId` integer, required: Id of an active Slack connection of the brand's organization.
  - `channelId` string, required: Id of a channel of that connection's workspace.
  - `events` string[], required: Notification events to send, from GET .../slack-destinations/available-events.
  - `language` string, nullable: Language of the messages. Defaults to the language of the user saving it.
  - `paused` boolean, nullable: Whether the destination is paused. Defaults to false.

## Response `200`

Destination updated.

- JsonOkResponseSlackDestinationDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` SlackDestinationDto: Where a brand sends its notifications in Slack.
    - `id` integer: Id of the destination.
    - `connectionId` integer: Id of the organization's Slack connection it uses.
    - `workspace` SlackWorkspaceDto: A Slack workspace.
      - `teamId` string: Id Slack assigns to the workspace (team id).
      - `name` string: Name of the workspace.
    - `channelId` string: Id of the channel the notifications go to.
    - `channelName` string: Name of that channel when it was chosen, without the #.
    - `events` string[]: The notification events sent to the channel.
    - `language` string: Language of the messages.
    - `paused` boolean: Whether the user paused it: it keeps its settings but sends nothing until resumed.
    - `status` 'active' | 'channelArchived' | 'channelNotFound' | 'notInChannel' | 'restricted' | 'messageLimitReached': Whether the channel still accepts messages, or why it stopped. messageLimitReached: the workspace reached Slack's message limit; the destination keeps sending.
    - `createdBy` SlackConnectionCreatorDto, nullable: The user who connected the Slack workspace.
      - `name` string: First name and last name of the user, or their email when they have no first name.
      - `profilePicture` string, nullable: URL of the user's profile picture. Null when they have none, and the front shows their initials instead.
    - `createdAt` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime

## Other responses

- `400`: Same as creating it.
- `403`: Caller is not a regular-user session or lacks editBrand on the brand (a team member with manageBrands in its organization has it). Also slackPlanRequired: the brand's organization cannot use Slack (slack-availability locked or planLocked).
- `404`: The brand has no such destination.
- `409`: slackDestinationBeingSaved: another save of it is running.
- `502`: slackUnavailable: Slack could not be read to check a new channel.
- `503`: slackChannelsSyncing: the copy of the channels is being built for the first time by another request; retry in a few seconds.

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)