channel resource type
Namespace: microsoft.graph
Teams are made up of channels, which are the conversations you have with your teammates. Each channel is dedicated to a specific topic, department, or project. Channels are where the work actually gets done - where text, audio, and video conversations open to the whole team happen, where files are shared, and where tabs are added.
Methods
Method | Return Type | Description |
---|---|---|
List channels | channel collection | Get the list of channels in a team. |
List incoming channels | channel collection | Get the list of incoming channels (channels shared with a team). |
List all channels | channel collection | Get the list of channels either in a team or shared with a team (incoming channels). |
Create channel | channel | Create a new channel by including the display name and description. |
Get channel | channel | Read properties and relationships of the channel. |
Update channel | channel | Update properties of the channel. |
Delete channel | None | Delete a channel. |
Get message delta | chatMessage | Get incremental messages in a channel. |
List channel messages | chatMessage | Get messages in a channel |
Get all channel messages | channel collection | Get all messages from all channels that a user is a participant in. |
Create channel message post | chatMessage | Send a message to a channel. |
Create reply to channel message post | chatMessage | Reply to a message in a channel. |
Get files folder | driveItem | Retrieves the details of the SharePoint folder where the files for the channel are stored. |
List tabs | teamsTab | Lists tabs pinned to a channel. |
List channel members | conversationMember collection | Get the list of members in a channel. |
Add channel member | conversationMember | Add a member to a channel. Only supported for channels with a membershipType of private or shared . |
Get channel member | conversationMember collection | Get a member in a channel. |
Update channel member's role | conversationMember | Update the properties of a member of the channel. Only supported for channels with a membershipType of private or shared . |
Remove channel member | None | Delete a member from a channel. Only supported for channels with a membershipType of private or shared . |
Complete migration | channel | Removes the migration mode from the channel and makes the channel available to users to post and read messages. |
List tabs in channel | teamsTab | List tabs pinned to a channel. |
Add tab to channel | teamsTab | Add (pin) a tab to a channel. |
Get tab in channel | teamsTab | Get a specific tab pinned to a channel. |
Update tab in channel | teamsTab | Updates the properties of a tab in a channel. |
Remove tab from channel | None | Remove (unpin) a tab from a channel. |
Provision channel email address | provisionChannelEmailResult | Provision an email address for the channel. |
Remove channel email address | None | Remove the email address of the channel. |
Remove incoming channel | None | Remove an incoming channel (a channel shared with a team) from a team. |
List teams sharing a channel | sharedWithChannelTeamInfo collection | Get the list of teams that has been shared a specified channel. |
Get team sharing a channel | sharedWithChannelTeamInfo | Get a team which has been shared a specified channel. |
Unshare channel with team | None | Unshare a channel with a team by deleting the corresponding sharedWithChannelTeamInfo resource. |
List allowed members | conversationMember collection | Get the list of conversationMembers who can access a shared channel. |
Check user access | Boolean | Determine whether a user has access to a shared channel. |
Properties
Property | Type | Description |
---|---|---|
createdDateTime | dateTimeOffset | Read only. Timestamp at which the channel was created. |
description | String | Optional textual description for the channel. |
displayName | String | Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters. |
String | The email address for sending messages to the channel. Read-only. | |
id | String | The channel's unique identifier. Read-only. |
isFavoriteByDefault | Boolean | Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with Create team. Default: false . |
membershipType | channelMembershipType | The type of the channel. Can be set during creation and can't be changed. The possible values are: standard , private , unknownFutureValue , shared . The default value is standard . Note that you must use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: shared . |
tenantId | string | The ID of the Azure Active Directory tenant. |
webUrl | String | A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only. |
channelMembershipType values
Member | Description |
---|---|
standard | Channel inherits the list of members of the parent team. |
private | Channel can have members that are a subset of all the members on the parent team. |
unknownFutureValue | Evolvable enumeration sentinel value. Do not use. |
shared | Members can be directly added to the channel without adding them to the team. |
Instance attributes
Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.
Property name | Type | Description |
---|---|---|
@microsoft.graph.channelCreationMode | string | Indicates that the channel is in migration state and is currently being used for migration purposes. It accepts one value: migration . |
Note:
channelCreationMode
is an enum that takes the valuemigration
.
For a POST request example, see Request (create channel in migration state).
Relationships
Relationship | Type | Description |
---|---|---|
filesFolder | driveItem | Metadata for the location where the channel's files are stored. |
members | conversationMember collection | A collection of membership records associated with the channel. |
messages | chatMessage collection | A collection of all the messages in the channel. A navigation property. Nullable. |
operations | teamsAsyncOperation collection | The async operations that ran or are running on this team. |
sharedWithTeams | sharedWithChannelTeamInfo collection | A collection of teams with which a channel is shared. |
tabs | teamsTab collection | A collection of all the tabs in the channel. A navigation property. |
JSON representation
The following is a JSON representation of the resource.
{
"createdDateTime": "string (timestamp)",
"description": "string",
"displayName": "string",
"email": "string",
"id": "string (identifier)",
"isFavoriteByDefault": true,
"membershipType": "String",
"webUrl": "string"
}
See also
Feedback
Submit and view feedback for