Initiate Fleet setup

Server: https://{kibana_url}

POST /api/fleet/setup
POST /s/{space_id}/api/fleet/setup

Refer to Spaces for more information.

Initialize Fleet and create the necessary Elasticsearch resources for Fleet to operate. Safe to call multiple times (idempotent). Returns the initialization status and any non-fatal errors encountered during setup.

[Required authorization] Route required privileges: fleet-agents-read OR fleet-agent-policies-read OR fleet-settings-read OR fleet-setup.

Responses

Fleet setup completed

application/json

Bad Request

application/json

Internal Server Error

application/json

Examples

Fleet initialized successfully with no non-fatal errors

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST /api/fleet/setup

curl Shell

curl -X POST "https://{kibana_url}/api/fleet/setup" \
  -H "kbn-xsrf: true"

Response

{
  "isInitialized": true,
  "nonFatalErrors": []
}

{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}

{
  "error": "Internal Server Error",
  "message": "An error message describing what went wrong",
  "statusCode": 500
}