Skip to main content
Use chat message APIs to build the message composer, message list, replies, reactions, and moderation actions inside a channel or subchannel. Most message creation APIs target a subChannelId; use channel and member APIs when you need to discover the correct chat target first.

Create Messages

Send text, image, file, video, audio, and custom message payloads where the platform SDK exposes them.

Query Messages

Load channel messages, replies, filtered message lists, and paginated message collections.

Manage Messages

Edit supported message types, soft-delete messages, and clear failed local messages where supported.

Flag Messages

Let users report or unreport messages for moderation review.

​
Message Creation Coverage

Media-message inputs differ by platform. TypeScript creates media messages from uploaded file IDs. iOS accepts AmityMessageAttachment values such as .localURL or .fileId. Android accepts AmityMessageAttachment values such as FILE_ID or URL. Flutter creates image, file, and video messages from a Uri.

​
Implementation Notes

  • Resolve the subChannelId from your channel flow before creating messages.
  • Use parentId when creating replies.
  • Use tags and metadata only for app-owned categorization or rendering context.
  • Upload or select media first when your target platform expects a file ID or attachment object.
  • Keep message state handling in the UI tied to the platform model returned by the SDK.

Send a Message

Choose the right create API for each message type.

Reply to a Message

Create threaded replies with parentId.

Query Messages

Query top-level messages and reply threads.

Message Flagging

Add report and unreport actions for chat messages.