diff --git a/docs/api-generated/fleet/fleet-apis-passthru.asciidoc b/docs/api-generated/fleet/fleet-apis-passthru.asciidoc new file mode 100644 index 0000000000000..5d8b478e9e94e --- /dev/null +++ b/docs/api-generated/fleet/fleet-apis-passthru.asciidoc @@ -0,0 +1,7329 @@ +//// +This content is generated from the open API specification. +Any modifications made to this file will be overwritten. +//// + +++++ +
+

Access

+
    +
  1. APIKey KeyParamName:Authorization KeyInQuery:false KeyInHeader:true
  2. +
  3. APIKey KeyParamName:Authorization KeyInQuery:false KeyInHeader:true
  4. +
  5. HTTP Basic Authentication
  6. +
+ +

Methods

+ [ Jump to Models ] + +

Table of Contents

+
+

Default

+ + +

Default

+
+
+ Up +
post /agent_policies/{agentPolicyId}/copy
+
Agent policy - copy one policy (agentPolicyCopy)
+
+ +

Path parameters

+
+
agentPolicyId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
agent_policy_copy_request agent_policy_copy_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agent_policy_info_200_response +
+
+
+
+ Up +
get /agent_policies/{agentPolicyId}
+
Agent policy - Info (agentPolicyInfo)
+
Get one agent policy
+ +

Path parameters

+
+
agentPolicyId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agent_policy_info_200_response +
+
+
+
+ Up +
get /agent_policies
+
Agent policies - List (agentPolicyList)
+
+ + + + + +

Query parameters

+
+
perPage (optional)
+ +
Query Parameter — The number of items to return default: 20
page (optional)
+ +
Query Parameter — default: 1
kuery (optional)
+ +
Query Parameter — default: null
full (optional)
+ +
Query Parameter — When set to true, retrieve the related package policies for each agent policy. default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0.8008281904610115,
+  "perPage" : 1.4658129805029452,
+  "page" : 6.027456183070403,
+  "items" : [ null, null ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agent_policy_list_200_response +
+
+
+
+ Up +
get /agents/action_status
+
Agents - Action status (agentsActionStatus)
+
+ + + + + +

Query parameters

+
+
perPage (optional)
+ +
Query Parameter — The number of items to return default: 20
page (optional)
+ +
Query Parameter — default: 1
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ {
+    "nbAgentsActioned" : 0.8008281904610115,
+    "creationTime" : "creationTime",
+    "cancellationTime" : "cancellationTime",
+    "type" : "type",
+    "newPolicyId" : "newPolicyId",
+    "version" : "version",
+    "completionTime" : "completionTime",
+    "actionId" : "actionId",
+    "nbAgentsAck" : 1.4658129805029452,
+    "nbAgentsFailed" : 5.962133916683182,
+    "startTime" : "startTime",
+    "expiration" : "expiration",
+    "nbAgentsActionCreated" : 6.027456183070403,
+    "status" : "COMPLETE"
+  }, {
+    "nbAgentsActioned" : 0.8008281904610115,
+    "creationTime" : "creationTime",
+    "cancellationTime" : "cancellationTime",
+    "type" : "type",
+    "newPolicyId" : "newPolicyId",
+    "version" : "version",
+    "completionTime" : "completionTime",
+    "actionId" : "actionId",
+    "nbAgentsAck" : 1.4658129805029452,
+    "nbAgentsFailed" : 5.962133916683182,
+    "startTime" : "startTime",
+    "expiration" : "expiration",
+    "nbAgentsActionCreated" : 6.027456183070403,
+    "status" : "COMPLETE"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agents_action_status_200_response +
+
+
+
+ Up +
get /agents/current_upgrades
+
Agents - Current Bulk Upgrades (agentsCurrentUpgrades)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ {
+    "nbAgents" : 0.8008281904610115,
+    "actionId" : "actionId",
+    "nbAgentsAck" : 6.027456183070403,
+    "startTime" : "startTime",
+    "complete" : true,
+    "version" : "version"
+  }, {
+    "nbAgents" : 0.8008281904610115,
+    "actionId" : "actionId",
+    "nbAgentsAck" : 6.027456183070403,
+    "startTime" : "startTime",
+    "complete" : true,
+    "version" : "version"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agents_current_upgrades_200_response +
+
+
+
+ Up +
post /agent_policies/_bulk_get
+
Agent policies - Bulk Get (bulkGetAgentPolicies)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_get_agent_policies_request bulk_get_agent_policies_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ null, null ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_get_agent_policies_200_response +
+
+
+
+ Up +
post /package_policies/_bulk_get
+
Package policies - Bulk Get (bulkGetPackagePolicies)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_get_package_policies_request bulk_get_package_policies_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ null, null ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_get_package_policies_200_response +
+
+
+
+ Up +
post /epm/packages/_bulk
+
Packages - Bulk install (bulkInstallPackages)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : [ {
+    "name" : "name",
+    "version" : "version"
+  }, {
+    "name" : "name",
+    "version" : "version"
+  } ],
+  "items" : [ {
+    "name" : "name",
+    "version" : "version"
+  }, {
+    "name" : "name",
+    "version" : "version"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_install_packages_response +
+
+
+
+ Up +
post /agents/bulk_reassign
+
Agents - Bulk reassign (bulkReassignAgents)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_reassign_agents_request bulk_reassign_agents_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +
+
+
+
+ Up +
post /agents/bulk_request_diagnostics
+
Agent - Bulk Request Diagnostics (bulkRequestDiagnostics)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_request_diagnostics_request bulk_request_diagnostics_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +
+
+
+
+ Up +
post /agents/bulk_unenroll
+
Agents - Bulk unenroll (bulkUnenrollAgents)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_unenroll_agents_request bulk_unenroll_agents_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +
+
+
+
+ Up +
post /agents/bulk_update_agent_tags
+
Agents - Bulk update tags (bulkUpdateAgentTags)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_update_agent_tags_request bulk_update_agent_tags_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +
+
+
+
+ Up +
post /agents/bulk_upgrade
+
Agents - Bulk Upgrade (bulkUpgradeAgents)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
bulk_upgrade_agents bulk_upgrade_agents (required)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +

400

+ BAD REQUEST + upgrade_agent +
+
+
+
+ Up +
post /agent_policies
+
Agent policy - Create (createAgentPolicy)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
new_agent_policy new_agent_policy (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + create_agent_policy_200_response +
+
+
+
+ Up +
post /enrollment_api_keys
+
Enrollment API Key - Create (createEnrollmentApiKeys)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  },
+  "action" : "created"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + create_enrollment_api_keys_deprecated_200_response +
+
+
+
+ Up +
post /enrollment-api-keys
+
Enrollment API Key - Create (createEnrollmentApiKeysDeprecated)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  },
+  "action" : "created"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + create_enrollment_api_keys_deprecated_200_response +
+
+
+
+ Up +
post /package_policies
+
Package policy - Create (createPackagePolicy)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
create_package_policy_request create_package_policy_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + create_package_policy_200_response +
+
+
+
+ Up +
get /data_streams
+
Data streams - List (dataStreamsList)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "data_streams" : [ {
+    "last_activity_ms" : 0.8008281904610115,
+    "size_in_bytes_formatted" : "size_in_bytes_formatted",
+    "package" : "package",
+    "package_version" : "package_version",
+    "namespace" : "namespace",
+    "size_in_bytes" : 6.027456183070403,
+    "index" : "index",
+    "type" : "type",
+    "dataset" : "dataset",
+    "dashboard" : [ {
+      "id" : "id",
+      "title" : "title"
+    }, {
+      "id" : "id",
+      "title" : "title"
+    } ]
+  }, {
+    "last_activity_ms" : 0.8008281904610115,
+    "size_in_bytes_formatted" : "size_in_bytes_formatted",
+    "package" : "package",
+    "package_version" : "package_version",
+    "namespace" : "namespace",
+    "size_in_bytes" : 6.027456183070403,
+    "index" : "index",
+    "type" : "type",
+    "dataset" : "dataset",
+    "dashboard" : [ {
+      "id" : "id",
+      "title" : "title"
+    }, {
+      "id" : "id",
+      "title" : "title"
+    } ]
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + data_streams_list_200_response +
+
+
+
+ Up +
delete /agents/{agentId}
+
Agent - Delete (deleteAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "action" : "deleted"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_agent_200_response +
+
+
+
+ Up +
post /agent_policies/delete
+
Agent policy - Delete (deleteAgentPolicy)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
delete_agent_policy_request delete_agent_policy_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "success" : true,
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_agent_policy_200_response +
+
+
+
+ Up +
delete /agent_download_sources/{sourceId}
+
Agent Download Sources - Delete (deleteDownloadSource)
+
+ +

Path parameters

+
+
sourceId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_package_policy_200_response +
+
+
+
+ Up +
delete /enrollment_api_keys/{keyId}
+
Enrollment API Key - Delete (deleteEnrollmentApiKey)
+
+ +

Path parameters

+
+
keyId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "action" : "deleted"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_agent_200_response +
+
+
+
+ Up +
delete /enrollment-api-keys/{keyId}
+
Enrollment API Key - Delete (deleteEnrollmentApiKeyDeprecated)
+
+ +

Path parameters

+
+
keyId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "action" : "deleted"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_agent_200_response +
+
+
+
+ Up +
delete /proxies/{itemId}
+
Fleet Proxies - Delete (deleteFleetProxies)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_package_policy_200_response +
+
+
+
+ Up +
delete /fleet_server_hosts/{itemId}
+
Fleet Server Hosts - Delete (deleteFleetServerHosts)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_package_policy_200_response +
+
+
+
+ Up +
delete /outputs/{outputId}
+
Output - Delete (deleteOutput)
+
+ +

Path parameters

+
+
outputId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_package_policy_200_response +
+
+
+
+ Up +
delete /epm/packages/{pkgName}/{pkgVersion}
+
Packages - Delete (deletePackage)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
pkgVersion (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
install_package_deprecated_request install_package_deprecated_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ +

Query parameters

+
+
ignoreUnverified (optional)
+ +
Query Parameter — Ignore if the package is fails signature verification default: null
full (optional)
+ +
Query Parameter — Return all fields from the package manifest, not just those supported by the Elastic Package Registry default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ {
+    "id" : "id"
+  }, {
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + update_package_200_response +
+
+
+
+ Up +
delete /epm/packages/{pkgkey}
+
Packages - Delete (deletePackageDeprecated)
+
+ +

Path parameters

+
+
pkgkey (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
install_package_deprecated_request install_package_deprecated_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : [ {
+    "id" : "id"
+  }, {
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + install_package_deprecated_200_response +
+
+
+
+ Up +
delete /package_policies/{packagePolicyId}
+
Package policy - Delete (deletePackagePolicy)
+
+ +

Path parameters

+
+
packagePolicyId (required)
+ +
Path Parameter — default: null
+
+ + + + +

Query parameters

+
+
force (optional)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + delete_package_policy_200_response +
+
+
+
+ Up +
post /logstash_api_keys
+
Generate Logstash API key (generateLogstashApiKey)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "api_key" : "api_key"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + generate_logstash_api_key_200_response +
+
+
+
+ Up +
post /service_tokens
+
Generate service tokens (generateServiceToken)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "name" : "name",
+  "value" : "value"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + generate_service_token_deprecated_200_response +
+
+
+
+ Up +
post /service-tokens
+
Generate service tokens (generateServiceTokenDeprecated)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "name" : "name",
+  "value" : "value"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + generate_service_token_deprecated_200_response +
+
+
+
+ Up +
get /agents/{agentId}
+
Agent - Info (getAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_200_response +
+
+
+
+ Up +
get /agent_status/data
+
Agents - Get incoming data (getAgentData)
+
+ + + + + +

Query parameters

+
+
agentsIds (required)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ {
+    "key" : {
+      "data" : true
+    }
+  }, {
+    "key" : {
+      "data" : true
+    }
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_data_200_response +
+
+
+
+ Up +
get /agent_status
+
Agents - Summary stats (getAgentStatus)
+
+ + + + + +

Query parameters

+
+
policyId (optional)
+ +
Query Parameter — default: null
kuery (optional)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "offline" : 5,
+  "other" : 2,
+  "total" : 7,
+  "inactive" : 1,
+  "updating" : 9,
+  "online" : 5,
+  "error" : 0,
+  "events" : 6
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_status_deprecated_200_response +
+
+
+
+ Up +
get /agent-status
+
Agents - Summary stats (getAgentStatusDeprecated)
+
+ + + + + +

Query parameters

+
+
policyId (optional)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "offline" : 5,
+  "other" : 2,
+  "total" : 7,
+  "inactive" : 1,
+  "updating" : 9,
+  "online" : 5,
+  "error" : 0,
+  "events" : 6
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_status_deprecated_200_response +
+
+
+
+ Up +
get /agents/tags
+
Agent Tags - List (getAgentTags)
+
List all agent tags
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ "items", "items" ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_tags_response +
+
+
+
+ Up +
get /agents
+
Agents - List (getAgents)
+
+ + + + + +

Query parameters

+
+
perPage (optional)
+ +
Query Parameter — The number of items to return default: 20
page (optional)
+ +
Query Parameter — default: 1
kuery (optional)
+ +
Query Parameter — default: null
showInactive (optional)
+ +
Query Parameter — default: null
showUpgradeable (optional)
+ +
Query Parameter — default: null
sortField (optional)
+ +
Query Parameter — default: null
sortOrder (optional)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 6.027456183070403,
+  "perPage" : 5.962133916683182,
+  "page" : 1.4658129805029452,
+  "list" : [ {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  }, {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  } ],
+  "items" : [ {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  }, {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agents_response +
+
+
+
+ Up +
get /agents/setup
+
Agents setup - Info (getAgentsSetupStatus)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "missing_requirements" : [ "tls_required", "tls_required" ],
+  "package_verification_key_id" : "package_verification_key_id",
+  "isReady" : true,
+  "missing_optional_features" : [ "encrypted_saved_object_encryption_key_required", "encrypted_saved_object_encryption_key_required" ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + fleet_status_response +
+
+
+
+ Up +
get /agent_download_sources
+
Agent Download Sources (getDownloadSources)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0,
+  "perPage" : 1,
+  "page" : 6,
+  "items" : [ {
+    "name" : "name",
+    "host" : "host",
+    "id" : "id",
+    "is_default" : true
+  }, {
+    "name" : "name",
+    "host" : "host",
+    "id" : "id",
+    "is_default" : true
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_download_sources_200_response +
+
+
+
+ Up +
get /enrollment_api_keys/{keyId}
+
Enrollment API Key - Info (getEnrollmentApiKey)
+
+ +

Path parameters

+
+
keyId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_enrollment_api_key_deprecated_200_response +
+
+
+
+ Up +
get /enrollment-api-keys/{keyId}
+
Enrollment API Key - Info (getEnrollmentApiKeyDeprecated)
+
+ +

Path parameters

+
+
keyId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_enrollment_api_key_deprecated_200_response +
+
+
+
+ Up +
get /enrollment_api_keys
+
Enrollment API Keys - List (getEnrollmentApiKeys)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 1.4658129805029452,
+  "perPage" : 6.027456183070403,
+  "page" : 0.8008281904610115,
+  "list" : [ {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }, {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  } ],
+  "items" : [ {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }, {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_enrollment_api_keys_deprecated_200_response +
+
+
+
+ Up +
get /enrollment-api-keys
+
Enrollment API Keys - List (getEnrollmentApiKeysDeprecated)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 1.4658129805029452,
+  "perPage" : 6.027456183070403,
+  "page" : 0.8008281904610115,
+  "list" : [ {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }, {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  } ],
+  "items" : [ {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  }, {
+    "policy_id" : "policy_id",
+    "api_key" : "api_key",
+    "name" : "name",
+    "active" : true,
+    "created_at" : "created_at",
+    "id" : "id",
+    "api_key_id" : "api_key_id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_enrollment_api_keys_deprecated_200_response +
+
+
+
+ Up +
get /proxies
+
Fleet Proxies - List (getFleetProxies)
+
Return a list of Proxies
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0,
+  "perPage" : 1,
+  "page" : 6,
+  "items" : [ {
+    "proxy_headers" : "{}",
+    "certificate_authorities" : "certificate_authorities",
+    "certificate_key" : "certificate_key",
+    "name" : "name",
+    "certificate" : "certificate",
+    "id" : "id",
+    "url" : "url"
+  }, {
+    "proxy_headers" : "{}",
+    "certificate_authorities" : "certificate_authorities",
+    "certificate_key" : "certificate_key",
+    "name" : "name",
+    "certificate" : "certificate",
+    "id" : "id",
+    "url" : "url"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_fleet_proxies_200_response +
+
+
+
+ Up +
get /fleet_server_hosts
+
Fleet Server Hosts - List (getFleetServerHosts)
+
Return a list of Fleet server hosts
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0,
+  "perPage" : 1,
+  "page" : 6,
+  "items" : [ {
+    "host_urls" : [ "host_urls", "host_urls" ],
+    "is_preconfigured" : true,
+    "name" : "name",
+    "id" : "id",
+    "is_default" : true
+  }, {
+    "host_urls" : [ "host_urls", "host_urls" ],
+    "is_preconfigured" : true,
+    "name" : "name",
+    "id" : "id",
+    "is_default" : true
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_fleet_server_hosts_200_response +
+
+
+
+ Up +
get /agent_download_sources/{sourceId}
+
Agent Download Sources - Info (getOneDownloadSource)
+
+ +

Path parameters

+
+
sourceId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "name" : "name",
+    "host" : "host",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_download_source_200_response +
+
+
+
+ Up +
get /proxies/{itemId}
+
Fleet Proxies - Info (getOneFleetProxies)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "proxy_headers" : "{}",
+    "certificate_authorities" : "certificate_authorities",
+    "certificate_key" : "certificate_key",
+    "name" : "name",
+    "certificate" : "certificate",
+    "id" : "id",
+    "url" : "url"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_fleet_proxies_200_response +
+
+
+
+ Up +
get /fleet_server_hosts/{itemId}
+
Fleet Server Hosts - Info (getOneFleetServerHosts)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "host_urls" : [ "host_urls", "host_urls" ],
+    "is_preconfigured" : true,
+    "name" : "name",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_fleet_server_hosts_200_response +
+
+
+
+ Up +
get /outputs/{outputId}
+
Output - Info (getOutput)
+
+ +

Path parameters

+
+
outputId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "ca_sha256" : "ca_sha256",
+    "hosts" : [ "hosts", "hosts" ],
+    "name" : "name",
+    "ca_trusted_fingerprint" : "ca_trusted_fingerprint",
+    "is_default_monitoring" : true,
+    "config_yaml" : "config_yaml",
+    "id" : "id",
+    "is_default" : true,
+    "type" : "elasticsearch",
+    "config" : "{}",
+    "ssl" : {
+      "certificate_authorities" : [ "certificate_authorities", "certificate_authorities" ],
+      "certificate" : "certificate",
+      "key" : "key"
+    }
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_output_200_response +
+
+
+
+ Up +
get /outputs
+
Outputs (getOutputs)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0,
+  "perPage" : 1,
+  "page" : 6,
+  "items" : [ {
+    "ca_sha256" : "ca_sha256",
+    "hosts" : [ "hosts", "hosts" ],
+    "name" : "name",
+    "ca_trusted_fingerprint" : "ca_trusted_fingerprint",
+    "is_default_monitoring" : true,
+    "config_yaml" : "config_yaml",
+    "id" : "id",
+    "is_default" : true,
+    "type" : "elasticsearch",
+    "config" : "{}",
+    "ssl" : {
+      "certificate_authorities" : [ "certificate_authorities", "certificate_authorities" ],
+      "certificate" : "certificate",
+      "key" : "key"
+    }
+  }, {
+    "ca_sha256" : "ca_sha256",
+    "hosts" : [ "hosts", "hosts" ],
+    "name" : "name",
+    "ca_trusted_fingerprint" : "ca_trusted_fingerprint",
+    "is_default_monitoring" : true,
+    "config_yaml" : "config_yaml",
+    "id" : "id",
+    "is_default" : true,
+    "type" : "elasticsearch",
+    "config" : "{}",
+    "ssl" : {
+      "certificate_authorities" : [ "certificate_authorities", "certificate_authorities" ],
+      "certificate" : "certificate",
+      "key" : "key"
+    }
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_outputs_200_response +
+
+
+
+ Up +
get /epm/packages/{pkgName}/{pkgVersion}
+
Packages - Info (getPackage)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
pkgVersion (required)
+ +
Path Parameter — default: null
+
+ + + + +

Query parameters

+
+
ignoreUnverified (optional)
+ +
Query Parameter — Ignore if the package is fails signature verification default: null
full (optional)
+ +
Query Parameter — Return all fields from the package manifest, not just those supported by the Elastic Package Registry default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
null
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_package_200_response +
+
+
+
+ Up +
get /epm/categories
+
Package categories (getPackageCategories)
+
+ + + + + +

Query parameters

+
+
prerelease (optional)
+ +
Query Parameter — Whether to include prerelease packages in categories count (e.g. beta, rc, preview) default: false
experimental (optional)
+ +
Query Parameter — default: false
include_policy_templates (optional)
+ +
Query Parameter — default: false
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : [ {
+    "count" : 0.8008281904610115,
+    "id" : "id",
+    "title" : "title"
+  }, {
+    "count" : 0.8008281904610115,
+    "id" : "id",
+    "title" : "title"
+  } ],
+  "items" : [ {
+    "count" : 6.027456183070403,
+    "id" : "id",
+    "title" : "title"
+  }, {
+    "count" : 6.027456183070403,
+    "id" : "id",
+    "title" : "title"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_categories_response +
+
+
+
+ Up +
get /epm/packages/{pkgkey}
+
Packages - Info (getPackageDeprecated)
+
+ +

Path parameters

+
+
pkgkey (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
null
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_package_deprecated_200_response +
+
+
+
+ Up +
get /package_policies
+
Package policies - List (getPackagePolicies)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "total" : 0.8008281904610115,
+  "perPage" : 1.4658129805029452,
+  "page" : 6.027456183070403,
+  "items" : [ null, null ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_package_policies_200_response +
+
+
+
+ Up +
get /package_policies/{packagePolicyId}
+
Package policy - Info (getPackagePolicy)
+
+ +

Path parameters

+
+
packagePolicyId (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + create_package_policy_200_response +
+
+
+
+ Up +
get /epm/packages/{pkgName}/stats
+
Get stats for a package (getPackageStats)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : {
+    "agent_policy_count" : 0
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_package_stats_200_response +
+
+
+
+ Up +
get /settings
+
Settings (getSettings)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "has_seen_add_data_notice" : true,
+    "fleet_server_hosts" : [ "fleet_server_hosts", "fleet_server_hosts" ],
+    "prerelease_integrations_enabled" : true,
+    "id" : "id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + fleet_settings_response +
+
+
+
+ Up +
post /epm/packages/{pkgName}/{pkgVersion}
+
Packages - Install (installPackage)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
pkgVersion (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
install_package_request install_package_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ +

Query parameters

+
+
ignoreUnverified (optional)
+ +
Query Parameter — Ignore if the package is fails signature verification default: null
full (optional)
+ +
Query Parameter — Return all fields from the package manifest, not just those supported by the Elastic Package Registry default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "_meta" : {
+    "install_source" : "registry"
+  },
+  "items" : [ {
+    "id" : "id"
+  }, {
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + install_package_200_response +
+
+
+
+ Up +
post /epm/packages/{pkgkey}
+
Packages - Install (installPackageDeprecated)
+
+ +

Path parameters

+
+
pkgkey (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
install_package_deprecated_request install_package_deprecated_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : [ {
+    "id" : "id"
+  }, {
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + install_package_deprecated_200_response +
+
+
+
+ Up +
get /epm/packages
+
Packages - List (listAllPackages)
+
+ + + + + +

Query parameters

+
+
excludeInstallStatus (optional)
+ +
Query Parameter — Whether to exclude the install status of each package. Enabling this option will opt in to caching for the response via cache-control headers. If you don't need up-to-date installation info for a package, and are querying for a list of available packages, providing this flag can improve performance substantially. default: false
prerelease (optional)
+ +
Query Parameter — Whether to return prerelease versions of packages (e.g. beta, rc, preview) default: false
experimental (optional)
+ +
Query Parameter — default: false
category (optional)
+ +
Query Parameter — default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "response" : [ {
+    "savedObject" : "{}",
+    "path" : "path",
+    "download" : "download",
+    "name" : "name",
+    "description" : "description",
+    "icons" : "icons",
+    "title" : "title",
+    "type" : "type",
+    "version" : "version",
+    "status" : "status"
+  }, {
+    "savedObject" : "{}",
+    "path" : "path",
+    "download" : "download",
+    "name" : "name",
+    "description" : "description",
+    "icons" : "icons",
+    "title" : "title",
+    "type" : "type",
+    "version" : "version",
+    "status" : "status"
+  } ],
+  "items" : [ {
+    "savedObject" : "{}",
+    "path" : "path",
+    "download" : "download",
+    "name" : "name",
+    "description" : "description",
+    "icons" : "icons",
+    "title" : "title",
+    "type" : "type",
+    "version" : "version",
+    "status" : "status"
+  }, {
+    "savedObject" : "{}",
+    "path" : "path",
+    "download" : "download",
+    "name" : "name",
+    "description" : "description",
+    "icons" : "icons",
+    "title" : "title",
+    "type" : "type",
+    "version" : "version",
+    "status" : "status"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_packages_response +
+
+
+
+ Up +
get /epm/packages/limited
+
Packages - Get limited list (listLimitedPackages)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ "items", "items" ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + list_limited_packages_200_response +
+
+
+
+ Up +
post /agents/{agentId}/actions
+
Agent - Actions (newAgentAction)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
new_agent_action_request new_agent_action_request (required)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "headers" : "headers",
+  "body" : [ 0.8008281904610115, 0.8008281904610115 ],
+  "statusCode" : 6.027456183070403
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + new_agent_action_200_response +
+
+
+
+ Up +
get /epm/packages/{pkgName}/{pkgVersion}/{filePath}
+
Packages - Get file from registry (packagesGetFile)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
pkgVersion (required)
+ +
Path Parameter — default: null
filePath (required)
+ +
Path Parameter — default: null
+
+ + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "headers" : "{}",
+  "body" : "{}",
+  "statusCode" : 0.8008281904610115
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + packages_get_file_200_response +
+
+
+
+ Up +
post /package_policies/delete
+
Package policy - Delete (postDeletePackagePolicy)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
post_delete_package_policy_request post_delete_package_policy_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "success" : true,
+  "name" : "name",
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + +
+
+
+
+ Up +
post /agent_download_sources
+
Agent Download Sources (postDownloadSources)
+
Create a new agent download source
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
post_download_sources_request post_download_sources_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "name" : "name",
+    "host" : "host",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + post_download_sources_200_response +
+
+
+
+ Up +
post /proxies
+
Fleet Proxies - Create (postFleetProxies)
+
Create a new Fleet Server Host
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
post_fleet_proxies_request post_fleet_proxies_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "proxy_headers" : "{}",
+    "certificate_authorities" : "certificate_authorities",
+    "certificate_key" : "certificate_key",
+    "name" : "name",
+    "certificate" : "certificate",
+    "id" : "id",
+    "url" : "url"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + post_fleet_proxies_200_response +
+
+
+
+ Up +
post /fleet_server_hosts
+
Fleet Server Hosts - Create (postFleetServerHosts)
+
Create a new Fleet Server Host
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
post_fleet_server_hosts_request post_fleet_server_hosts_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "host_urls" : [ "host_urls", "host_urls" ],
+    "is_preconfigured" : true,
+    "name" : "name",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + post_fleet_server_hosts_200_response +
+
+
+
+ Up +
post /outputs
+
Outputs (postOutputs)
+
Create a new output
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
post_outputs_request post_outputs_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "ca_sha256" : "ca_sha256",
+    "hosts" : [ "hosts", "hosts" ],
+    "name" : "name",
+    "ca_trusted_fingerprint" : "ca_trusted_fingerprint",
+    "is_default_monitoring" : true,
+    "config_yaml" : "config_yaml",
+    "id" : "id",
+    "is_default" : true,
+    "type" : "elasticsearch",
+    "config" : "{}",
+    "ssl" : {
+      "certificate_authorities" : [ "certificate_authorities", "certificate_authorities" ],
+      "certificate" : "certificate",
+      "key" : "key"
+    }
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + post_outputs_200_response +
+
+
+
+ Up +
put /setup/preconfiguration
+
Preconfiguration (putPreconfiguration)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
put_preconfiguration_request put_preconfiguration_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "agentPolicies" : [ "", "" ],
+  "packages" : {
+    "name" : "name",
+    "version" : "version"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + put_preconfiguration_200_response +
+
+
+
+ Up +
put /agents/{agentId}/reassign
+
Agent - Reassign (reassignAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
reassign_agent_request reassign_agent_request (required)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+
+ + Object +
+ + + + +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + Object +
+
+
+
+ Up +
post /agents/{agentId}/request_diagnostics
+
Agent - Request Diagnostics (requestDiagnosticsAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "actionId" : "actionId"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + bulk_upgrade_agents_200_response +
+
+
+
+ Up +
post /setup
+
Setup (setup)
+
+ + + + +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "isInitialized" : true,
+  "nonFatalErrors" : [ {
+    "name" : "name",
+    "message" : "message"
+  }, {
+    "name" : "name",
+    "message" : "message"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + fleet_setup_response +

500

+ Internal Server Error + setup_500_response +
+
+
+
+ Up +
post /agents/setup
+
Agents setup - Create (setupAgents)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
setup_agents_request setup_agents_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "isInitialized" : true,
+  "nonFatalErrors" : [ {
+    "name" : "name",
+    "message" : "message"
+  }, {
+    "name" : "name",
+    "message" : "message"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + fleet_setup_response +
+
+
+
+ Up +
post /agents/{agentId}/unenroll
+
Agent - Unenroll (unenrollAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
unenroll_agent_request unenroll_agent_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+
+ + Object +
+ + + + +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + Object +

400

+ BAD REQUEST + unenroll_agent_400_response +
+
+
+
+ Up +
put /agents/{agentId}
+
Agent - Update (updateAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_agent_request update_agent_request (required)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "default_api_key" : "default_api_key",
+    "enrolled_at" : "enrolled_at",
+    "access_api_key" : "access_api_key",
+    "components" : [ {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    }, {
+      "id" : "id",
+      "units" : [ {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      }, {
+        "payload" : "{}",
+        "id" : "id",
+        "message" : "message"
+      } ],
+      "type" : "type",
+      "message" : "message"
+    } ],
+    "user_provided_metadata" : "{}",
+    "unenrollment_started_at" : "unenrollment_started_at",
+    "policy_id" : "policy_id",
+    "policy_revision" : 0.8008281904610115,
+    "active" : true,
+    "local_metadata" : "{}",
+    "last_checkin" : "last_checkin",
+    "access_api_key_id" : "access_api_key_id",
+    "default_api_key_id" : "default_api_key_id",
+    "unenrolled_at" : "unenrolled_at",
+    "id" : "id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_agent_200_response +
+
+
+
+ Up +
put /agent_policies/{agentPolicyId}
+
Agent policy - Update (updateAgentPolicy)
+
+ +

Path parameters

+
+
agentPolicyId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
new_agent_policy new_agent_policy (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{ }
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + agent_policy_info_200_response +
+
+
+
+ Up +
put /agent_download_sources/{sourceId}
+
Agent Download Sources - Update (updateDownloadSource)
+
+ +

Path parameters

+
+
sourceId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_download_source_request update_download_source_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "name" : "name",
+    "host" : "host",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_download_source_200_response +
+
+
+
+ Up +
put /proxies/{itemId}
+
Fleet Proxies - Update (updateFleetProxies)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_fleet_proxies_request update_fleet_proxies_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "proxy_headers" : "{}",
+    "certificate_authorities" : "certificate_authorities",
+    "certificate_key" : "certificate_key",
+    "name" : "name",
+    "certificate" : "certificate",
+    "id" : "id",
+    "url" : "url"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_fleet_proxies_200_response +
+
+
+
+ Up +
put /fleet_server_hosts/{itemId}
+
Fleet Server Hosts - Update (updateFleetServerHosts)
+
+ +

Path parameters

+
+
itemId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_fleet_server_hosts_request update_fleet_server_hosts_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "host_urls" : [ "host_urls", "host_urls" ],
+    "is_preconfigured" : true,
+    "name" : "name",
+    "id" : "id",
+    "is_default" : true
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_one_fleet_server_hosts_200_response +
+
+
+
+ Up +
put /outputs/{outputId}
+
Output - Update (updateOutput)
+
+ +

Path parameters

+
+
outputId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_output_request update_output_request (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "ca_sha256" : "ca_sha256",
+    "hosts" : [ "hosts", "hosts" ],
+    "name" : "name",
+    "ca_trusted_fingerprint" : "ca_trusted_fingerprint",
+    "is_default_monitoring" : true,
+    "config_yaml" : "config_yaml",
+    "id" : "id",
+    "is_default" : true,
+    "type" : "elasticsearch",
+    "config" : "{}",
+    "ssl" : {
+      "certificate_authorities" : [ "certificate_authorities", "certificate_authorities" ],
+      "certificate" : "certificate",
+      "key" : "key"
+    }
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + get_output_200_response +
+
+
+
+ Up +
put /epm/packages/{pkgName}/{pkgVersion}
+
Packages - Update (updatePackage)
+
+ +

Path parameters

+
+
pkgName (required)
+ +
Path Parameter — default: null
pkgVersion (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_package_request update_package_request (optional)
+ +
Body Parameter
+ +
+ + +

Query parameters

+
+
ignoreUnverified (optional)
+ +
Query Parameter — Ignore if the package is fails signature verification default: null
full (optional)
+ +
Query Parameter — Return all fields from the package manifest, not just those supported by the Elastic Package Registry default: null
+
+ + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "items" : [ {
+    "id" : "id"
+  }, {
+    "id" : "id"
+  } ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + update_package_200_response +
+
+
+
+ Up +
put /package_policies/{packagePolicyId}
+
Package policy - Update (updatePackagePolicy)
+
+ +

Path parameters

+
+
packagePolicyId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
update_package_policy update_package_policy (optional)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
null
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + update_package_policy_200_response +
+
+
+
+ Up +
post /settings
+
Settings - Update (updateSettings)
+
+ + + + + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "item" : {
+    "has_seen_add_data_notice" : true,
+    "fleet_server_hosts" : [ "fleet_server_hosts", "fleet_server_hosts" ],
+    "prerelease_integrations_enabled" : true,
+    "id" : "id"
+  }
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + fleet_settings_response +
+
+
+
+ Up +
post /agents/{agentId}/upgrade
+
Agent - Upgrade (upgradeAgent)
+
+ +

Path parameters

+
+
agentId (required)
+ +
Path Parameter — default: null
+
+ +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
upgrade_agent upgrade_agent (required)
+ +
Body Parameter
+ +
+ +

Request headers

+
+
kbn-xsrf (required)
+ +
Header Parameter — default: null
+ +
+ + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "force" : true,
+  "version" : "version",
+  "source_uri" : "source_uri"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + upgrade_agent +

400

+ BAD REQUEST + upgrade_agent +
+
+
+
+ Up +
post /package_policies/upgrade
+
Package policy - Upgrade (upgradePackagePolicy)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
upgrade_package_policy_request upgrade_package_policy_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "success" : true,
+  "name" : "name",
+  "id" : "id"
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + +
+
+
+
+ Up +
post /package_policies/upgrade/dryrun
+
Package policy - Upgrade Dry run (upgradePackagePolicyDryRun)
+
+ + +

Consumes

+ This API call consumes the following media types via the Content-Type request header: + + +

Request body

+
+
upgrade_package_policy_dry_run_request upgrade_package_policy_dry_run_request (optional)
+ +
Body Parameter
+ +
+ + + + +

Return type

+ + + + +

Example data

+
Content-Type: application/json
+
{
+  "hasErrors" : true,
+  "agent_diff" : [ [ null, null ], [ null, null ] ],
+  "diff" : [ null, null ]
+}
+ +

Produces

+ This API call produces the following media types according to the Accept request header; + the media type will be conveyed by the Content-Type response header. + + +

Responses

+

200

+ OK + +
+
+ +

Models

+ [ Jump to Methods ] + +

Table of Contents

+
    +
  1. agent - Agent
  2. +
  3. agent_action - Agent action
  4. +
  5. agent_action_oneOf -
  6. +
  7. agent_action_oneOf_1 -
  8. +
  9. agent_action_oneOf_1_data -
  10. +
  11. agent_component - Agent component
  12. +
  13. agent_component_status - Agent component status
  14. +
  15. agent_component_unit - Agent component unit
  16. +
  17. agent_component_unit_type - Agent component unit type
  18. +
  19. agent_policy -
  20. +
  21. agent_policy_allOf -
  22. +
  23. agent_policy_copy_request -
  24. +
  25. agent_policy_info_200_response -
  26. +
  27. agent_policy_list_200_response -
  28. +
  29. agent_status - Agent status
  30. +
  31. agent_type - Agent type
  32. +
  33. agents_action_status_200_response -
  34. +
  35. agents_action_status_200_response_items_inner -
  36. +
  37. agents_current_upgrades_200_response -
  38. +
  39. agents_current_upgrades_200_response_items_inner -
  40. +
  41. bulk_get_agent_policies_200_response -
  42. +
  43. bulk_get_agent_policies_request -
  44. +
  45. bulk_get_package_policies_200_response -
  46. +
  47. bulk_get_package_policies_request -
  48. +
  49. bulk_install_packages_response - Bulk install packages response
  50. +
  51. bulk_reassign_agents_request -
  52. +
  53. bulk_reassign_agents_request_agents -
  54. +
  55. bulk_request_diagnostics_request -
  56. +
  57. bulk_unenroll_agents_request -
  58. +
  59. bulk_update_agent_tags_request -
  60. +
  61. bulk_upgrade_agents - Bulk upgrade agents
  62. +
  63. bulk_upgrade_agents_200_response -
  64. +
  65. create_agent_policy_200_response -
  66. +
  67. create_enrollment_api_keys_deprecated_200_response -
  68. +
  69. create_package_policy_200_response -
  70. +
  71. create_package_policy_request -
  72. +
  73. create_package_policy_request_oneOf -
  74. +
  75. create_package_policy_request_oneOf_allOf -
  76. +
  77. data_stream - Data stream
  78. +
  79. data_stream_dashboard_inner -
  80. +
  81. data_streams_list_200_response -
  82. +
  83. delete_agent_200_response -
  84. +
  85. delete_agent_policy_200_response -
  86. +
  87. delete_agent_policy_request -
  88. +
  89. delete_package_policy_200_response -
  90. +
  91. download_sources - Download Source
  92. +
  93. elasticsearch_asset_type - Elasticsearch asset type
  94. +
  95. enrollment_api_key - Enrollment API key
  96. +
  97. fleet_server_host - Fleet Server Host
  98. +
  99. fleet_settings_response - Fleet settings response
  100. +
  101. fleet_setup_response - Fleet Setup response
  102. +
  103. fleet_setup_response_nonFatalErrors_inner -
  104. +
  105. fleet_status_response - Fleet status response
  106. +
  107. full_agent_policy_input - Full agent policy input
  108. +
  109. full_agent_policy_input_allOf -
  110. +
  111. full_agent_policy_input_allOf_data_stream -
  112. +
  113. full_agent_policy_input_stream - Full agent policy input stream
  114. +
  115. full_agent_policy_input_stream_allOf -
  116. +
  117. full_agent_policy_input_stream_allOf_data_stream -
  118. +
  119. generate_logstash_api_key_200_response -
  120. +
  121. generate_service_token_deprecated_200_response -
  122. +
  123. get_agent_200_response -
  124. +
  125. get_agent_data_200_response -
  126. +
  127. get_agent_data_200_response_items_inner_value -
  128. +
  129. get_agent_status_deprecated_200_response -
  130. +
  131. get_agent_tags_response - Get Agent Tags response
  132. +
  133. get_agents_response - Get Agent response
  134. +
  135. get_categories_response - Get categories response
  136. +
  137. get_categories_response_items_inner -
  138. +
  139. get_categories_response_response_inner -
  140. +
  141. get_download_sources_200_response -
  142. +
  143. get_enrollment_api_key_deprecated_200_response -
  144. +
  145. get_enrollment_api_keys_deprecated_200_response -
  146. +
  147. get_fleet_proxies_200_response -
  148. +
  149. get_fleet_server_hosts_200_response -
  150. +
  151. get_one_download_source_200_response -
  152. +
  153. get_one_fleet_proxies_200_response -
  154. +
  155. get_one_fleet_server_hosts_200_response -
  156. +
  157. get_output_200_response -
  158. +
  159. get_outputs_200_response -
  160. +
  161. get_package_200_response -
  162. +
  163. get_package_200_response_allOf -
  164. +
  165. get_package_200_response_allOf_1 -
  166. +
  167. get_package_deprecated_200_response -
  168. +
  169. get_package_deprecated_200_response_allOf -
  170. +
  171. get_package_deprecated_200_response_allOf_1 -
  172. +
  173. get_package_policies_200_response -
  174. +
  175. get_package_stats_200_response -
  176. +
  177. get_packages_response - Get Packages response
  178. +
  179. install_package_200_response -
  180. +
  181. install_package_200_response__meta -
  182. +
  183. install_package_deprecated_200_response -
  184. +
  185. install_package_deprecated_200_response_response_inner -
  186. +
  187. install_package_deprecated_200_response_response_inner_type -
  188. +
  189. install_package_deprecated_request -
  190. +
  191. install_package_request -
  192. +
  193. kibana_saved_object_type - Kibana saved object asset type
  194. +
  195. list_limited_packages_200_response -
  196. +
  197. new_agent_action_200_response -
  198. +
  199. new_agent_action_request -
  200. +
  201. new_agent_policy - New agent policy
  202. +
  203. new_package_policy - New package policy
  204. +
  205. new_package_policy_inputs_inner -
  206. +
  207. new_package_policy_package -
  208. +
  209. output - Output
  210. +
  211. output_ssl -
  212. +
  213. package_info - Package information
  214. +
  215. package_info_conditions -
  216. +
  217. package_info_conditions_elasticsearch -
  218. +
  219. package_info_conditions_kibana -
  220. +
  221. package_info_data_streams_inner -
  222. +
  223. package_info_data_streams_inner_vars_inner -
  224. +
  225. package_info_elasticsearch -
  226. +
  227. package_info_elasticsearch_privileges -
  228. +
  229. package_info_screenshots_inner -
  230. +
  231. package_info_source -
  232. +
  233. package_policy - Package policy
  234. +
  235. package_policy_allOf -
  236. +
  237. package_usage_stats - Package usage stats
  238. +
  239. packages_get_file_200_response -
  240. +
  241. post_delete_package_policy_200_response_inner -
  242. +
  243. post_delete_package_policy_request -
  244. +
  245. post_download_sources_200_response -
  246. +
  247. post_download_sources_request -
  248. +
  249. post_fleet_proxies_200_response -
  250. +
  251. post_fleet_proxies_request -
  252. +
  253. post_fleet_server_hosts_200_response -
  254. +
  255. post_fleet_server_hosts_request -
  256. +
  257. post_outputs_200_response -
  258. +
  259. post_outputs_request -
  260. +
  261. preconfigured_agent_policies - Preconfigured agent policies
  262. +
  263. preconfigured_agent_policies_id -
  264. +
  265. preconfigured_agent_policies_package_policies_inner -
  266. +
  267. preconfigured_agent_policies_package_policies_inner_inputs_inner -
  268. +
  269. preconfigured_agent_policies_package_policies_inner_inputs_inner_vars -
  270. +
  271. preconfigured_agent_policies_package_policies_inner_package -
  272. +
  273. proxies - Fleet Proxy
  274. +
  275. put_preconfiguration_200_response -
  276. +
  277. put_preconfiguration_200_response_packages -
  278. +
  279. put_preconfiguration_request -
  280. +
  281. put_preconfiguration_request_body -
  282. +
  283. put_preconfiguration_request_body_packages -
  284. +
  285. reassign_agent_request -
  286. +
  287. search_result - Search result
  288. +
  289. settings - Settings
  290. +
  291. setup_500_response -
  292. +
  293. setup_agents_request -
  294. +
  295. simplified_package_policy - Simplified Package Policy
  296. +
  297. simplified_package_policy_inputs_value -
  298. +
  299. simplified_package_policy_inputs_value_streams_value -
  300. +
  301. simplified_package_policy_package -
  302. +
  303. unenroll_agent_400_response -
  304. +
  305. unenroll_agent_request -
  306. +
  307. update_agent_request -
  308. +
  309. update_download_source_request -
  310. +
  311. update_fleet_proxies_request -
  312. +
  313. update_fleet_server_hosts_request -
  314. +
  315. update_output_request -
  316. +
  317. update_package_200_response -
  318. +
  319. update_package_policy - Update package policy
  320. +
  321. update_package_policy_200_response -
  322. +
  323. update_package_policy_200_response_oneOf -
  324. +
  325. update_package_policy_inputs_inner -
  326. +
  327. update_package_policy_package -
  328. +
  329. update_package_request -
  330. +
  331. upgrade_agent - Upgrade agent
  332. +
  333. upgrade_diff_inner -
  334. +
  335. upgrade_diff_inner_allOf -
  336. +
  337. upgrade_diff_inner_allOf_allOf -
  338. +
  339. upgrade_diff_inner_allOf_allOf_errors_inner -
  340. +
  341. upgrade_package_policy_dry_run_200_response_inner -
  342. +
  343. upgrade_package_policy_dry_run_request -
  344. +
  345. upgrade_package_policy_request -
  346. +
+ +
+

agent - Agent Up

+
+
+
type
+
active
+
enrolled_at
+
unenrolled_at (optional)
+
unenrollment_started_at (optional)
+
access_api_key_id (optional)
+
default_api_key_id (optional)
+
policy_id (optional)
+
policy_revision (optional)
+
last_checkin (optional)
+
user_provided_metadata (optional)
+
local_metadata (optional)
+
id
+
access_api_key (optional)
+
status
+
default_api_key (optional)
+
components (optional)
+
+
+
+

agent_action - Agent action Up

+
+
+
data (optional)
+
ack_data (optional)
+
type (optional)
+
+
+
+

agent_action_oneOf - Up

+
+
+
data (optional)
+
ack_data (optional)
+
type (optional)
+
Enum:
+
UNENROLL
UPGRADE
POLICY_REASSIGN
+
+
+
+

agent_action_oneOf_1 - Up

+
+
+
type (optional)
+
data (optional)
+
+
+
+

agent_action_oneOf_1_data - Up

+
+
+
log_level (optional)
+
Enum:
+
debug
info
warning
error
+
+
+
+

agent_component - Agent component Up

+
+
+
id (optional)
+
type (optional)
+
status (optional)
+
message (optional)
+
units (optional)
+
+
+
+

agent_component_status - Agent component status Up

+
+
+
+
+
+

agent_component_unit - Agent component unit Up

+
+
+
id (optional)
+
type (optional)
+
status (optional)
+
message (optional)
+
payload (optional)
+
+
+
+

agent_component_unit_type - Agent component unit type Up

+
+
+
+
+
+

agent_policy - Up

+
+
+
id
+
name
+
namespace
+
description (optional)
+
monitoring_enabled (optional)
+
Enum:
+ +
data_output_id (optional)
+
monitoring_output_id (optional)
+
fleet_server_host_id (optional)
+
download_source_id (optional)
+
status
+
Enum:
+
active
inactive
+
package_policies (optional)
array[package_policy] This field is present only when retrieving a single agent policy, or when retrieving a list of agent policy with the ?full=true parameter
+
updated_on (optional)
Date format: date-time
+
updated_by (optional)
+
revision (optional)
+
agents (optional)
+
+
+
+

agent_policy_allOf - Up

+
+
+
id
+
status
+
Enum:
+
active
inactive
+
package_policies (optional)
array[package_policy] This field is present only when retrieving a single agent policy, or when retrieving a list of agent policy with the ?full=true parameter
+
updated_on (optional)
Date format: date-time
+
updated_by (optional)
+
data_output_id (optional)
+
monitoring_output_id (optional)
+
fleet_server_host_id (optional)
+
download_source_id (optional)
+
revision (optional)
+
agents (optional)
+
+
+
+

agent_policy_copy_request - Up

+
+
+
name
+
description (optional)
+
+
+
+

agent_policy_info_200_response - Up

+
+
+
item
+
+
+
+

agent_policy_list_200_response - Up

+
+
+
items
+
total
+
page
+
perPage
+
+
+
+

agent_status - Agent status Up

+
+
+
+
+
+

agent_type - Agent type Up

+
+
+
+
+
+

agents_action_status_200_response - Up

+
+ +
+
+

agents_action_status_200_response_items_inner - Up

+
+
+
actionId
+
status
+
Enum:
+
COMPLETE
EXPIRED
CANCELLED
FAILED
IN_PROGRESS
+
nbAgentsActioned
+
nbAgentsActionCreated
+
nbAgentsAck
+
nbAgentsFailed
+
version (optional)
+
startTime (optional)
+
type (optional)
+
expiration (optional)
+
completionTime (optional)
+
cancellationTime (optional)
+
newPolicyId (optional)
+
creationTime
+
+
+
+

agents_current_upgrades_200_response - Up

+
+ +
+
+

agents_current_upgrades_200_response_items_inner - Up

+
+
+
actionId
+
complete
+
nbAgents
+
nbAgentsAck
+
version
+
startTime
+
+
+
+

bulk_get_agent_policies_200_response - Up

+
+ +
+
+

bulk_get_agent_policies_request - Up

+
+
+
ids
array[String] list of agent policy ids
+
full (optional)
Boolean get full policies with package policies populated
+
ignoreMissing (optional)
+
+
+
+

bulk_get_package_policies_200_response - Up

+
+ +
+
+

bulk_get_package_policies_request - Up

+
+
+
ids
array[String] list of package policy ids
+
ignoreMissing (optional)
+
+
+
+

bulk_install_packages_response - Bulk install packages response Up

+
+ +
+
+

bulk_reassign_agents_request - Up

+
+
+
policy_id
String new agent policy id
+
agents
+
+
+
+

bulk_reassign_agents_request_agents - Up

+
+
+
+
+
+

bulk_request_diagnostics_request - Up

+
+
+
batchSize (optional)
+
agents
+
+
+
+

bulk_unenroll_agents_request - Up

+
+
+
revoke (optional)
Boolean Revokes API keys of agents
+
force (optional)
Boolean Unenroll hosted agents too
+
agents
+
+
+
+

bulk_update_agent_tags_request - Up

+
+
+
agents
+
tagsToAdd (optional)
+
tagsToRemove (optional)
+
batchSize (optional)
+
+
+
+

bulk_upgrade_agents - Bulk upgrade agents Up

+
+
+
version
String version to upgrade to
+
source_uri (optional)
String alternative upgrade binary download url
+
rollout_duration_seconds (optional)
BigDecimal rolling upgrade window duration in seconds
+
start_time (optional)
String start time of upgrade in ISO 8601 format
+
agents
+
force (optional)
Boolean Force upgrade, skipping validation (should be used with caution)
+
+
+
+

bulk_upgrade_agents_200_response - Up

+
+
+
actionId (optional)
+
+
+
+

create_agent_policy_200_response - Up

+
+
+
item (optional)
+
+
+
+

create_enrollment_api_keys_deprecated_200_response - Up

+
+
+
item (optional)
+
action (optional)
+
Enum:
+
created
+
+
+
+

create_package_policy_200_response - Up

+
+
+
item
+
+
+
+

create_package_policy_request - Up

+
+
+
id (optional)
+
name
+
description (optional)
+
namespace (optional)
+
policy_id
+
package
+
vars (optional)
Object Package root level variable (see integration documentation for more information)
+
inputs
+
force (optional)
+
enabled (optional)
+
output_id (optional)
+
+
+
+

create_package_policy_request_oneOf - Up

+
+
+
enabled (optional)
+
package (optional)
+
namespace (optional)
+
output_id (optional)
+
inputs
+
policy_id (optional)
+
name
+
description (optional)
+
id (optional)
+
force (optional)
+
+
+
+

create_package_policy_request_oneOf_allOf - Up

+
+
+
id (optional)
+
+
+
+

data_stream - Data stream Up

+
+
+
index (optional)
+
dataset (optional)
+
namespace (optional)
+
type (optional)
+
package (optional)
+
package_version (optional)
+
last_activity_ms (optional)
+
size_in_bytes (optional)
+
size_in_bytes_formatted (optional)
+
dashboard (optional)
+
+
+
+

data_stream_dashboard_inner - Up

+
+
+
id (optional)
+
title (optional)
+
+
+
+

data_streams_list_200_response - Up

+
+
+
data_streams (optional)
+
+
+
+

delete_agent_200_response - Up

+
+
+
action
+
Enum:
+
deleted
+
+
+
+

delete_agent_policy_200_response - Up

+
+
+
id
+
success
+
+
+
+

delete_agent_policy_request - Up

+
+
+
agentPolicyId
+
+
+
+

delete_package_policy_200_response - Up

+
+
+
id
+
+
+
+

download_sources - Download Source Up

+
+
+
id (optional)
+
is_default
+
name
+
host
+
+
+
+

elasticsearch_asset_type - Elasticsearch asset type Up

+
+
+
+
+
+

enrollment_api_key - Enrollment API key Up

+
+
+
id
+
api_key_id
+
api_key
+
name (optional)
+
active
+
policy_id (optional)
+
created_at
+
+
+
+

fleet_server_host - Fleet Server Host Up

+
+
+
id
+
name (optional)
+
is_default
+
is_preconfigured
+
host_urls
+
+
+
+

fleet_settings_response - Fleet settings response Up

+
+
+
item
+
+
+
+

fleet_setup_response - Fleet Setup response Up

+
+
+
isInitialized
+
nonFatalErrors
+
+
+
+

fleet_setup_response_nonFatalErrors_inner - Up

+
+
+
name
+
message
+
+
+
+

fleet_status_response - Fleet status response Up

+
+
+
isReady
+
missing_requirements
+
Enum:
+ +
missing_optional_features
+
Enum:
+ +
package_verification_key_id (optional)
+
+
+
+

full_agent_policy_input - Full agent policy input Up

+
+
+
id
+
name
+
revision
+
type
+
data_stream
+
use_output
+
meta (optional)
+
streams (optional)
+
+
+
+

full_agent_policy_input_allOf - Up

+
+
+
id
+
name
+
revision
+
type
+
data_stream
+
use_output
+
meta (optional)
+
streams (optional)
+
+
+
+

full_agent_policy_input_allOf_data_stream - Up

+
+
+
namespace
+
+
+
+

full_agent_policy_input_stream - Full agent policy input stream Up

+
+ +
+
+

full_agent_policy_input_stream_allOf - Up

+
+ +
+
+

full_agent_policy_input_stream_allOf_data_stream - Up

+
+
+
dataset
+
type
+
+
+
+

generate_logstash_api_key_200_response - Up

+
+
+
api_key (optional)
+
+
+
+

generate_service_token_deprecated_200_response - Up

+
+
+
name (optional)
+
value (optional)
+
+
+
+

get_agent_200_response - Up

+
+
+
item
+
+
+
+

get_agent_data_200_response - Up

+
+ +
+
+

get_agent_data_200_response_items_inner_value - Up

+
+
+
data (optional)
+
+
+
+

get_agent_status_deprecated_200_response - Up

+
+
+
error
+
events
+
inactive
+
offline
+
online
+
other
+
total
+
updating
+
+
+
+

get_agent_tags_response - Get Agent Tags response Up

+
+
+
items (optional)
+
+
+
+

get_agents_response - Get Agent response Up

+
+
+
list (optional)
+
items
+
total
+
page
+
perPage
+
+
+
+

get_categories_response - Get categories response Up

+
+ +
+
+

get_categories_response_items_inner - Up

+
+
+
id
+
title
+
count
+
+
+
+

get_categories_response_response_inner - Up

+
+
+
id
+
title
+
count
+
+
+
+

get_download_sources_200_response - Up

+
+
+
items (optional)
+
total (optional)
+
page (optional)
+
perPage (optional)
+
+
+
+

get_enrollment_api_key_deprecated_200_response - Up

+
+ +
+
+

get_enrollment_api_keys_deprecated_200_response - Up

+
+
+
list (optional)
+
items
+
page
+
perPage
+
total
+
+
+
+

get_fleet_proxies_200_response - Up

+
+
+
items (optional)
+
total (optional)
+
page (optional)
+
perPage (optional)
+
+
+
+

get_fleet_server_hosts_200_response - Up

+
+
+
items (optional)
+
total (optional)
+
page (optional)
+
perPage (optional)
+
+
+
+

get_one_download_source_200_response - Up

+
+
+
item
+
+
+
+

get_one_fleet_proxies_200_response - Up

+
+
+
item
+
+
+
+

get_one_fleet_server_hosts_200_response - Up

+
+ +
+
+

get_output_200_response - Up

+
+
+
item
+
+
+
+

get_outputs_200_response - Up

+
+
+
items (optional)
+
total (optional)
+
page (optional)
+
perPage (optional)
+
+
+
+

get_package_200_response - Up

+
+
+
item (optional)
+
status
+
Enum:
+
installed
installing
install_failed
not_installed
+
savedObject
+
latestVersion (optional)
+
keepPoliciesUpToDate (optional)
+
notice (optional)
+
licensePath (optional)
+
+
+
+

get_package_200_response_allOf - Up

+
+
+
item (optional)
+
+
+
+

get_package_200_response_allOf_1 - Up

+
+
+
status
+
Enum:
+
installed
installing
install_failed
not_installed
+
savedObject
+
latestVersion (optional)
+
keepPoliciesUpToDate (optional)
+
notice (optional)
+
licensePath (optional)
+
+
+
+

get_package_deprecated_200_response - Up

+
+
+
response (optional)
+
status
+
Enum:
+
installed
installing
install_failed
not_installed
+
savedObject
+
+
+
+

get_package_deprecated_200_response_allOf - Up

+
+
+
response (optional)
+
+
+
+

get_package_deprecated_200_response_allOf_1 - Up

+
+
+
status
+
Enum:
+
installed
installing
install_failed
not_installed
+
savedObject
+
+
+
+

get_package_policies_200_response - Up

+
+
+
items
+
total (optional)
+
page (optional)
+
perPage (optional)
+
+
+
+

get_package_stats_200_response - Up

+
+
+
response
+
+
+
+

get_packages_response - Get Packages response Up

+
+
+
response (optional)
+
items
+
+
+
+

install_package_200_response - Up

+
+ +
+
+

install_package_200_response__meta - Up

+
+
+
install_source (optional)
+
Enum:
+
registry
upload
bundled
+
+
+
+

install_package_deprecated_200_response - Up

+
+ +
+
+

install_package_deprecated_200_response_response_inner - Up

+
+ +
+
+

install_package_deprecated_200_response_response_inner_type - Up

+
+
+
+
+
+

install_package_deprecated_request - Up

+
+
+
force (optional)
+
+
+
+

install_package_request - Up

+
+
+
force (optional)
+
ignore_constraints (optional)
+
+
+
+

kibana_saved_object_type - Kibana saved object asset type Up

+
+
+
+
+
+

list_limited_packages_200_response - Up

+
+
+
items (optional)
+
+
+
+

new_agent_action_200_response - Up

+
+
+
body (optional)
+
statusCode (optional)
+
headers (optional)
+
+
+
+

new_agent_action_request - Up

+
+
+
action (optional)
+
+
+
+

new_agent_policy - New agent policy Up

+
+
+
id (optional)
+
name
+
namespace
+
description (optional)
+
monitoring_enabled (optional)
+
Enum:
+ +
data_output_id (optional)
+
monitoring_output_id (optional)
+
fleet_server_host_id (optional)
+
download_source_id (optional)
+
+
+
+

new_package_policy - New package policy Up

+
+
+
enabled (optional)
+
package (optional)
+
namespace (optional)
+
output_id (optional)
+
inputs
+
policy_id (optional)
+
name
+
description (optional)
+
+
+
+

new_package_policy_inputs_inner - Up

+
+
+
type
+
enabled
+
processors (optional)
+
streams (optional)
+
config (optional)
+
vars (optional)
+
+
+
+

new_package_policy_package - Up

+
+
+
name
+
version
+
title (optional)
+
+
+
+

output - Output Up

+
+
+
id
+
is_default
+
is_default_monitoring (optional)
+
name
+
type
+
Enum:
+
elasticsearch
+
hosts (optional)
+
ca_sha256 (optional)
+
ca_trusted_fingerprint (optional)
+
config (optional)
+
config_yaml (optional)
+
ssl (optional)
+
+
+
+

output_ssl - Up

+
+
+
certificate (optional)
+
certificate_authorities (optional)
+
key (optional)
+
+
+
+

package_info - Package information Up

+
+
+
name
+
title
+
version
+
release (optional)
String release label is deprecated, derive from the version instead (packages follow semver)
+
Enum:
+
experimental
beta
ga
+
source (optional)
+
readme (optional)
+
description
+
type
+
categories
+
conditions
+
screenshots (optional)
+
icons (optional)
+
assets
+
internal (optional)
+
format_version
+
data_streams (optional)
+
download
+
path
+
elasticsearch (optional)
+
+
+
+

package_info_conditions - Up

+
+
+
kibana (optional)
+
elasticsearch (optional)
+
+
+
+

package_info_conditions_elasticsearch - Up

+
+
+
subscription (optional)
+
Enum:
+
basic
gold
platinum
enterprise
+
+
+
+

package_info_conditions_kibana - Up

+
+
+
versions (optional)
+
+
+
+

package_info_data_streams_inner - Up

+
+
+
title
+
name
+
release
+
ingeset_pipeline
+
vars (optional)
+
type
+
package
+
+
+
+

package_info_data_streams_inner_vars_inner - Up

+
+
+
name
+
default
+
+
+
+

package_info_elasticsearch - Up

+
+
+
privileges (optional)
+
+
+
+

package_info_elasticsearch_privileges - Up

+
+
+
cluster (optional)
+
+
+
+

package_info_screenshots_inner - Up

+
+
+
src
+
path
+
title (optional)
+
size (optional)
+
type (optional)
+
+
+
+

package_info_source - Up

+
+
+
license (optional)
+
Enum:
+
Apache-2.0
Elastic-2.0
+
+
+
+

package_policy - Package policy Up

+
+
+
id
+
revision
+
inputs
+
enabled (optional)
+
package (optional)
+
namespace (optional)
+
output_id (optional)
+
policy_id (optional)
+
name
+
description (optional)
+
+
+
+

package_policy_allOf - Up

+
+
+
id
+
revision
+
inputs (optional)
+
+
+
+

package_usage_stats - Package usage stats Up

+
+
+
agent_policy_count
+
+
+
+

packages_get_file_200_response - Up

+
+
+
body (optional)
+
statusCode (optional)
+
headers (optional)
+
+
+
+

post_delete_package_policy_200_response_inner - Up

+
+
+
id
+
name (optional)
+
success
+
+
+
+

post_delete_package_policy_request - Up

+
+
+
packagePolicyIds
+
force (optional)
+
+
+
+

post_download_sources_200_response - Up

+
+
+
item (optional)
+
+
+
+

post_download_sources_request - Up

+
+
+
id (optional)
+
name
+
is_default
+
host
+
+
+
+

post_fleet_proxies_200_response - Up

+
+
+
item (optional)
+
+
+
+

post_fleet_proxies_request - Up

+
+
+
id (optional)
+
name
+
url
+
proxy_headers (optional)
+
certificate_authorities (optional)
+
certificate (optional)
+
certificate_key (optional)
+
+
+
+

post_fleet_server_hosts_200_response - Up

+
+
+
item (optional)
+
+
+
+

post_fleet_server_hosts_request - Up

+
+
+
id (optional)
+
name
+
is_default (optional)
+
host_urls
+
+
+
+

post_outputs_200_response - Up

+
+
+
item (optional)
+
+
+
+

post_outputs_request - Up

+
+
+
id (optional)
+
name
+
type
+
Enum:
+
elasticsearch
+
is_default (optional)
+
is_default_monitoring (optional)
+
hosts (optional)
+
ca_sha256 (optional)
+
config_yaml (optional)
+
+
+
+

preconfigured_agent_policies - Preconfigured agent policies Up

+
+
+
name
+
description (optional)
+
is_managed (optional)
+
unenroll_timeout (optional)
+
monitoring_enabled (optional)
+
Enum:
+ +
namespace
+
id (optional)
+
is_default (optional)
+
is_default_fleet_server (optional)
+
has_fleet_server (optional)
+
data_output_id (optional)
+
monitoring_output_id (optional)
+
package_policies
+
+
+
+

preconfigured_agent_policies_id - Up

+
+
+
+
+
+

preconfigured_agent_policies_package_policies_inner - Up

+
+
+
id (optional)
+
name (optional)
+
package (optional)
+
description (optional)
+
namespace (optional)
+
inputs (optional)
+
+
+
+

preconfigured_agent_policies_package_policies_inner_inputs_inner - Up

+
+
+
type
+
enabled (optional)
+
keep_enabled (optional)
+
vars (optional)
+
+
+
+

preconfigured_agent_policies_package_policies_inner_inputs_inner_vars - Up

+
+
+
name (optional)
+
type (optional)
+
value (optional)
+
frozen (optional)
+
+
+
+

preconfigured_agent_policies_package_policies_inner_package - Up

+
+
+
name (optional)
+
+
+
+

proxies - Fleet Proxy Up

+
+
+
id (optional)
+
name
+
url
+
proxy_headers (optional)
+
certificate_authorities (optional)
+
certificate (optional)
+
certificate_key (optional)
+
+
+
+

put_preconfiguration_200_response - Up

+
+
+
agentPolicies (optional)
+
packages (optional)
+
+
+
+

put_preconfiguration_200_response_packages - Up

+
+
+
name (optional)
+
version (optional)
+
+
+
+

put_preconfiguration_request - Up

+
+ +
+
+

put_preconfiguration_request_body - Up

+
+
+
agentPolicies (optional)
+
packages (optional)
+
+
+
+

put_preconfiguration_request_body_packages - Up

+
+
+
name
+
version
+
+
+
+

reassign_agent_request - Up

+
+
+
policy_id
+
+
+
+

search_result - Search result Up

+
+
+
description
+
download
+
icons
+
name
+
path
+
title
+
type
+
version
+
status
+
savedObject (optional)
+
+
+
+

settings - Settings Up

+
+
+
id
+
has_seen_add_data_notice (optional)
+
fleet_server_hosts
+
prerelease_integrations_enabled (optional)
+
+
+
+

setup_500_response - Up

+
+
+
message (optional)
+
+
+
+

setup_agents_request - Up

+
+
+
admin_username
+
admin_password
+
+
+
+

simplified_package_policy - Simplified Package Policy Up

+
+
+
id (optional)
String Package policy unique identifier
+
name
String Package policy name (should be unique)
+
description (optional)
String Package policy description
+
namespace (optional)
String namespace by default "default"
+
policy_id
String Agent policy ID where that package policy will be added
+
package
+
vars (optional)
Object Package root level variable (see integration documentation for more information)
+
inputs (optional)
map[String, simplified_package_policy_inputs_value] Package policy inputs (see integration documentation to know what inputs are available)
+
force (optional)
Boolean Force package policy creation even if package is not verified, or if the agent policy is managed.
+
+
+
+

simplified_package_policy_inputs_value - Up

+
+
+
enabled (optional)
Boolean enable or disable that input, (default to true)
+
vars (optional)
Object Input level variable (see integration documentation for more information)
+
streams (optional)
map[String, simplified_package_policy_inputs_value_streams_value] Input streams (see integration documentation to know what streams are available)
+
+
+
+

simplified_package_policy_inputs_value_streams_value - Up

+
+
+
enabled (optional)
Boolean enable or disable that stream, (default to true)
+
vars (optional)
Object Stream level variable (see integration documentation for more information)
+
+
+
+

simplified_package_policy_package - Up

+
+
+
name
String Package name
+
version
String Package version
+
+
+
+

unenroll_agent_400_response - Up

+
+
+
error (optional)
+
message (optional)
+
statusCode (optional)
+
Enum:
+
400
+
+
+
+

unenroll_agent_request - Up

+
+
+
revoke (optional)
+
force (optional)
+
+
+
+

update_agent_request - Up

+
+
+
user_provided_metadata (optional)
+
tags (optional)
+
+
+
+

update_download_source_request - Up

+
+
+
name
+
is_default
+
host
+
+
+
+

update_fleet_proxies_request - Up

+
+
+
name (optional)
+
url (optional)
+
proxy_headers (optional)
+
certificate_authorities (optional)
+
certificate (optional)
+
certificate_key (optional)
+
+
+
+

update_fleet_server_hosts_request - Up

+
+
+
name (optional)
+
is_default (optional)
+
host_urls (optional)
+
+
+
+

update_output_request - Up

+
+
+
name
+
type
+
Enum:
+
elasticsearch
+
is_default (optional)
+
is_default_monitoring (optional)
+
hosts (optional)
+
ca_sha256 (optional)
+
ca_trusted_fingerprint (optional)
+
config_yaml (optional)
+
+
+
+

update_package_200_response - Up

+
+ +
+
+

update_package_policy - Update package policy Up

+
+
+
version (optional)
+
enabled
+
package (optional)
+
namespace
+
output_id (optional)
String Not supported output can be set at the agent policy level only
+
inputs (optional)
+
policy_id
+
name
+
description (optional)
+
force (optional)
+
+
+
+

update_package_policy_200_response - Up

+
+
+
id (optional)
String Package policy unique identifier
+
name
String Package policy name (should be unique)
+
description (optional)
String Package policy description
+
namespace (optional)
String namespace by default "default"
+
policy_id
String Agent policy ID where that package policy will be added
+
package
+
vars (optional)
Object Package root level variable (see integration documentation for more information)
+
inputs (optional)
map[String, simplified_package_policy_inputs_value] Package policy inputs (see integration documentation to know what inputs are available)
+
force (optional)
Boolean Force package policy creation even if package is not verified, or if the agent policy is managed.
+
item
+
sucess
+
+
+
+

update_package_policy_200_response_oneOf - Up

+
+
+
item
+
sucess
+
+
+
+

update_package_policy_inputs_inner - Up

+
+
+
type
+
enabled
+
processors (optional)
+
streams
+
config (optional)
+
vars (optional)
+
+
+
+

update_package_policy_package - Up

+
+
+
name
+
version
+
title
+
+
+
+

update_package_request - Up

+
+
+
keepPoliciesUpToDate (optional)
+
+
+
+

upgrade_agent - Upgrade agent Up

+
+
+
version
+
source_uri (optional)
+
force (optional)
Boolean Force upgrade, skipping validation (should be used with caution)
+
+
+
+

upgrade_diff_inner - Up

+
+
+
id
+
revision
+
inputs
+
enabled (optional)
+
package (optional)
+
namespace (optional)
+
output_id (optional)
+
policy_id (optional)
+
name
+
description (optional)
+
errors (optional)
+
missingVars (optional)
+
+
+
+

upgrade_diff_inner_allOf - Up

+
+
+
enabled (optional)
+
package (optional)
+
namespace (optional)
+
output_id (optional)
+
inputs
+
policy_id (optional)
+
name
+
description (optional)
+
errors (optional)
+
missingVars (optional)
+
+
+
+

upgrade_diff_inner_allOf_allOf - Up

+
+
+
errors (optional)
+
missingVars (optional)
+
+
+
+

upgrade_diff_inner_allOf_allOf_errors_inner - Up

+
+
+
key (optional)
+
message (optional)
+
+
+
+

upgrade_package_policy_dry_run_200_response_inner - Up

+
+
+
hasErrors
+
diff (optional)
+
agent_diff (optional)
+
+
+
+

upgrade_package_policy_dry_run_request - Up

+
+
+
packagePolicyIds
+
packageVersion (optional)
+
+
+
+

upgrade_package_policy_request - Up

+
+
+
packagePolicyIds
+
+
+
+++++ diff --git a/docs/api-generated/fleet/fleet-apis.asciidoc b/docs/api-generated/fleet/fleet-apis.asciidoc new file mode 100644 index 0000000000000..aee6ce65bb0ae --- /dev/null +++ b/docs/api-generated/fleet/fleet-apis.asciidoc @@ -0,0 +1,13 @@ +[[fleet-apis]] +== Fleet APIs + +preview::[] + +//// +This file includes content that has been generated from https://github.com/elastic/kibana/tree/main/x-pack/plugins/fleet/common/openapi. Any modifications required must be done in that open API specification. +//// + +include::fleet-apis-passthru.asciidoc[] + + +/Users/dedemorton/go/src/github.com/elastic/kibana/x-pack/plugins/fleet/common/openapi diff --git a/docs/apis.asciidoc b/docs/apis.asciidoc index d85d9ce3f35eb..3d954ba2f6d1c 100644 --- a/docs/apis.asciidoc +++ b/docs/apis.asciidoc @@ -13,5 +13,6 @@ version of the specification is 3.0. For more information, go to https://openapi include::api-generated/cases/case-apis.asciidoc[] include::api-generated/connectors/connector-apis.asciidoc[] +include::api-generated/fleet/fleet-apis.asciidoc[] include::api-generated/machine-learning/ml-apis.asciidoc[] -include::api-generated/rules/rule-apis.asciidoc[] \ No newline at end of file +include::api-generated/rules/rule-apis.asciidoc[]