/ Platform API

Platform API

Overview
Migrating to Sendbird
Prepare to use API
- User
- Overview
- - Listing users
  - List users
  - Get a user
- - Creating users
  - Create a user
- - Managing users
  - Update a user
  - Delete a user
- - Managing session tokens
  - Issue a session token
  - Revoke all session tokens
- - Managing joined group channels
  - List group channels by user
  - Leave group channels
- - Getting group channel count
  - Get number of channels by join status
- - Marking messages as read
  - Mark all of a user's messages as read
- - Managing metadata
  - Get metadata
  - Create metadata
  - Update metadata
  - Delete metadata
- Channel
- Overview
- - Listing channels in an application
  - List open channels
  - Get an open channel
  - List group channels
  - Get a group channel
- - Creating a channel
  - Create an open channel
  - Create a group channel
- - Inviting a user
  - Invite as members
  - Accept an invitation
  - Decline an invitation
- - Managing metacounter
  - Get metacounter
  - Create metacounter
  - Update metacounter
  - Delete metacounter
- - Managing metadata
  - Get metadata
  - Create metadata
  - Update metadata
  - Delete metadata
- - Managing typing indicators
  - Start typing indicators
  - Stop typing indicators
- Application
- Overview
- - Setting up an application
  - Get global application settings
  - Update global application settings
- - Managing API tokens
  - List secondary API tokens
  - Get a secondary API token
  - Generate a secondary API token
  - Revoke a secondary API token
- - Managing IP whitelist
  - Get an IP whitelist
  - Add an IP to a whitelist
  - Delete IPs from a whitelist
- - Managing auto event messages
  - List auto event messages
  - Configure auto event message settings
- - Understanding rate limits
  - Rate limits
- - Getting failed webhooks
  - Get failed webhooks
- Organization
- Overview
- - Managing application
  - List applications
  - Get an application
  - Create an application
  - Delete an application
  - Copy application settings
- - Managing features
  - List features
  - Update a feature
- - Managing members
  - List members
  - Get a member
  - Update a member
  - Deactivate a member
- - Managing roles
  - List predefined roles
  - List custom roles
- Push notifications
- FCM migration guide
- Overview
- - Managing FCM configurations
  - Add an FCM push configuration
  - Update an FCM push configuration
- - Managing HMS configurations
  - Add an HMS push configuration
  - Update an HMS push configuration
- - Managing APNS configurations
  - Add an APNs push configuration
  - Update an APNs push configuration
  - Delete an APNs certificate
- Statistics
- Overview
- - Advanced analytics
  - Get advanced analytics metrics
- - Concurrent connections
  - Get number of concurrent connections
- - DAUs & MAUs
  - Get number of daily active users
  - Get number of monthly active users
- - Peak connections
  - Get number of peak connections
- Data export
- Overview
- - Listing data exports
  - List data exports by message, channel, or user
  - Get a data export
- - Scheduling data exports
  - Register and schedule a data export
- Bot
- Overview
- - Listing bots
  - List bots
  - Get a bot
- - Creating a bot
  - Create a bot
- - Sending a bot message
  - Send a bot message
- - Managing a bot
  - Update a bot
  - Join channels
  - Leave channels
  - Delete a bot
- AI chatbot
- Overview
- - Managing AI chatbots
  - Create an AI chatbot
  - List AI chatbots
  - Get an AI chatbot
  - Update an AI chatbot
  - Delete an AI chatbot
- - Configuring content sources
  - Configure content sources
- Report
- Overview
- - Creating a report
  - Report a user
  - Report a channel
  - Report a message
- Webhook
- Overview
- - Managing subscribed events
  - Get a list of subscribed events
  - Choose events to subscribe
- Privacy
- Overview
- - Listing GDPR requests
  - List GDPR requests
  - Get a GDPR request
- - Creating a GDPR request
  - Register a GDPR request
- - Managing GDPR requests
  - Cancel the registration of a GDPR request
Deprecated
Error codes

Chat Platform API v3

Chat Platform API

Chat Platform API

Version 3

/

/

/

Overview

Message essentials contain basic message functionalities, such as sending or viewing a message, and forms the operational basis for advanced message features and other functionalities in the Chat API.

Actions

The following table shows a list of actions supported for message essentials. API endpoints are relative to the base URL allocated to your Sendbird application. In this page, the /{channel_type}/{channel_url}/messages endpoint refers to https://api-{application_id}.sendbird.com/v3/{channel_type}/{channel_url}/messages.

Note: If you want to know the ID and base URL of your application, sign in to the Sendbird Dashboard, go to the Settings > Application > General, and then check the Application ID and API request URL.

It's recommended that the parameter values in API URLs be urlencoded, such as {user_id} and {channel_url}.

List of actions

Action	HTTP request
List messages	`GET` /{channel_type}/{channel_url}/messages Retrieves a list of past messages of a specific channel.
Get a message	`GET` /{channel_type}/{channel_url}/messages/{message_id} Retrieves information on a specific message.
Send a message	`POST` /{channel_type}/{channel_url}/messages Sends a message to a specific channel.
Update a message	`PUT` /{channel_type}/{channel_url}/messages/{message_id} Updates specific information on a message.
Delete a message	`DELETE` /{channel_type}/{channel_url}/messages/{message_id} Deletes a specific message from a channel.
Add metadata	`POST` /{channel_type}/{channel_url}/messages/{message_id}/sorted_metaarray Adds key-values items to store additional information for a message.
Update metadata	`PUT` /{channel_type}/{channel_url}/messages/{message_id}/sorted_metaarray Updates values of specific items by their keys.
Remove metadata	`DELETE` /{channel_type}/{channel_url}/messages/{message_id}/sorted_metaarray Removes specific items from a message by their keys.
Get total number of messages in a channel	`GET` /{channel_type}/{channel_url}/messages/total_count Retrieves the total number of messages in a specific channel.

In the case of an error, an error object is returned. A detailed list of error codes is available here.

On this page