Verify

Verify Authorized Device

put

Verifies an OAuth2 authorized device using its unique user code.

This endpoint implements the web user authorization step in the OAuth2 device authorization grant flow as defined in https://tools.ietf.org/html/rfc8628. It is called from the dashboard to verify an OAuth device using its user code.

The request is expected to contain at least the user code. Optionally, the trusted device flag can be set to indicate that the device is trusted and will not require a re-verification in the near future. Additionally, the dashboard may set metadata fields to store additional information about the device that will be passed to the client at the end of the device authorization flow (e.g. a default workspace ID to be pre-selected).

If the user code is valid, the device is marked as verified and associated with the user that authorized the device. This association is required to be able to issue access tokens or revoke the device later on. The user code is invalidated and cannot be used for further authorizations.

Args: request: The model containing the verification request. user: The authorized user. user_manager: The user manager.

Returns: The updated OAuth2 authorized device object.

Authorizations

Body

OAuth2 device authorization verification request.

user_codestringRequired

trusted_devicebooleanOptionalDefault: false

device_metadataobjectOptional

Responses

application/json

objectOptional

Response body for OAuth2 devices.

application/json

put

HTTPcURLJavaScriptPython

PUT /devices/verify HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "user_code": "text",
  "trusted_device": true,
  "device_metadata": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "created": "2025-04-21T16:49:05.607Z",
  "updated": "2025-04-21T16:49:05.607Z",
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "client_id": "123e4567-e89b-12d3-a456-426614174000",
  "expires": "2025-04-21T16:49:05.607Z",
  "trusted_device": true,
  "status": "pending",
  "os": "text",
  "ip_address": "text",
  "hostname": "text",
  "city": "text",
  "region": "text",
  "country": "text",
  "last_login": "2025-04-21T16:49:05.607Z",
  "device_metadata": {}
}