/AWS1/CL_CHS=>LISTCHANNELS()
¶
About ListChannels¶
Lists all Channels created under a single Chime App as a paginated list. You can specify filters to narrow results.
Functionality & restrictions
-
Use privacy =
PUBLIC
to retrieve all public channels in the account. -
Only an
AppInstanceAdmin
can set privacy =PRIVATE
to list the private channels in an account.
The x-amz-chime-bearer
request header is mandatory. Use the
ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in
the header.
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_APPINSTANCEARN
TYPE /AWS1/CHSCHIMEARN
/AWS1/CHSCHIMEARN
¶
The ARN of the
AppInstance
.
IV_CHIMEBEARER
TYPE /AWS1/CHSCHIMEARN
/AWS1/CHSCHIMEARN
¶
The ARN of the
AppInstanceUser
orAppInstanceBot
that makes the API call.
Optional arguments:¶
IV_PRIVACY
TYPE /AWS1/CHSCHANNELPRIVACY
/AWS1/CHSCHANNELPRIVACY
¶
The privacy setting.
PUBLIC
retrieves all the public channels.PRIVATE
retrieves private channels. Only anAppInstanceAdmin
can retrieve private channels.
IV_MAXRESULTS
TYPE /AWS1/CHSMAXRESULTS
/AWS1/CHSMAXRESULTS
¶
The maximum number of channels that you want to return.
IV_NEXTTOKEN
TYPE /AWS1/CHSNEXTTOKEN
/AWS1/CHSNEXTTOKEN
¶
The token passed by previous API calls until all requested channels are returned.