Skip to main content
All paths on this page are relative to https://inkbox.ai/api/v1/slack. Every request requires a visible connection_id UUID, an active identity, and a connected workspace.

​
List conversations

List conversations the bot is a member of through the selected workspace connection. This is a live membership list, not a directory of every public channel or a workspace archive. Accessible Slack Connect conversations are included. To join another supported public channel, supply its known conversation ID to Join conversation. Private channels require an invitation. Archived channels are not listed. Use Get conversation with a known ID to inspect one, subject to the connection’s current access.

​
Response (200)

conversations contains Slack conversation objects with supported fields when available. next_cursor is null when there is no next cursor. A short or empty page does not replace cursor handling; filtering and Slack limits can reduce the number returned.

​
Open a direct message

Opens or resumes a DM or group DM in the selected workspace. It does not join a channel.
Returns 200 with a conversation object, not a wrapper. Save its id for reads and sends. Slack decides whether the bot can open the requested conversation. Invalid user lists return 422.

​
Get conversation

conversation_id starts with C, D, or G, followed by uppercase letters or digits, up to 64 characters total. Returns 200 with a conversation object. Supported fields include id, name, conversation-type flags (is_channel, is_group, is_im, is_mpim), visibility and membership flags, user, created, num_members, topic, and purpose. Fields can be absent when Slack does not return them. Topic and purpose objects can include value, creator, and last_set. You must add the bot to channels before using their history or sending messages there. Private-channel membership requires an authorized invitation. A listed conversation does not guarantee that every operation is permitted. An inaccessible conversation can return 403 or 404. Slack Connect does not bypass membership or workspace restrictions. See common errors.

​
Next steps