Skip to main content
POST
/
v1
/
sso_authentication
curl
curl -X POST https://my_sql_node.com/v1/sso_authentication \
    -H "Content-Type: application/json" \
    -d '{
        "database": "retail_analytics",
        "sso_callback_path": "/auth/callback",
        "do_redirect": true
    }'
{
  "status": {
    "reason": "Query executed successfully",
    "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
​
database
string

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

​
sso_callback_path
string

Local path for redirection after successful authentication. This path should be registered with your OpenID provider as a valid redirect URI.

​
do_redirect
boolean

Determines whether to issue the redirect to the authentication server immediately.

If you set this value to true (default), the API responds with a 302 redirect to the OpenID provider.

If you set this value to false, the API returns the URL in the response body, allowing the client to handle the redirect manually.

If you have no SSO configuration for the database, an error occurs if this parameter value is set to true. Otherwise, the request returns an empty redirect.

Response

Response

​
status
object
Last modified on May 20, 2026