Job Session History Settings

The /HistorySettings resource collection represents the history settings of backup and backup copy job sessions.

Get Job Sessions History Settings

Returns a resource representation with the history settings for backup and backup copy job sessions.

SecurityBearer
Responses
200

OK

default

Operation failure response.

get/v8/HistorySettings
Request samples
Response samples
application/json
{
  • "keepAllsessions": true,
  • "keeponlyLast": 0,
  • "_links": {
    },
  • "_actions": {
    }
}

Edit Job Sessions History Settings

Modifies history settings for backup and backup copy job sessions.

x-codegen-request-body-name: settings
SecurityBearer
Request
Request Body schema: application/json
required
keepAllsessions
boolean or null

Defines whether Veeam Backup for Microsoft 365 will keep backup and backup copy job sessions forever. Otherwise, the job sessions will be kept during 53 weeks by default.

keeponlyLast
integer or null <int32>

Number of weeks during which backup and backup copy job sessions will be kept.

object (RESTLinkHALDictionary)

Related resources.

Responses
204

No Content

default

Operation failure response.

put/v8/HistorySettings
Request samples
application/json
{
  • "keepAllsessions": true,
  • "keeponlyLast": 0,
  • "_links": {
    }
}
Response samples
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}

Document updated 12/18/2025

Page content applies to build 8.3.0.2201