Note: This command is not REST-compliant.

If a key has an active SUS, you can renew it by using the renew-sus command and setting another expiration date.

Signature

Request:

  • URL: /30/keys/<KEY_ID_OR_ACTIVATION_CODE>/renew-sus
  • Method: POST
  • Body: no
  • Optional query string parameters:
    • return-key-state (boolean). Defines whether to return the Partner API 3.0’s License Key Structure of a renewed key in the response (false by default).

Response:

  • Success status code: 200
  • Body: Partner API 3.0’s License Key Structure. The body is not empty if the return-key-state parameter was enabled.

Example

Get key state

Request:

GET /30/keys/12345678 HTTP/1.1

Response:

HTTP/1.1 200 OK

{
  "keyIdentifiers" : {
    "keyId" : 12345678,
     ...
  }
  ...
  "susExpirationDate" : "2016-06-16T00:00:00.000Z",
  "susStatus" : "ACTIVE",
  ...
}

Renew SUS

Request:

POST /30/keys/12345678/renew-sus?return-key-state=yes HTTP/1.1

Response:

HTTP/1.1 200 OK

{
  "ownerId" : "12345",
  "keyIdentifiers" : {
    "keyId" : 12345678,
     ...
  }
  ...
  "susExpirationDate" : "2017-06-16T00:00:00.000Z",
  "susStatus" : "ACTIVE",
  ...
}