Bulk upgrade packages

Base URL: https://{kibana_url}

POST /api/fleet/epm/packages/_bulk_upgrade
POST /s/{space_id}/api/fleet/epm/packages/_bulk_upgrade

Auth

Upgrade multiple packages to their latest versions.

Required privileges

Privileges integrations-all and fleet-agent-policies-all

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

Header parameters

kbn-xsrf string required: A required header to protect against CSRF attacks

Request body

acknowledge_breaking_changes boolean · default: false: When true, acknowledge the breaking changes listed in the package changelog for the versions being upgraded. Without it, an upgrade whose version range includes breaking changes is rejected. The force flag does not bypass this check.
force boolean · default: false
packages object[] · min items: 1 · max items: 1000 required
prerelease boolean
upgrade_package_policies boolean · default: false

Responses

Successful response

application/json

taskId string required

Bad Request

application/json

View as Markdown

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Upgrade multiple packages to their latest versions

Console Kibana Dev Tools

POST kbn:/api/fleet/epm/packages/_bulk_upgrade
{
  "packages": [
    {
      "name": "system"
    },
    {
      "name": "elastic_agent"
    }
  ]
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/api/fleet/epm/packages/_bulk_upgrade" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "packages": [
      {
        "name": "system"
      },
      {
        "name": "elastic_agent"
      }
    ]
  }'

Generated from the API spec

Response

Bulk upgrade task initiated

{
  "taskId": "task-id-1"
}

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