Skip to main content
POST
/
v1
/
token_refresh
curl
curl -X POST https://your-ocient-instance/v1/token_refresh \
    -H "Authorization: Bearer YOUR_CURRENT_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
        "database": "retail_analytics"
    }'
{
  "access_token": "eyJhb...",
  "username": "jdoe",
  "database": "retail_analytics",
  "expires_in": 3600,
  "status": {
    "reason": "Token refreshed 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.

Headers

​
Authorization
string
required

The bearer token, which must be a valid access token still within its refresh lifetime configured on the server. To obtain a token, call either the /v1/login or /v1/token_refresh endpoints.

​
Content-Type
string
required

Specifies the request body format. Use the value: application/json.

Body

application/json
​
database
string

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

Response

200 - application/json

Response

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