GET/api/apps/{app_id}/device-authorizationAuthenticated

Get 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 applications

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials
Who may call
Any authenticated user

Path parameters

NameTypeDescription
app_id*string

Client application id

Responses

application/json
AppDeviceAuthorizationPolicyResponse
PropertyTypeDescription
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 (POST /api/oidc/device_authorization) and redeem them

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>'