Body Required
-
When
true
, the query runs on all agents. -
A list of agent IDs to run the query on.
-
A list of agent platforms to run the query on.
-
A list of agent policy IDs to run the query on.
-
A list of alert IDs associated with the live query.
-
A list of case IDs associated with the live query.
-
Map osquery results columns or static values to Elastic Common Schema (ECS) fields
-
A list of event IDs associated with the live query.
-
Custom metadata object associated with the live query.
-
The ID of the pack you want to run, retrieve, update, or delete.
-
An array of queries to run.
-
The SQL query you want to run.
-
The ID of a saved query.
POST /api/osquery/live_queries
curl \ --request POST 'https://<KIBANA_URL>/api/osquery/live_queries' \ --header "Authorization: $API_KEY" \ --header "Content-Type: application/json" \ --data '{"query":"select * from uptime;","agent_all":true,"ecs_mapping":{"host.uptime":{"field":"total_seconds"}}}'
Request example
{ "query": "select * from uptime;", "agent_all": true, "ecs_mapping": { "host.uptime": { "field": "total_seconds" } } }
Response examples (200)
{ "data": { "type": "INPUT_ACTION", "agents": [ "16d7caf5-efd2-4212-9b62-73dafc91fa13" ], "queries": [ { "id": "6724a474-cbba-41ef-a1aa-66aebf0879e2", "query": "select * from uptime;", "agents": [ "16d7caf5-efd2-4212-9b62-73dafc91fa13" ], "timeout": 120, "action_id": "609c4c66-ba3d-43fa-afdd-53e244577aa0", "ecs_mapping": { "host.uptime": { "field": "total_seconds" } } } ], "user_id": "elastic", "metadata": { "execution_context": { "url": "/app/osquery/live_queries/new", "name": "osquery" } }, "action_id": "3c42c847-eb30-4452-80e0-728584042334", "agent_all": true, "agent_ids": [], "@timestamp": "2022-07-26T09:59:32.220Z", "expiration": "2022-07-26T10:04:32.220Z", "input_type": "osquery", "agent_platforms": [], "agent_policy_ids": [] } }