v1

latestOpenAPI 3.0.12026-06-115557102.5 KB

Create authorization

Starts an authorization flow

post/authorizations

Request body

challengestring required

The challenge that will later be needed to retrieve the token after authorization.

Example request

{
  "challenge": "1234567890abcdef",
  "permissions": [
    {
      "scope": "denoland"
    }
  ]
}

Response

OK

verificationUrlstring required

The URL that the user should visit to approve the authorization.

codestring required

The authorization code that the user can manually enter if they can not directly visit the link.

exchangeTokenstring required

The token that can be used to exchange for a device token after the authorization has been approved.

pollIntervalinteger required

The number of seconds that should be waited between polling the status of the authorization.

expiresAtstring date-time required

The date and time until which the authorization can be approved / exchanged.