Rename Channel

Rename a Slack channel.

By default, only the user that created the channel or a user who's a workspace admin or owner can rename a channel.

If your workspace has a large number of channels, this card may exceed the 60 second time limit while trying to populate the Channel dropdown list. This timeout can also occur when testing a card.

Options

Field Definition Type Required
Channel List of available channels.

This field shows a maximum of 200 public channels and 200 private channels. Even if the number of public or private channels is fewer than 200, API limitations may prevent some channels from appearing in the Channel dropdown list.

The dropdown displays only unarchived channels where the user who created the Slack connection is a member. To specify an unlisted public or private channel, select the Enter Channel ID option and enter the Channel ID.

If a failure occurs and no channels are listed in the dropdown, then only the Enter Channel ID option appears.

Dropdown TRUE

Input

Field Definition Type Required
Channel
Channel ID Unique identifier of the Slack channel. This field appears when Channel is set to -- Enter Channel ID --. String TRUE
Rename
Name New name for the channel selected in Channel or specified by Channel ID. String TRUE

Output

Field Definition Type
Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

String

Related topics

Slack connector

Workflow elements

Slack API