Add Server Token

URL: http://{tenantFQDN}/admin/api/v1/serverTokens

Method: POST

Authentication: Super credentials

Request body

Field 

Data type

Mandatory

Description

Validations

serverToken

String

Y

Token is in GUID format.

It is validated by GUID 8-3-3-3-12 characters (alpha-numeric).

{

  "token": "c060aea2-5d5c-4792-b162-e7f6bfe5472d"

}

Response body

Field

Data type

Mandatory

Description

version

String

Y

Defines the version of the API.

status

String

Y

Defines the response status. For a successful response, its value will be “success”.

data

Object

Y

This is the element which encapsulates the API response. For this API, its value is null.

{

  "version": "1",

  "status": "success",

  "data": null

}

HTTP status codes, error codes, and messages

HTTP response code

Error code

Error message

Scenario

400

 

Bad request

 

401

 

Unauthorized

 

403

 

Forbidden

 

500

 

Internal server error

 

{

  "version": 1,

  "status": "failure",

  "error": {

    "code": 101033,

    "message": "Bad request",

    "errors": []

  }

}