Platform API
Desk Quick Start

Quick Start

Using Desk Platform API, you can directly interact with the different types of resources which represent data associated with customer support activities in your Sendbird Desk. The Desk API is designed to use standard HTTP protocols and return JSON payloads in response to HTTP requests and is internally implemented based on the RESTful principles. While the native SDKs handle many of the requests and responses at the client-side, the Desk API adds flexibility and abilities to your service from the server-side.

Note: The Desk API is not designed for client side use. Use the corresponding Desk SDKs instead. The Desk SDK documentation will be released soon.


Base URL

The base URL used for the Desk API is formatted as shown below:

Light Color Skin
Copy
https://desk-api-{application_id}.sendbird.com/platform/v1

To get your Sendbird application ID, sign in to your dashboard, select the application, go to the Settings > Application > General, and then check the Application ID.


Headers

A typical HTTP request to the Desk API includes the following headers:

Light Color Skin
Copy
Content-Type: application/json, charset=utf8
SENDBIRDDESKAPITOKEN: {desk_api_key}
  • Content-Type: every request must include a Content-Type header.
  • SENDBIRDDESKAPITOKEN: an API key of your Sendbird Desk is required for Sendbird server to authenticate your API requests. You can use any of API keys in your dashboard under Settings > Desk > Credentials.

DO NOT send any Desk API requests from your client app. If your API token information is leaked in the process of exchanging data, you could lose all your data by malicious API calls.


URL encoding

When sending requests over HTTP, you should encode URLs into a browser-readable format. URL encoding replaces unsafe non-ASCII characters with a % followed by hex digits to ensure readability.

In the following URL, the value of the agent_id parameter should be urlencoded. For example, agent_id@email.com should be urlencoded to agent_id%40email.com.

Light Color Skin
Copy
GET https://desk-api-{application_id}.sendbird.com/platform/v1/agents/{agent_id}/connection

Therefore, your full request should be as below:

Light Color Skin
Copy
GET https://desk-api-{application_id}.sendbird.com/platform/v1/agents/agent_id%40email.com/connection