Event Portal REST API

Using the Event Portal's RESTful API, you can integrate other applications, systems, or client applications with Event Portal, and model or retrieve your event-driven architectures from your own client applications.

Getting Started

You can access the REST API by communicating with the host at https://solace.cloud/api/v1/eventPortal. Note that the URL is used to perform REST API calls and cannot be accessed from the browser.

As Event API Product (EAPs) is a Beta feature, REST API for retrieving an EAP’s AsyncAPI document is currently not available through the above mentioned URL. To retrive an EAP's AsycnAPI document, refer to Retrieve an EAP's AsyncAPI Document (Partner Developers)Event Portal API Code Samples Note that EAP is currently in Beta stage, and the feature including its API version (v0) will undergo changes that may not be backwards compatible.

Create an API Token

To perform REST API calls, you will need an API token. Use your PubSub+ Cloud account to generate an API token.

  1. Log into your PubSub+ Cloud account.

    If you're already logged in to the PubSub+ Cloud and belong to multiple accounts (Workspaces), ensure that you select the account that you want to create an API token for. To do this, click User & AccountUser icon in the PubSub+ Cloud Console from the navigation bar, and in the submenu below the Notifications Settings, select the account you want to create an API token for.

  2. At the bottom of the left-hand menu, click the user icon, and then click Token Management.

  3. On the top-right corner, click the Create Token button.
  4. On the Create Token page, in the Token Name box, type a unique name for the API token.
  5. Navigate to Event Portal section and on the Select Permissions section, click the toggle Greyed out slider indicating off beside the permission you want to enable.

    The permissions you can set and see depend on your assigned account role. If you don't see some permissions (or see additional permissions) listed on the Create Tokenpage as shown in the illustration, you may not have the required permissions for your account. Contact your account administrator or Solace support if there is a problem with your permissions.

    The permissions shown below are useful for completing the tutorials and for development purposes only to fully utilize the REST API capabilities. API tokens that you use in production must assign only the minimum set of permissions (a subset of the above permissions) that are required for your client applications to function. For example, don't assign a permission such as Create User or Delete User if the application never needs to manage users. For more information, see Understanding API Token Permissions.

    The example shown below is useful for completing the tutorials or for development purposes only. The recommended practice is to create multiple API tokens with a subset of required permissions.

    Event Portal permissions:

When performing REST API calls, include your API token as an HTTP header: Authorization: Bearer <API token goes here>.

OpenAPI Specification

The Event Portal REST API has an OpenAPI specification document to help you navigate your way through the REST APIs. Click the button below to access the OpenAPI spec.