Chime / Client / create_channel_membership
create_channel_membership#
- Chime.Client.create_channel_membership(**kwargs)#
Adds a user to a channel. The
InvitedBy
response field is derived from the request header. A channel member can:List messages
Send messages
Receive messages
Edit their own messages
Leave the channel
Privacy settings impact this action as follows:
Public Channels: You do not need to be a member to list messages, but you must be a member to send messages.
Private Channels: You must be a member to list or send messages.
Note
The
x-amz-chime-bearer
request header is mandatory. Use theAppInstanceUserArn
of the user that makes the API call as the value in the header.See also: AWS API Documentation
Request Syntax
response = client.create_channel_membership( ChannelArn='string', MemberArn='string', Type='DEFAULT'|'HIDDEN', ChimeBearer='string' )
- Parameters:
ChannelArn (string) –
[REQUIRED]
The ARN of the channel to which you’re adding users.
MemberArn (string) –
[REQUIRED]
The ARN of the member you want to add to the channel.
Type (string) –
[REQUIRED]
The membership type of a user,
DEFAULT
orHIDDEN
. Default members are always returned as part ofListChannelMemberships
. Hidden members are only returned if the type filter inListChannelMemberships
equalsHIDDEN
. Otherwise hidden members are not returned. This is only supported by moderators.ChimeBearer (string) – The
AppInstanceUserArn
of the user that makes the API call.
- Return type:
dict
- Returns:
Response Syntax
{ 'ChannelArn': 'string', 'Member': { 'Arn': 'string', 'Name': 'string' } }
Response Structure
(dict) –
ChannelArn (string) –
The ARN of the channel.
Member (dict) –
The ARN and metadata of the member being added.
Arn (string) –
The ARN in an Identity.
Name (string) –
The name in an Identity.
Exceptions
Chime.Client.exceptions.BadRequestException
Chime.Client.exceptions.ForbiddenException
Chime.Client.exceptions.UnauthorizedClientException
Chime.Client.exceptions.ConflictException
Chime.Client.exceptions.ResourceLimitExceededException
Chime.Client.exceptions.ThrottledClientException
Chime.Client.exceptions.ServiceUnavailableException
Chime.Client.exceptions.ServiceFailureException