Update connector
editUpdate connector
editUpdates a connector.
Request URL
editPUT <kibana host>:<port>/api/actions/action/<connector ID>
URL parts
editThe URL must include the connector ID
of the connector you are updating.
Call Find connectors to retrieve connector IDs.
Request body
editA JSON object with the fields you want to update:
Name | Type | Description | Required |
---|---|---|---|
|
Object containing the action’s configuration. |
Yes |
|
|
Object |
Object containing the third-party account information used to create and update incidents. For ServiceNow connectors:
For Jira connectors:
For IBM Resilient connectors:
|
Yes |
|
String |
The connector’s name. |
Yes |
Name | Type | Description | Required |
---|---|---|---|
|
Object |
Use
|
Yes |
|
String |
URL of the third-party instance. |
Yes |
|
String |
Jira project key. |
For Jira connectors, yes. For other connectors, no. |
|
String |
IBM Resilient organization ID. |
For IBM Resilient connectors, yes. For other connectors, no. |
|
Boolean |
Indicates a ServiceNow connector is used for Elastic Security cases.
Must be |
For ServiceNow connecters only, yes. For other connectors, no. |
Example request
editUpdates the description
field mapping of connector ID
61787f53-4eee-4741-8df6-8fe84fa616f7
:
PUT api/actions/action/61787f53-4eee-4741-8df6-8fe84fa616f7 { "config": { "apiUrl": "https://dev357417.service-now.com", "incidentConfiguration": { "mapping": [ { "actionType": "overwrite", "source": "title", "target": "short_description" }, { "actionType": "append", "source": "description", "target": "description" }, { "actionType": "append", "source": "comments", "target": "comments" } ] }, "isCaseOwned": true }, "name": "SN API", "secrets": { "password": "stongpassword123!", "username": "admin" } }
Response code
edit-
200
- Indicates a successful call.
Response payload
editThe updated JSON connector object.
Example response
edit{ "id": "61787f53-4eee-4741-8df6-8fe84fa616f7", "actionTypeId": ".servicenow", "name": "ServiceNow", "config": { "apiUrl": "https://dev78437.service-now.com", "casesConfiguration": { "mapping": [ { "source": "title", "target": "short_description", "actionType": "overwrite" }, { "source": "description", "target": "description", "actionType": "append" }, { "source": "comments", "target": "comments", "actionType": "append" } ] } } }