{ "opencollection": "1.0.0", "info": { "name": "Kibana APIs Actions synthetics API", "version": "1.0" }, "request": { "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "items": [ { "info": { "name": "synthetics", "type": "folder" }, "items": [ { "info": { "name": "Trigger an on-demand test run for a monitor", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/monitor/test/:monitorId", "params": [ { "name": "monitorId", "value": "", "type": "path", "description": "The ID (config_id) of the monitor to test." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/monitor/test/{monitorId}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nTrigger an immediate test execution for the specified monitor. The response includes the generated `testRunId`. If the test encounters issues in one or more service locations, an `errors` array is also" }, { "info": { "name": "Get monitors", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/monitors", "params": [ { "name": "filter", "value": "", "type": "query", "description": "Additional filtering criteria." }, { "name": "locations", "value": "", "type": "query", "description": "The locations to filter by." }, { "name": "monitorTypes", "value": "", "type": "query", "description": "The monitor types to filter." }, { "name": "page", "value": "", "type": "query", "description": "The page number for paginated results." }, { "name": "per_page", "value": "", "type": "query", "description": "The number of items to return per page." }, { "name": "projects", "value": "", "type": "query", "description": "The projects to filter by." }, { "name": "query", "value": "", "type": "query", "description": "A free-text query string." }, { "name": "schedules", "value": "", "type": "query", "description": "The schedules to filter by." }, { "name": "sortField", "value": "", "type": "query", "description": "The field to sort the results by." }, { "name": "sortOrder", "value": "", "type": "query", "description": "The sort order." }, { "name": "status", "value": "", "type": "query", "description": "The status to filter by." }, { "name": "tags", "value": "", "type": "query", "description": "Tags to filter monitors." }, { "name": "useLogicalAndFor", "value": "", "type": "query", "description": "Specifies whether to apply logical AND filtering for specific fields. Accepts either a string with values \"tags\" or \"locations\" or an array containing both.\n" } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/monitors
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a list of monitors.\nYou must have `read` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Create a monitor", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/monitors", "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/monitors
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nCreate a new monitor with the specified attributes. A monitor can be one of the following types: HTTP, TCP, ICMP, or Browser. The required and default fields may vary based on the monitor type.\nYou must have `all` pri" }, { "info": { "name": "Delete monitors", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/monitors/_bulk_delete", "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/monitors/_bulk_delete
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete multiple monitors by sending a list of config IDs.\n" }, { "info": { "name": "Get a monitor", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/monitors/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID of the monitor." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/monitors/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information." }, { "info": { "name": "Update a monitor", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/synthetics/monitors/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier for the monitor that you want to update." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/synthetics/monitors/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate a monitor with the specified attributes. The required and default fields may vary based on the monitor type.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kiba" }, { "info": { "name": "Delete a monitor", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/synthetics/monitors/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The identifier for the monitor that you want to delete." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/synthetics/monitors/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete a monitor from the Synthetics app.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Get parameters", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/params" }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/params
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a list of all parameters. You must have `read` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Add parameters", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/params", "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/params
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nAdd one or more parameters to the Synthetics app.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Delete parameters", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/params/_bulk_delete", "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/params/_bulk_delete
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete parameters from the Synthetics app.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Get a parameter", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/params/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier for the parameter." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/params/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a parameter from the Synthetics app.\nYou must have `read` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Update a parameter", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/synthetics/params/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier for the parameter." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/synthetics/params/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate a parameter in the Synthetics app.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Delete a parameter", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/synthetics/params/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID for the parameter to delete." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/synthetics/params/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nDelete a parameter from the Synthetics app.\nYou must have `all` privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Get private locations", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/private_locations" }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/private_locations
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nGet a list of private locations.\nYou must have `read` privileges for the Synthetics and Uptime feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Create a private location", "type": "http" }, "http": { "method": "POST", "url": "https://{kibana_url}/api/synthetics/private_locations", "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
post /s/{space_id}/api/synthetics/private_locations
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nYou must have `all` privileges for the Synthetics and Uptime feature in the Observability section of the Kibana feature privileges." }, { "info": { "name": "Get a private location", "type": "http" }, "http": { "method": "GET", "url": "https://{kibana_url}/api/synthetics/private_locations/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "A private location identifier or label." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
get /s/{space_id}/api/synthetics/private_locations/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nYou must have `read` privileges for the Synthetics and Uptime feature in the Observability section of the Kibana feature privileges.\n" }, { "info": { "name": "Update a private location", "type": "http" }, "http": { "method": "PUT", "url": "https://{kibana_url}/api/synthetics/private_locations/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier of the private location to be updated." } ], "body": { "type": "json", "data": "{}" } }, "docs": "**Spaces method and path for this operation:**\n\n
put /s/{space_id}/api/synthetics/private_locations/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nUpdate an existing private location's label.\nYou must have `all` privileges for the Synthetics and Uptime feature in the Observability section of the Kibana feature privileges.\nWhen a private location's la" }, { "info": { "name": "Delete a private location", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kibana_url}/api/synthetics/private_locations/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The unique identifier of the private location to be deleted." } ] }, "docs": "**Spaces method and path for this operation:**\n\n
delete /s/{space_id}/api/synthetics/private_locations/{id}
\n\nRefer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.\n\nYou must have `all` privileges for the Synthetics and Uptime feature in the Observability section of the Kibana feature privileges.\nThe API does not return a response body for deletion, but it will r" } ] } ], "bundled": true }