IM object
An IM object is a legacy object that contains information about a direct message channel. IM objects are now conversation objects.
{
"id": "D024BFF1M",
"is_im": true,
"user": "U024BE7LH",
"created": 1360782804,
"is_user_deleted": false
}
IM object fields
| Field | Type | Description |
|---|---|---|
connected_team_ids | Array of team_id | Team IDs of externally connected teams (Slack Connect). |
context_team_id | workspace_id (String) | The team/workspace ID context for this DM. Required field. |
created | Unix timestamp | When the IM was created. |
frozen_reason | String | Reason the DM was frozen. |
has_barrier | Boolean | Whether an information barrier applies to this DM. |
has_pins | Boolean | Whether the DM has any pinned items. |
id | String | The ID of the object. |
internal_team_ids | Array of workspace_id | Workspace IDs of internal teams in the DM. |
is_archived | Boolean | Whether the DM is archived. Required field. |
is_ext_shared | Boolean | Whether the DM is externally shared (Slack Connect). |
is_frozen | Boolean | Whether the DM is frozen. |
is_im | Boolean | Indicates if the object is an IM. |
is_migrating | Boolean | Whether the DM is currently being migrated. |
is_open | Boolean | Whether the DM is open in the client. |
is_org_shared | Boolean | Whether the DM is shared across an organization. Required field. |
is_pending_ext_shared | Boolean | Whether the DM has a pending external share. |
is_shared | Boolean | Whether the DM is shared across workspaces. |
is_starred | Boolean | Whether the calling user has starred this DM. |
is_user_deleted | Boolean | true if the other user's account has been disabled. |
last_read | ts (String) | Message timestamp of the last read message. |
latest | Message object | The most recent message in the DM. |
locale | String | Locale setting for the DM. |
members | Array of user_id | User IDs of DM members. |
pending_connected_team_ids | Array of workspace_id | Team IDs with pending Slack Connect invitations. |
pin_count | Integer | Number of pinned items. |
priority | Number | Sort priority for the DM in the sidebar. |
properties | Object | Channel properties associated with this DM. |
purpose | Object | Purpose of the DM (value, creator, last_set). |
shared_team_ids | Array of workspace_id | All workspace IDs this DM is shared with. |
target_user_id | String | User ID of the other participant in the DM. |
topic | Object | Topic of the DM (value, creator, last_set). |
unread_count | Integer | Full count of unread messages. |
unread_count_display | Integer | Count of unread messages that matter to the user. |
updated | Integer | Unix timestamp of when the DM was last updated. |
user | String | Each direct message channel is between two users. One of these users is always the calling user, the other's ID is indicated by the user property. |