Mint a short-lived token from this key

post/keys/tokens

Mint a short-lived token from this key: at most its scopes, minutes to live, no key management.

Before you call

Credential: Authorization: Bearer $KEY
Scope: keys:write
Sdk: keys.token.create
Cli: keys token create
Events: keys.token.minted

Request bodyapplication/json, required

scopeslist of string
ttlSecondsinteger
At least 60. At most 3600.
allowedOriginslist of string
ipAllowlistlist of string
rpmLimitinteger
At least 1. At most 100000.
subjectstring
At most 120 characters.

Responses

201application/json
Success
- tokenstringrequired
- token_typeBearerrequired
- expires_innumberrequired
- expires_atstringrequired
- scopeslist of stringrequired
- key_idstringrequired
400application/json
The request was malformed
- errorstringrequired
- messagestring
401application/json
No valid credential
- errorstringrequired
- messagestring
403application/json
The credential lacks the scope, origin or address
- errorstringrequired
- messagestring
429application/json
Over the key's rate limit; see Retry-After
- errorstringrequired
- messagestring

Example request

curl -X POST 'https://api.rivier.ai/keys/tokens' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "scopes": [
    "string"
  ],
  "ttlSeconds": 0,
  "allowedOrigins": [
    "string"
  ],
  "ipAllowlist": [
    "string"
  ],
  "rpmLimit": 0,
  "subject": "string"
}'

$KEY stands for your own key. No key is shown or kept on this site.

This page as Markdown