v2

latestOpenAPI 3.1.0raw.githubusercontent.com2024-09-26192307950.1 KB
authorized_devices

Verify Authorized Device

Verifies a specific OAuth2 authorized device using its unique ID.

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

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.

Args: device_id: The ID of the OAuth2 authorized device to update. request: The model containing the verification request. auth_context: The current auth context.

Returns: The updated OAuth2 authorized device object.

Raises: ValueError: If the device verification request fails.

put/api/v1/devices/{device_id}/verify

Path parameters

device_idstring uuid required

Request body

user_codestring required
trusted_deviceboolean

Response

Successful Response

resourcesOAuthDeviceResponseResources

Class for all resource models associated with the OAuthDevice entity.

idstring uuid required
permission_deniedboolean