POST Method

The POST HTTP method can be used in two different ways:

Post a New Resource

All requests that create a new resource require a request body. The body must contain properties for this resource. For example, to create a new location, send the following request:

Request:

POST https://<hostname>:1280/api/v3/organizations/locations

 

Request Header:

Content-Type: application/json

Authorization: Bearer <Access-Token>

 

Request Body:

{

   "organizationUid": "89d3b0c2-529f-4d51-988a-d8ae92f3259b",

   "name": "Default location",

   "quotaGb": 10,

   "isDefault": false

}

Post an Action

Requests that perform an action do not require a request body. For example, to undo a failover plan, send the following request:

Request:

POST https://<hostname>:1280/api/v3/failoverPlans/{planUid}/undo

 

Request Header:

Content-Type: application/json

Authorization: Bearer <Access-Token>

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