IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Create connector APIedit
Creates a connector.
Requestedit
POST <kibana host>:<port>/api/actions/connector
POST <kibana host>:<port>/s/<space_id>/api/actions/connector
Prerequisitesedit
You must have all
privileges for the Actions and Connectors feature in the
Management section of the
Kibana feature privileges.
Path parametersedit
-
space_id
-
(Optional, string) An identifier for the space. If
space_id
is not provided in the URL, the default space is used.
Request bodyedit
-
name
- (Required, string) The display name for the connector.
-
connector_type_id
- (Required, string) The connector type ID for the connector.
-
config
- (Required, object) The configuration for the connector. Configuration properties vary depending on the connector type. For information about the configuration properties, refer to Action and connector types.
-
secrets
-
(Required, object) The secrets configuration for the connector. Secrets configuration properties vary depending on the connector type. For information about the secrets configuration properties, refer to Action and connector types.
Remember these values. You must provide them each time you call the update API.
Response codesedit
-
200
- Indicates a successful call.
Examplesedit
POST api/actions/connector { "name": "my-connector", "connector_type_id": ".index", "config": { "index": "test-index" } }
The API returns the following:
{ "id": "c55b6eb0-6bad-11eb-9f3b-611eebc6c3ad", "connector_type_id": ".index", "name": "my-connector", "config": { "index": "test-index", "refresh": false, "executionTimeField": null }, "is_preconfigured": false, "is_missing_secrets": false }