Skip to main content
POST
/
v1
/
sso_device_grant_verify
curl
curl -X POST https://my_sql_node.com/v1/sso_device_grant_verify \
    -H "Content-Type: application/json" \
    -d '{
        "user_code": "BCDFGHJK",
        "timeout": 60,
        "database": "retail_analytics"
    }'
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJqZG9lIiwiZGIiOiJyZXRhaWxfYW5hbHl0aWNzIiwiZXhwIjoxNjM1NDYxNzEyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  "username": "jdoe",
  "database": "retail_analytics",
  "status": {
    "reason": "Authentication successful",
    "sql_state": "00000",
    "vendor_code": 0
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ocient.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
user_code
string
required

The user code returned from a previous device grant request using the sso_device_grant endpoint.

database
string

Target database name. If you do not specify this parameter, the request defaults this value to system.

timeout
string

The verification timeout, in seconds, indicates how long the server waits for the user to complete the device authorization process before returning a timeout error.

The default value is 30 seconds.

The valid range is 1-600 seconds (10 minutes).

Response

200 - application/json

Response

access_token
string
username
string
database
string
status
object
Last modified on May 20, 2026