This is an archive version of the document. To get the most up-to-date information, see the current version.Activate Agent
You can activate Veeam backup agent on a computer with the specified ID. If a computer has no Veeam backup agent installed, the request will initiate agent deployment first.
Request
To deploy and activate backup agent on a discovered computer, send the POST HTTPS request to the URL of the /computers/{ID}/action resource.
HTTPS Request
POST https://<hostname>:1281/v2/computers/{ID}/action |
Request Headers
The request header must contain the authorization token.
Request Body
In the request body, the client must send the activate action property with the null value:
{"activate": null} |
Response
The server returns the following response to the client.
Response Code
A successfully completed operation returns response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTP headers.
Header | Description |
Content-length | The length of the response body. |
Content-type | The media type and syntax of the request body message: application/json; charset=utf-8 |
Response Body
In the response body, Veeam Service Provider Console returns a status and a message for an action.
Example 
The following request activates agent on a discovered computer with ID 4d831142-aa0c-d333-a825-999cdda6014c.
Request: POST https://localhost:1281/v2/computers/4d831142-aa0c-d333-a825-999cdda6014c/action
Request Header: Content-Type: application/json Authorization: Bearer <Access-Token>
Request Body: {"activate": null}
Response Code: 200 Success
Response Body: "Management agent deployment. Task ID: 6a30a735-2152-42cd-a07e-ba4c124a7658" |