Plugins API - PUT an endpoint of a plugin
Updates properties of the specified endpoint of the ActiveGate plugin.
The request consumes an application/json
payload.
PUT |
|
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string |
The ID of the plugin where you want to update an endpoint. If you set the plugin ID in the body as well, it must match this ID. |
path | required |
endpointId | string |
The ID of the endpoint to be updated. If you set the endpoint ID in the body as well, it must match this ID. |
path | required |
body | RemotePluginEndpoint |
The JSON body of the request. Contains updated parameters of the plugin endpoint. |
body | optional |
The RemotePluginEndpoint object
Configuration of a plugin endpoint.
Element | Type | Description | Required |
---|---|---|---|
id | string |
The ID of the endpoint. |
optional |
pluginId | string |
The ID of the plugin to which the endpoint belongs. |
optional |
name | string |
The name of the endpoint, displayed in DESK. |
optional |
enabled | boolean |
The endpoint is enabled ( |
optional |
properties | object |
The list of endpoint parameters. Each parameter is a property-value pair. |
optional |
activeGatePluginModule | EntityShortRepresentation |
The ActiveGate plugin module that hosts the endpoint. |
required |
The EntityShortRepresentation object
The short representation of a DESK entity.
Element | Type | Description | Required |
---|---|---|---|
id | string |
The ID of the DESK entity. |
required |
name | string |
The name of the DESK entity. |
optional |
description | string |
A short description of the DESK entity. |
optional |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.
{
"id": "-2183662974968812535",
"pluginId": "custom.remote.python.demo",
"name": "Demo endpoint",
"enabled": true,
"properties": {
"serverIp": "127.0.0.1",
"password": "",
"username": "DESK",
"dropdownProperty": "two"
},
"activeGatePluginModule": {
"id": "-8844900174269363000"
}
}
Response format
A successful request doesn't return any content.
Example
In this example, the request updates the RESTtest endpoint of the SAP plugin which has the ID of custom.remote.python.sap. It makes the following changes to the endpoint:
- name to
RESTtest - updated
- serverIp to
192.168.1.1
- activeGatePluginModule to l-009 which has the ID of
6121289130553435111
The API token is passed in the Authorization header.
You can download or copy the example request body to try it out on your own.
The original endpoint has the following parameters:
Curl
curl -X PUT \
https://mySampleEnv.live.dexp.ae/api/config/v1/plugins/custom.remote.python.sap/endpoints/8757307336635955682 \
-H 'Authorization: Api-token abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
-d '{
"name": "RESTtest - updated",
"enabled": false,
"properties": {
"clientno": "001",
"serverIp": "192.168.1.1",
"password": "",
"instance": "00",
"username": "DT"
},
"activeGatePluginModule": {
"id": "6121289130553435111"
}
}'
Request URL
https://mySampleEnv.live.dexp.ae/api/config/v1/plugins/custom.remote.python.sap/endpoints/8757307336635955682
Request body
api-examples/config/plugin/put-plugin-endpoint.json
{
"name": "RESTtest - updated",
"enabled": false,
"properties": {
"clientno": "001",
"serverIp": "192.168.1.1",
"password": "",
"instance": "00",
"username": "DT"
},
"activeGatePluginModule": {
"id": "6121289130553435111"
}
}
Response code
204
Result
The updated endpoint looks like this in the UI: