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.

Note

This card may timeout while trying to populate the Channel dropdown. This can occur when your workspace has a large number of channels that can't be retrieved within a 60 second time limit. This timeout can also occur when testing a card.

Options

Field Definition Type Required
Channel List of available channels.
Caution

A maximum of 200 public channels and 200 private channels are displayed. Even if the number of public (or private) channels don't exceed 200, API limitations may prevent some channels from being listed in the Channel dropdown.

The dropdown will display only those unarchived channels of which the user who created the Slack connection is a member. To specify a public or private channel that is not listed, select the Enter Channel ID option and populate the Channel ID input field.

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

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

Elements of Workflows

Slack API