Skip to content

Deployment API

This section provides an overview of the EMQX Deployment API and explains how to securely create and manage Deployment API Keys.

API Function

EMQX Deployment API manages the functionalities at the deployment level, such as client monitoring, message publishing, authentication, authorization, and so on.

API ReferenceDeployment TypeDescription
Serverless deployment APIServerless deploymentManaging operations for client, subscription, and message publishing in Serverless deployments.
Dedicated deployment APIv5 Dedicated deploymentManaging various operations in v5 Dedicated deployments. If you need to access the v4 Deployment API, see v4 API.

Create and Manage Deployment API Keys

Deployment API Keys are used to authenticate and authorize access to the EMQX Deployment API. The method for creating and managing API Keys differs based on the type and version of the deployment.

Create API Keys in Dedicated v5 Deployments

For Dedicated v5 deployments, you can add custom notes and assign fine-grained access permissions to each API Key.

  1. Go to the target Dedicated v5 deployment.

  2. In the Deployment API Key section, click + New API Key.

  3. In the dialog that appears:

    • Note (optional): Add a description to identify the key’s purpose and scope.
    • API Permissions:
      • Select HTTP methods (GET, POST, PUT, DELETE) as needed.
      • Filter or search for specific API endpoints.
      • Use category-level checkboxes to select entire categories or individual APIs.
    new_api_key_dedicatedv5
  4. After clicking Confirm, a dialog displays the generated App ID and App Secret.

    Important

    The App Secret is shown only once during key creation. Make sure to store it securely, as it cannot be retrieved later.

  5. Click Close on the dialog.

Create API Keys in Serverless & Dedicated v4 Deployments

For Serverless and Dedicated v4 deployments, API Keys are automatically generated with full access. These deployments do not support permission configuration or note fields.

  1. Go to the target Serverless or Dedicated v4 deployment.

  2. In the Deployment API Key section, click + New API Key.

  3. The system will automatically generate an App ID and App Secret, which are displayed in a confirmation dialog.

    Important

    The App Secret is shown only once during key creation. Make sure to store it securely, as it cannot be retrieved later.

  4. Click Close on the dialog.

Manage API Keys

  • Edit (Dedicated v5 only): Update the note or modify assigned API permissions.

  • Delete: Delete an API Key to revoke access immediately.

  • View Access: Expand a key entry to view its assigned permissions (Dedicated v5 only).

    view_api_key