RegisterSlackWorkspaceForOrganization - AWS Support App in Slack

RegisterSlackWorkspaceForOrganization

Registers a Slack workspace for your AWS account. To call this API, your account must be part of an organization in AWS Organizations.

If you're the management account and you want to register Slack workspaces for your organization, you must complete the following tasks:

  1. Sign in to the AWS Support Center and authorize the Slack workspaces where you want your organization to have access to. See Authorize a Slack workspace in the AWS Support User Guide.

  2. Call the RegisterSlackWorkspaceForOrganization API to authorize each Slack workspace for the organization.

After the management account authorizes the Slack workspace, member accounts can call this API to authorize the same Slack workspace for their individual accounts. Member accounts don't need to authorize the Slack workspace manually through the AWS Support Center.

To use the AWS Support App, each account must then complete the following tasks:

Request Syntax

POST /control/register-slack-workspace-for-organization HTTP/1.1 Content-type: application/json { "teamId": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

teamId

The team ID in Slack. This ID uniquely identifies a Slack workspace, such as T012ABCDEFG. Specify the Slack workspace that you want to use for your organization.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: ^\S+$

Required: Yes

Response Syntax

HTTP/1.1 200 Content-type: application/json { "accountType": "string", "teamId": "string", "teamName": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

accountType

Whether the AWS account is a management or member account that's part of an organization in AWS Organizations.

Type: String

Valid Values: management | member

teamId

The team ID in Slack. This ID uniquely identifies a Slack workspace, such as T012ABCDEFG.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: ^\S+$

teamName

The name of the Slack workspace.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: ^.+$

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have sufficient permission to perform this action.

HTTP Status Code: 403

ConflictException

Your request has a conflict. For example, you might receive this error if you try the following:

  • Add, update, or delete a Slack channel configuration before you add a Slack workspace to your AWS account.

  • Add a Slack channel configuration that already exists in your AWS account.

  • Delete a Slack channel configuration for a live chat channel.

  • Delete a Slack workspace from your AWS account that has an active live chat channel.

  • Call the RegisterSlackWorkspaceForOrganization API from an AWS account that doesn't belong to an organization.

  • Call the RegisterSlackWorkspaceForOrganization API from a member account, but the management account hasn't registered that workspace yet for the organization.

HTTP Status Code: 409

InternalServerException

We can’t process your request right now because of a server issue. Try again later.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource is missing or doesn't exist, such as an account alias, Slack channel configuration, or Slack workspace configuration.

HTTP Status Code: 404

ValidationException

Your request input doesn't meet the constraints that the AWS Support App specifies.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: