Skip to main content
POST
/
v1
/
sso-device-grant-verify
Verify device grant
curl --request POST \
  --url https://{sql-node}/v1/sso-device-grant-verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_code": "BCDFGHJK",
  "timeout": 60,
  "database": "retail_analytics"
}
'
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "username": "jdoe",
  "database": "retail_analytics",
  "status": {
    "reason": "Authentication successful",
    "sql_state": "00000",
    "vendor_code": 0
  }
}

Body

application/json
user_code
string
required

The user code from a previous device grant request

database
string

Target database name. Defaults to 'system' if not specified.

timeout
integer
default:30

Verification timeout in seconds (1-600)

Required range: 1 <= x <= 600

Response

Verification successful

access_token
string

Authentication token for subsequent requests

username
string

Authenticated username

database
string

Connected database

status
object

Status information for API responses