Skip to content

Platform API

This section introduces the EMQX Platform API functionality and how to create and manage the platform API key for secure access control.

API Function

Currently, the EMQX Platform supports TLS certificate management, deployment management, and project management API. More platform-level APIs will be supported in the future.

APIDeployment TypeDescription
TLS Certificate ManagementEMQX Dedicated and Dedicated Flex v5 deployment
EMQX v4 (4.4.x) deployment created under the Platform account
Manage the lifecycle of TLS certificates for a specified deployment.
Deployment ManagementEMQX Dedicated and Dedicated Flex v5 deployment
EMQX v4 (4.4.x) deployment created under the Platform account
Query deployment status, start, stop, and create deployment.
Project ManagementN/AQuery project list

Create and Manage Platform API Key

Platform API Keys provide access management at the Platform level. You can create and manage Platform API Keys under a Root User or Administrator account. Accounts with other roles cannot create or manage Platform API Keys.

  1. Log in to the EMQX Platform Console with your account.

  2. Click Settings from the left menu and select the Platform API Key tab.

    platform_key

  3. Click Create New Key. Enter a description in the API Key Description. Click Create Platform API Key.

  4. Select the Functionality Scope and Project Scope according to your needs. The API can be used within the selected projects. Click Next.

  5. Store the API key and secret safely. Click Confirm and Return.

Now you have created the Platform API key. You can click the key to modify the API info and scope. You can also delete the API key by clicking the delete icon on the page.