AI Inbox

Add Channel Comment

Leave an INTERNAL note. Not a reply - the customer never sees it.

MENTIONING SOMEONE CREATES THEM A TASK in the Work app. The two mention lists are additive rather than alternatives: an id with no matching email still gets the task, it just gets no notification, so send both to get the bell as well.

Attachments must already be uploaded; only their token and key are load-bearing, because the server re-validates and never trusts a client-sent name, size or type.

post/inbox/channels/{channel_id}/comments

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/inbox/channels/{channel_id}/comments
  • Auth: HTTP bearer

Path parameters

channel_idstring required

Conversation id.

Query parameters

channel_type'email' | 'chat' | 'phone' | 'sms' | 'heyreach' | 'meetings' | 'support' | 'all' required

Which channel the conversation lives in. REQUIRED: the same id means different rows in different channels, so this is what identifies the conversation, not a filter.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

contentstring required
mentioned_user_idsstring[]

Mentioned users by id. Each gets a Work task.

mentioned_user_emailsstring[]

The same users by email. Additive - this is what drives the notification.

Response

Successful Response

dataInboxPayload required

An open envelope for a comment, an assignment or a workspace.

Open because a comment carries attachment refs and mention metadata that grow, and because an assignment result reports per-assignee outcomes.

Changes

No recorded changes to this operation across all 2 revisions of this API.