Update an agent binary download source

Base URL: https://{kibana_url}

PUT /api/fleet/agent_download_sources/{sourceId}
PUT /s/{space_id}/api/fleet/agent_download_sources/{sourceId}

Auth

Update an agent binary download source by ID.

Required privileges

Privileges fleet-settings-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.
sourceId string · min length: 0 required: The ID of the download source

Header parameters

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

Request body

auth object nullable
host string · format: uri required
id string
is_default boolean · default: false
name string required
proxy_id string nullable: The ID of the proxy to use for this download source. See the proxies API for more information.
reserve_diskspace boolean: If true, Elastic Agent reserves disk space equal to the size of the new agent package before an upgrade, so the upgrade fails early if there is not enough space. If not set, defaults to true on the agent side.
secrets object
ssl object

Responses

Successful response

application/json

item object required

Bad Request

application/json

404

Not Found

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Update an agent binary download source

Console Kibana Dev Tools

PUT kbn:/api/fleet/agent_download_sources/SOURCE_ID
{
  "host": "https://updated-host.example.com/downloads/",
  "is_default": false,
  "name": "Updated download source"
}

Generated from the API spec

curl Shell

curl -X PUT "${KIBANA_URL}/api/fleet/agent_download_sources/${SOURCE_ID}" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "https://updated-host.example.com/downloads/",
    "is_default": false,
    "name": "Updated download source"
  }'

Generated from the API spec

Response

The updated agent binary download source

{
  "item": {
    "host": "https://updated-host.example.com/downloads/",
    "id": "download-source-id-1",
    "is_default": false,
    "name": "Updated download source"
  }
}

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

{
  "error": "Not Found",
  "message": "Download source download-source-id-1 not found",
  "statusCode": 404
}