Plugins API - GET all plugins

Lists all plugins uploaded to your DESK environment.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/plugins
  • SaaS https://{your-environment-id}.live.dexp.ae/api/config/v1/plugins

Parameters

The request doesn't provide any configurable parameters.

Response format

The StubList object

An ordered list of short representations of DESK entities.

Element Type Description
values EntityShortRepresentation[]

An ordered list of short representations of DESK entities.

The EntityShortRepresentation object

The short representation of a DESK entity.

Element Type Description
id string

The ID of the DESK entity.

name string

The name of the DESK entity.

description string

A short description of the DESK entity.

Example

In this example, the request lists all the plugins uploaded to the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to four entries. The request lists these plugins:

Plugins - list

Curl

curl -X GET \
  https://mySampleEnv.live.dexp.ae/api/config/v1/plugins \
  -H 'Authorization: Api-token abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dexp.ae/api/config/v1/plugins

Response body

{
  "values": [
    {
      "id": "custom.remote.python.sap",
      "name": "SAP plugin",
      "description": "ActiveGate plugin"
    },
    {
      "id": "custom.remote.python.simple_math",
      "name": "MathPlugin",
      "description": "ActiveGate plugin"
    },
    {
      "id": "custom.python.wavebuoyplugin",
      "name": "WaveBuoy Plugin",
      "description": "OneAgent plugin"
    },
    {
      "id": "custom.jmx.creatorCreatedPlugin1506519805362",
      "name": "Jetty2",
      "description": "JMX plugin"
    }
  ]
}

Response code

200