Veeam Backup & Replication 13
REST API Reference
Related documents

General Options

The General Options section defines paths and operations for retrieving and editing general settings of Veeam Backup & Replication.

NOTE
In this REST API version, you can configure SIEM integration and notification settings only.

Get General Options

The HTTP GET request to the /api/v1/generalOptions path allows you to get Veeam Backup & Replication settings.

Available to: Veeam Backup Administrator.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.1-rev2

Version and revision of the client REST API. Must be in the following format: <version>-<revision>.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.

404

Not found. No object was found with the path parameter specified in the request.

500

Internal server error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v1/generalOptions
Request samples 
Response samples 
application/json
{
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}
Edit General Options
The HTTP PUT request to the /api/v1/generalOptions path allows you to edit Veeam Backup & Replication settings.
Available to: Veeam Backup Administrator.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.1-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Request Body schema: application/json
required
object (GeneralOptionsEmailNotificationsModel) 
Global email notification settings and job notifications.


 
object (GeneralOptionsNotificationsModel) 
Other notifications such as notifications on low disk space, support contract expiration, and available updates.


 
object (GeneralOptionsSiemIntegrationModel) 
SIEM integration settings.


 
Responses 
200
Settings have been updated.


400
Bad request. This error is related to POST/PUT requests. The request body is malformed, incomplete or otherwise invalid.


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


500
Internal server error. The request has been received but could not be completed because of an internal error at the server side.


put/api/v1/generalOptions
Request samples 
application/json
{
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}
Response samples 
application/json
{
  • "emailSettings": {
    },
  • "notifications": {
    },
  • "siemIntegration": {
    }
}