Get Channels ​
Endpoint ​
GET /unified/instant-messaging/channels/{id}
Integrations supported
- Microsoft 365
- Microsoft Teams
Path parameters ​
The ID of the resource.
23423523
Query parameters ​
Refer Specifying query parameters in Truto APIs
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79d
The format of the response.
unified
returns the response with unified mappings applied.raw
returns the unprocessed, raw response from the remote API.normalized
applies the unified mappings and returns the data in a normalized format.stream
returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.
Defaults to unified
.
unified
raw
normalized
stream
unified
Excludes the remote_data
attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=name
Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=bar
Workspace to which the channel belongs.
Required in
- Microsoft 365
- Microsoft Teams
Unique identifier for the workspace.
Name of the workspace.
Type of the channel.
channel
dm
group_dm
private_channel
Enum support by integration
- Microsoft Teams
channel
dm
group_dm
- Microsoft 365
channel
dm
group_dm
Supported in
- Microsoft 365
- Microsoft Teams
Response Body ​
Unique identifier for the channel.
Supported in
- Microsoft 365
- Microsoft Teams
Name of the channel.
Supported in
- Microsoft 365
- Microsoft Teams
Description of the channel.
Supported in
- Microsoft 365
- Microsoft Teams
Organization to which the channel belongs.
Unique identifier for the organization.
Name of the organization.
Workspace to which the channel belongs.
Supported in
- Microsoft 365
- Microsoft Teams
Unique identifier for the workspace.
Name of the workspace.
Group to which the channel belongs.
Supported in
- Microsoft 365
- Microsoft Teams
Unique identifier for the group.
Name of the group.
Type of the channel.
channel
private_channel
dm
group_dm
Supported in
- Microsoft 365
- Microsoft Teams
Status of the channel.
active
archived
Supported in
- Microsoft 365
- Microsoft Teams
Is the current authed user or application is a member of the channel. This might not directly mean that the user or application can post messages on the channel.
Unique identifier for the member.
Date and time when the channel was created.
Supported in
- Microsoft 365
- Microsoft Teams
Date and time when the channel was last updated.
Raw data returned from the remote API call.