Device authorization

Device Authorization

post

OAuth2 device authorization endpoint.

This endpoint implements the OAuth2 device authorization grant flow as defined in https://tools.ietf.org/html/rfc8628. It is called to initiate the device authorization flow by requesting a device and user code for a given client ID.

For a new client ID, a new OAuth device is created, stored in the DB and returned to the client along with a pair of newly generated device and user codes. If a device for the given client ID already exists, the existing DB entry is reused and new device and user codes are generated.

Args: request: The request object. client_id: The client ID.

Returns: The device authorization response.

Raises: HTTPException: If the device authorization is not supported.

Body

client_idstring · uuidRequired

Responses

post

HTTPcURLJavaScriptPython

POST /api/v1/device_authorization HTTP/1.1
Host: 
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 52

"client_id='123e4567-e89b-12d3-a456-426614174000'"

{
  "device_code": "text",
  "user_code": "text",
  "verification_uri": "text",
  "verification_uri_complete": "text",
  "expires_in": 1,
  "interval": 1
}