Tokens

Use tokens to facilitate authentication to the NVIDIA Run:ai API. The API server must be configured to use the NVIDIA Run:ai identity service to validate authentication tokens.

Create a token

post

Create tokens using the grant_type parameter.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication

Body

application/json

grantTypeundefined · enumOptionalPossible values:

appIDstringOptionalDeprecated

appSecretstringOptionalDeprecated

codestringOptional

redirectUristringOptional

refreshTokenstringOptional

usernamestringOptional

passwordstringOptional

clientIDstringOptional

clientSecretstringOptional

externalTokenstringOptional

Responses

200

Executed successfully.

application/json

400

Bad request.

application/json

500

unexpected error

application/json

503

unexpected error

application/json

post

/api/v1/token

HTTPcURLJavaScriptPython

POST /api/v1/token HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "grantType": "client_credentials",
  "clientID": "clientID",
  "clientSecret": "clientSecret"
}

client_credentialsrefresh_tokenexchange_tokenexternal_token_exchangeapp_token (deprecated)

{
  "accessToken": "text",
  "idToken": "text",
  "refreshToken": "text"
}

Deprecated

get application token

post

Retrieve access token for an application. The application token is retrieved from the authorization server. This endpoint is deprecated. Use /api/v1/token with the grantType parameter set to app_token instead, with AppID and appSecret set accordingly to get an application token

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication

Body

application/json

idstringRequired

namestringRequired

secretstringRequired

Responses

200

Executed successfully.

application/json

400

Bad request.

application/json

500

unexpected error

application/json

503

unexpected error

application/json

post

/v1/k8s/auth/oauth/apptoken

HTTPcURLJavaScriptPython

POST /v1/k8s/auth/oauth/apptoken HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "id": "text",
  "name": "text",
  "secret": "text"
}

{
  "access_token": "text",
  "id_token": "text"
}