Access Token (POST)

In order to perform actions using the Harmony SASE API, a temporary authorization token must be generated using the workspace API Key.

POST /v1/auth/authorize

Note:

Each generated access token expires 60 minutes after being issued

Parameters: None

Request Body:

Property	Data Type	Description
grantType	String	Authorize request type: 'api_key'.
apiKey	String	API key from Generate New Token in the web client.

Request Example:

curl -X 'POST' -H 'Content-Type: application/json' \
-d '{                          
  "grantType": "api_key",
  "apiKey": "<API_KEY>"
}' 'https://api.perimeter81.com/api/v1/auth/authorize'

For EU tenant:

curl -X 'POST' -H 'Content-Type: application/json' \-d '{ "grantType": "api_key", "apiKey": "<API_KEY>"}' 'https://api.eu.sase.checkpoint.com/api/v1/auth/authorize'

Response:

Status Code	Message/JSON Response Body	Description
200	See Response Body table below.	Success. Access token and expiration time returned.

Response Body:

Property	Data Type	Description
data	Object	Return object with access token and its expiration timestamp.
token	String	Type of token. Value is ‘bearer’.
accessToken	String	Access token. Expires according to accessTokenExpire.
accessTokenExpire	Date	Timestamp of access token’s expiration.

Response Example:

{
   "data":{
      "tokenType":"bearer",
      "accessToken":"<ACCESS_TOKEN>",
      "accessTokenExpire":<TOKEN_EXPIRE_TIME>
   }
}

Now you can use the APIs for external calls during the following hour.