PUT Method

The PUT HTTP method is used to replace a resource with a similar resource that includes a different set of values.

New values must be provided in the request body. The following example replaces a resource that contains settings of a specific Veeam Agent for Microsoft Windows:


PUT https://localhost:1280/api/v3/infrastructure/backupAgents/windows/2a2db960-5e69-4316-a922-beb5eea409d0/settings


Request Header:

Content-Type: application/json

Authorization: Bearer <Access-Token>


Request Body:


  "disableScheduledBackups": true,

  "disableControlPanelNotification": true,

  "disableBackupOverMeteredConnection": true,

  "disableScheduleWakeup": true,

  "throttleBackupActivity": true,

  "restrictVpnConnections": true,

  "limitBandwidthConsumption": false,

  "bandwidthSpeedLimit": 0,

  "bandwidthSpeedLimitUnit": "MbitPerSec",

  "flrWithoutAdminPrivilegesAllowed": true


In some cases to replace a resource you must upload a file. The following example installs a new Veeam Backup & Replication server license.


PUT https://localhost:1280/api/v3/licensing/backupServer/41b07607-493c-428f-8b29-a2291900b0a8


Request Header:

Content-Type: multipart/form-data

Authorization: Bearer <Access-Token>


Request Body:


Content-Disposition: form-data; name="file"; filename="C:/Users/Administrator/Downloads/veeam_license.lic"


In case of success, the PUT HTTP method returns the 200 OK response code.