GET
/api/apps/{app_id}/device-authorizationAuthenticatedGet an app's device authorization grant setting
Whether the client application may use the OAuth 2.0 device authorization grant (RFC 8628): start device flows at POST /api/oidc/device_authorization and redeem them at the token endpoint. Off for every app until its managers enable it. Requires management access; hardcoded apps cannot be configured.
operationId
get_api_apps_app_id_device_authorizationClient applicationsAuthentication & permissionsAuthenticated
Any authenticated user
- Accepted credentials
- Auth server session (refresh token cookie)
cookie "refresh_token_<auth_server_app_id>" - Access token (cookie)
cookie "access_token_<auth_server_app_id>" - Access token (Bearer)
Authorization: Bearer <JWT>
- Auth server session (refresh token cookie)
- Who may call
- Any authenticated user
Path parameters
| Name | Type | Description |
|---|---|---|
| app_id* | string | Client application id |
Responses
application/json
AppDeviceAuthorizationPolicyResponse
| Property | Type | Description |
|---|---|---|
| success* | true | |
| available* | boolean | Whether the app can use the grant at all: false for dynamically registered clients, which never can |
| enabled* | boolean | Whether the app may start device flows ( |
| enabled_at* | integer | null | null | When it was enabled (Unix epoch ms); null when disabled |
JSONExample
"success"true
"available"true
"enabled"true
"enabled_at"1
Example request
bashcurl
curl -X GET 'https://auth.botreeinc.com/api/apps/<app_id>/device-authorization' \
-b 'refresh_token_<auth_server_app_id>=<value>'