Page Comparison

...

POST

rest/ksso/api/apitokens/12.0/user/tokens

With request body to create token with custom description and duration

Code Block

language	json

{
"tokenName": "Example name"
"description":"Longer free-text optional description about the token's purpose",
"validForDays":"180"
}

resulting in HTTP 201:

Code Block

language	json

{
  "validForDays": "180",
  "expiresAt": "2022-07-03T18:27",
  "apiToken": "YXPTJ2N52YYDDMKDHVYMQW2R7J7KMCJHQMDMUELXPKWDTR4QGRPKKS5BYTAPYAKBCMKKAMF2G3B6ATA2CVN3RWAFJX22MJEWC6QU2HTQIFJ4MVA4LOHS2ZKZ6OP3DKGR",
  "tokenName": "Example name"
  "description":"Longer free-text optional description about the token's purpose",
  "id": 67,
  "expiresAtMillis": 1656865644754
}

With empty JSON body for default values
{}

resulting in HTTP 201:

Code Block

language	json

{
  "validForDays": "30",
  "expiresAt": "2022-02-03T17:29",
  "apiToken": "UEBDRPDHDWL4UKZS6DADIKTBU2WAULTDMR2NL2M2EPTKWMES2LHGISUBP7LRZUQ5N6VAT5LHJS3ZGEI7O2AASCC5BC52RC5YDP4QI76BU4GVEGKEAMKZQ73B234O3GF7",
  "tokenName": "api_token_2022-01-04T17:29:02.042",
  "description": "",
  "id": 68,
  "expiresAtMillis": 1643905742042
}

With validForever for non-expiring token

Code Block
{ "tokenName": "Example name" "description":"Longer free-text optional description about the token's purpose", "isValidForever":true }

resulting in HTTP 201:

Code Block

{
  "apiToken": "64MVETBSHR7GFUXYCAPGPSERMOSKLLOQJHCVRXOYHWHGNUUZGUEDJFRARWCBPUZLXCNLZERXUCSB4D3H4TNSFTFY34C5IHEDILN7RXXNL6B2YVT4P7VBBE4RK7VMDZIO",
  "validForDays": "Forever",
  "tokenName": "Example name"
  "description":"Longer free-text optional description about the token's purpose",
  "id": 130,
  "expiresAt": "Never"
}

...

/rest/ksso/api/apitokens/12.0/user/expiry/status?id=65

...

Versions Compared

Old Version 6

New Version 7

Key