Authlete Token Operations API
API endpoints for various token related operations, including creating, revoking and deleting access_tokens with specified scopes.
API endpoints for various token related operations, including creating, revoking and deleting access_tokens with specified scopes.
openapi: 3.0.3
info:
title: Authlete Authorization Endpoint Token Operations API
description: "Welcome to the **Authlete API documentation**. Authlete is an **API-first service** where every aspect of the \nplatform is configurable via API. This documentation will help you authenticate and integrate with Authlete to \nbuild powerful OAuth 2.0 and OpenID Connect servers.\n\nAt a high level, the Authlete API is grouped into two categories:\n\n- **Management APIs**: Enable you to manage services and clients.\n- **Runtime APIs**: Allow you to build your own Authorization Servers or Verifiable Credential (VC) issuers.\n\n## \U0001F310 API Servers\n\nAuthlete is a global service with clusters available in multiple regions across the world:\n\n- \U0001F1FA\U0001F1F8 **US**: `https://us.authlete.com`\n- \U0001F1EF\U0001F1F5 **Japan**: `https://jp.authlete.com`\n- \U0001F1EA\U0001F1FA **Europe**: `https://eu.authlete.com`\n- \U0001F1E7\U0001F1F7 **Brazil**: `https://br.authlete.com`\n\nOur customers can host their data in the region that best meets their requirements.\n\n## \U0001F511 Authentication\n\nAll API endpoints are secured using **Bearer token authentication**. You must include an access token in every request:\n\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n\n### Getting Your Access Token\n\nAuthlete supports two types of access tokens:\n\n**Service Access Token** - Scoped to a single service (authorization server instance)\n\n1. Log in to [Authlete Console](https://console.authlete.com)\n2. Navigate to your service → **Settings** → **Access Tokens**\n3. Click **Create Token** and select permissions (e.g., `service.read`, `client.write`)\n4. Copy the generated token\n\n**Organization Token** - Scoped to your entire organization\n\n1. Log in to [Authlete Console](https://console.authlete.com)\n2. Navigate to **Organization Settings** → **Access Tokens**\n3. Click **Create Token** and select org-level permissions\n4. Copy the generated token\n\n> ⚠️ **Important Note**: Tokens inherit the permissions of the account that creates them. Service tokens can only \n> access their specific service, while organization tokens can access all services within your org.\n\n### Token Security Best Practices\n\n- **Never commit tokens to version control** - Store in environment variables or secure secret managers\n- **Rotate regularly** - Generate new tokens periodically and revoke old ones\n- **Scope appropriately** - Request only the permissions your application needs\n- **Revoke unused tokens** - Delete tokens you're no longer using from the console\n\n### Quick Test\n\nVerify your token works with a simple API call:\n\n```bash\ncurl -X GET https://us.authlete.com/api/service/get/list \\\n -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```\n\n## \U0001F393 Tutorials\n\nIf you're new to Authlete or want to see sample implementations, these resources will help you get started:\n\n- [Getting Started with Authlete](https://www.authlete.com/developers/getting_started/)\n- [From Sign-Up to the First API Request](https://www.authlete.com/developers/tutorial/signup/)\n\n## \U0001F6E0 Contact Us\n\nIf you have any questions or need assistance, our team is here to help:\n\n- [Contact Page](https://www.authlete.com/contact/)\n"
version: 3.0.16
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- description: 🇺🇸 US Cluster
url: https://us.authlete.com
- description: 🇯🇵 Japan Cluster
url: https://jp.authlete.com
- description: 🇪🇺 Europe Cluster
url: https://eu.authlete.com
- description: 🇧🇷 Brazil Cluster
url: https://br.authlete.com
security:
- bearer: []
tags:
- name: Token Operations
description: API endpoints for various token related operations, including creating, revoking and deleting access_tokens with specified scopes.
x-tag-expanded: false
paths:
/api/{serviceId}/auth/token/get/list:
get:
summary: List Issued Tokens
description: 'Get the list of access tokens that are associated with the service.
'
parameters:
- in: path
name: serviceId
description: A service ID.
required: true
schema:
type: string
- in: query
name: clientIdentifier
schema:
type: string
required: false
description: 'Client Identifier (client ID or client ID alias).
'
- in: query
name: subject
schema:
type: string
required: false
description: 'Unique user ID.
'
- in: query
name: start
schema:
type: integer
format: int32
required: false
description: Start index of search results (inclusive). The default value is 0.
- in: query
name: end
schema:
type: integer
format: int32
required: false
description: 'End index of search results (exclusive). The default value is 5.
'
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/token_get_list_response'
example:
accessTokens:
- accessTokenExpiresAt: 1642048149000
accessTokenHash: tC5hpjGylLiiw-vsd5_tqVHtYSUHblAGimEJ-5xqAco
clientId: 26888344961664
createdAt: 1642044549000
grantType: AUTHORIZATION_CODE
lastRefreshedAt: 0
refreshTokenExpiresAt: 1642048149000
refreshTokenHash: jv4B_7_kpY-Rez_E7bYIxGYnZk43w18uigkaeUe6tc4
scopes:
- history.read
subject: john
- accessTokenExpiresAt: 1642051604000
accessTokenHash: Bk1QneTxkoLKw_RRB8ToVL25Plt075RvPK68N9cWWtg
clientId: 26888344961664
createdAt: 1642048004000
grantType: AUTHORIZATION_CODE
lastRefreshedAt: 0
refreshTokenExpiresAt: 1642051604000
refreshTokenHash: YHmwk4xETvoIJ_maWCpJDlpvmcFLkxmaaSS-v9KPng4
scopes:
- history.read
- openid
- timeline.read
subject: john
- accessTokenExpiresAt: 1642052094000
accessTokenHash: UUatYXjkqYFbRQlnItjq03DtUYA2MRRtuL88GCbQpbw
clientId: 26888344961664
createdAt: 1642048494000
grantType: AUTHORIZATION_CODE
lastRefreshedAt: 0
refreshTokenExpiresAt: 1642052094000
refreshTokenHash: wjc-IXoScxDiVyBmRrB92I-B0zMXSSKw_qwP_WK1lFM
scopes:
- history.read
subject: john
client:
clientId: 26888344961664
clientIdAliasEnabled: false
clientName: My Device Flow Client
clientType: CONFIDENTIAL
number: 6260
end: 3
start: 0
subject: john
totalCount: 3
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'500':
$ref: '#/components/responses/500'
operationId: auth_token_get_list_api
x-code-samples:
- lang: shell
label: curl
source: 'curl -v https://us.authlete.com/api/21653835348762/auth/token/get/list/?clientIdentifier=26888344961664\&subject=john\&start=0\&end=3 \
-H ''Authorization: Bearer V5a40R6dWvw2gMkCOBFdZcM95q4HC0Z-T0YKD9-nR6F''
'
- lang: java
label: java
source: 'AuthleteConfiguration conf = ...;
AuthleteApi api = AuthleteApiFactory.create(conf);
String clientIdentifier = "26888344961664";
String subject = "john";
int start = 0;
int end = 3;
api.getTokenList(clientIdentifier, subject, start, end);
'
- lang: python
source: 'conf = ...
api = AuthleteApiImpl(conf)
clientIdentifier = ''26888344961664''
subject = ''john''
start = 0
end = 3
api.getTokenList(clientIdentifier, subject, start, end)
'
tags:
- Token Operations
/api/{serviceId}/auth/token/create:
post:
summary: Create Access Token
description: 'Create an access token.
'
parameters:
- in: path
name: serviceId
description: A service ID.
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/token_create_request'
example:
grantType: AUTHORIZATION_CODE
clientId: 26888344961664
subject: john
scopes:
- history.read
- timeline.read
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/token_create_request'
responses:
'200':
description: Token created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/token_create_response'
example:
resultCode: A109001
resultMessage: '[A109001] An access token was created successfully: authorization_code, client = 26888344961664'
accessToken: Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q
action: OK
clientId: 26888344961664
expiresAt: 1642048148973
expiresIn: 3600
grantType: AUTHORIZATION_CODE
refreshToken: 9beh15GWkGLseBBO1tPobnsGpKLHV3mTkm0EWnNBa4g
scopes:
- history.read
- timeline.read
subject: john
tokenType: Bearer
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'500':
$ref: '#/components/responses/500'
operationId: auth_token_create_api
x-code-samples:
- lang: shell
label: curl
source: 'curl -v -X POST https://us.authlete.com/api/21653835348762/auth/token/create \
-H ''Content-Type:application/json'' \
-H ''Authorization: Bearer V5a40R6dWvw2gMkCOBFdZcM95q4HC0Z-T0YKD9-nR6F'' \
-d ''{ "grantType": "AUTHORIZATION_CODE", "clientId": 26888344961664, "subject": "john", "scopes": [ "history.read", "timeline.read" ] }''
'
- lang: java
label: java
source: 'AuthleteConfiguration conf = ...;
AuthleteApi api = AuthleteApiFactory.create(conf);
TokenCreateRequest req = new TokenCreateRequest();
req.setGrantType(GrantType.AUTHORIZATION_CODE)
req.setClientId(26888344961664)
req.setSubject("john")
req.setScopes({ "history.read", "timeline.read" });
api.tokenCreate(req);
'
- lang: python
source: 'conf = ...
api = AuthleteApiImpl(conf)
req = TokenCreateRequest()
req.grantType = GrantType.AUTHORIZATION_CODE
req.clientId = 26888344961664
req.subject = ''john''
req.scopes = [ ''history.read'', ''timeline.read'' ]
api.tokenCreate(req)
'
tags:
- Token Operations
/api/{serviceId}/auth/token/update:
post:
summary: Update Access Token
description: 'Update an access token.
'
parameters:
- in: path
name: serviceId
description: A service ID.
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/token_update_request'
example:
accessToken: Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q
scopes:
- history.read
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/token_update_request'
responses:
'200':
description: Token updated successfully
content:
application/json:
schema:
$ref: '#/components/schemas/token_update_response'
example:
resultCode: A135001
resultMessage: '[A135001] Updated the access token successfully.'
accessToken: Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q
accessTokenExpiresAt: 1642048149000
action: OK
scopes:
- history.read
tokenType: Bearer
links:
token_issue:
$ref: '#/components/links/token_issue'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'500':
$ref: '#/components/responses/500'
operationId: auth_token_update_api
x-code-samples:
- lang: shell
label: curl
source: 'curl -v -X POST https://us.authlete.com/api/21653835348762/auth/token/update \
-H ''Content-Type:application/json'' \
-H ''Authorization: Bearer V5a40R6dWvw2gMkCOBFdZcM95q4HC0Z-T0YKD9-nR6F'' \
-d ''{ "accessToken": "Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q", "scopes": [ "history.read" ] }''
'
- lang: java
label: java
source: 'AuthleteConfiguration conf = ...;
AuthleteApi api = AuthleteApiFactory.create(conf);
TokenUpdateRequest req = new TokenUpdateRequest();
req.setAccessToken("JDGiiM9PuWT63FIwGjG9eYlGi-aZMq6CQ2IB475JUxs");
req.setScopes({ "history.read" });
api.tokenUpdate(req);
'
- lang: python
source: 'conf = ...
api = AuthleteApiImpl(conf)
req = TokenUpdateRequest()
req.accessToken = ''JDGiiM9PuWT63FIwGjG9eYlGi-aZMq6CQ2IB475JUxs''
req.scopes = [ ''history.read'' ]
api.tokenUpdate(req)
'
tags:
- Token Operations
/api/{serviceId}/auth/token/delete/{accessTokenIdentifier}:
delete:
summary: Delete Access Token
description: 'Delete an access token.
'
parameters:
- in: path
name: serviceId
description: A service ID.
required: true
schema:
type: string
- in: path
name: accessTokenIdentifier
schema:
type: string
required: true
description: 'The identifier of an existing access token. The identifier is the value of the access token
or the value of the hash of the access token.
'
responses:
'204':
description: 'The access token was successfully deleted.
'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'500':
$ref: '#/components/responses/500'
operationId: auth_token_delete_api
x-code-samples:
- lang: shell
label: curl
source: 'curl -v -X DELETE https://us.authlete.com/api/21653835348762/auth/token/delete/Bk1QneTxkoLKw_RRB8ToVL25Plt075RvPK68N9cWWtg \
-H ''Content-Type:application/json'' \
-H ''Authorization: Bearer V5a40R6dWvw2gMkCOBFdZcM95q4HC0Z-T0YKD9-nR6F''
'
- lang: java
label: java
source: 'AuthleteConfiguration conf = ...;
AuthleteApi api = AuthleteApiFactory.create(conf);
String accessTokenIdentifier = "Bk1QneTxkoLKw_RRB8ToVL25Plt075RvPK68N9cWWtg";
api.tokenDelete(accessToken);
'
- lang: python
source: 'conf = ...
api = AuthleteApiImpl(conf)
accessTokenIdentifier = ''Bk1QneTxkoLKw_RRB8ToVL25Plt075RvPK68N9cWWtg''
api.tokenDelete(accessToken)
'
tags:
- Token Operations
/api/{serviceId}/auth/token/revoke:
post:
summary: Revoke Access Token
description: 'Revoke an access token.
'
parameters:
- in: path
name: serviceId
description: A service ID.
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/token_revoke_request'
example:
accessTokenIdentifier: Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/token_revoke_request'
responses:
'200':
description: Token revoked successfully
content:
application/json:
schema:
$ref: '#/components/schemas/token_revoke_response'
example:
resultCode: A312001
resultMessage: Revoked 1 access token(s).
count: 1
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
operationId: auth_token_revoke_api
x-code-samples:
- lang: shell
label: curl
source: 'curl -v -X POST https://us.authlete.com/api/21653835348762/auth/token/revoke \
-H ''Content-Type:application/json'' \
-H ''Authorization: Bearer V5a40R6dWvw2gMkCOBFdZcM95q4HC0Z-T0YKD9-nR6F'' \
-d ''{ "accessTokenIdentifier": "Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q" }''
'
- lang: java
label: java
source: 'AuthleteConfiguration conf = ...;
AuthleteApi api = AuthleteApiFactory.create(conf);
TokenRevokeRequest req = new TokenRevokeRequest();
req.setAccessTokenIdentifier("Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q");
api.tokenRevoke(req);
'
- lang: python
source: 'conf = ...
api = AuthleteApiImpl(conf)
req = TokenRevokeRequest()
req.access_token_identifier = ''Z5a40U6dWvw2gMoCOAFbZcM85q4HC0Z--0YKD9-Nf6Q''
api.token_revoke(req)
'
tags:
- Token Operations
components:
schemas:
token_revoke_response:
type: object
properties:
resultCode:
type: string
description: The code which represents the result of the API call.
resultMessage:
type: string
description: A short message which explains the result of the API call.
count:
type: integer
description: The number of tokens revoked
grant_type:
type: string
description: 'The grant type of the access token when the access token was created.
'
enum:
- AUTHORIZATION_CODE
- IMPLICIT
- PASSWORD
- CLIENT_CREDENTIALS
- REFRESH_TOKEN
- CIBA
- DEVICE_CODE
- TOKEN_EXCHANGE
- JWT_BEARER
- PRE_AUTHORIZED_CODE
client_limited:
type: object
properties:
number:
type: integer
format: int32
readOnly: true
description: 'The sequential number of the client. The value of this property is assigned by Authlete.
'
clientName:
type: string
description: 'The name of the client application. This property corresponds to `client_name` in
[OpenID Connect Dynamic Client Registration 1.0, 2. Client Metadata](https://openid.net/specs/openid-connect-registration-1_0.html#ClientMetadata).
'
clientNames:
type: array
items:
$ref: '#/components/schemas/tagged_value'
description: 'Client names with language tags. If the client application has different names for different
languages, this property can be used to register the names.
'
description:
type: string
description: The description about the client application.
descriptions:
type: array
items:
$ref: '#/components/schemas/tagged_value'
description: 'Descriptions about the client application with language tags. If the client application has different
descriptions for different languages, this property can be used to register the descriptions.
'
clientId:
type: integer
format: int64
readOnly: true
description: The client identifier used in Authlete API calls. The value of this property is assigned by Authlete.
clientIdAlias:
type: string
description: 'The value of the client''s `client_id` property used in OAuth and OpenID Connect calls. By
default, this is a string version of the `clientId` property.
'
clientIdAliasEnabled:
type: boolean
description: Deprecated. Always set to `true`.
clientType:
$ref: '#/components/schemas/client_type'
tagged_value:
type: object
properties:
tag:
type: string
description: The language tag part.
value:
type: string
description: The value part.
token_update_response:
type: object
properties:
resultCode:
type: string
description: The code which represents the result of the API call.
resultMessage:
type: string
description: A short message which explains the result of the API call.
action:
type: string
enum:
- INTERNAL_SERVER_ERROR
- BAD_REQUEST
- FORBIDDEN
- NOT_FOUND
- OK
description: The next action that the authorization server implementation should take.
accessToken:
type: string
description: The access token which has been specified by the request.
accessTokenExpiresAt:
type: integer
format: int64
description: 'The date at which the access token will expire.
'
properties:
type: array
items:
$ref: '#/components/schemas/property'
description: 'The extra properties associated with the access token.
'
scopes:
type: array
items:
type: string
description: 'The scopes associated with the access token.
'
authorizationDetails:
$ref: '#/components/schemas/authz_details'
tokenType:
type: string
description: 'The token type associated with the access token.
'
forExternalAttachment:
type: boolean
description: 'the flag which indicates whether the access token is for an external
attachment.
'
tokenId:
type: string
description: 'Set the unique token identifier.
'
refreshTokenExpiresAt:
type: integer
format: int64
description: 'The datetime at which the newly issued refresh token will expire.
The value is represented in milliseconds since the Unix epoch (1970-01-01).
'
property:
type: object
properties:
key:
type: string
description: The key part.
value:
type: string
description: The value part.
hidden:
type: boolean
description: 'The flag to indicate whether this property hidden from or visible to client applications.
If `true`, this property is hidden from client applications. Otherwise, this property is visible to client applications.
'
access_token:
type: object
properties:
accessTokenHash:
type: string
description: The hash of the access token.
accessTokenExpiresAt:
type: integer
format: int64
description: The timestamp at which the access token will expire.
refreshTokenHash:
type: string
description: The hash of the refresh token.
refreshTokenExpiresAt:
type: integer
format: int64
description: The timestamp at which the refresh token will expire.
createdAt:
type: integer
format: int64
description: 'The timestamp at which the access token was first created.
'
lastRefreshedAt:
type: integer
format: int64
description: 'The timestamp at which the access token was last refreshed using the refresh token.
'
clientId:
type: integer
format: int64
description: 'The ID of the client associated with the access token.
'
subject:
type: string
description: 'The subject (= unique user ID) associated with the access token.
'
grantType:
$ref: '#/components/schemas/grant_type'
scopes:
type: array
items:
type: string
description: 'The scopes associated with the access token.
'
properties:
type: array
items:
$ref: '#/components/schemas/property'
description: 'The properties associated with the access token.
'
refreshTokenScopes:
type: array
items:
type: string
description: 'The scopes associated with the refresh token.
'
authz_details:
type: object
description: 'The authorization details. This represents the value of the `authorization_details`
request parameter in the preceding device authorization request which is defined in
"OAuth 2.0 Rich Authorization Requests".
'
properties:
elements:
type: array
items:
$ref: '#/components/schemas/authorization_details_element'
description: 'Elements of this authorization details.
'
token_create_request:
type: object
required:
- grantType
properties:
grantType:
$ref: '#/components/schemas/grant_type'
clientId:
type: integer
format: int64
description: 'The ID of the client application which will be associated with a newly created access token.
'
subject:
type: string
description: 'The subject (= unique identifier) of the user who will be associated with a newly created access
token. This parameter is required unless the grant type is `CLIENT_CREDENTIALS`. The value must
consist of only ASCII characters and its length must not exceed 100.
'
scopes:
type: array
items:
type: string
description: 'The scopes which will be associated with a newly created access token. Scopes that are not supported
by the service cannot be specified and requesting them will cause an error.
'
accessTokenDuration:
type: integer
format: int64
description: 'The duration of a newly created access token in seconds. If the value is 0, the duration is determined
according to the settings of the service.
'
refreshTokenDuration:
type: integer
format: int64
description: 'The duration of a newly created refresh token in seconds. If the value is 0, the duration is
determined according to the settings of the service.
A refresh token is not created (1) if the service does not support `REFRESH_TOKEN`, or (2) if the
specified grant type is either `IMPLICIT`or `CLIENT_CREDENTIALS`.
'
properties:
type: array
items:
$ref: '#/components/schemas/property'
description: 'Extra properties to associate with a newly created access token. Note that properties parameter
is accepted only when the HTTP method of the request is POST and Content-Type of the request is
`application/json`, so don''t use `GET` method or `application/x-www-form-urlencoded` if you want
to specify properties.
'
clientIdAliasUsed:
type: boolean
description: 'A boolean request parameter which indicates whether to emulate that the client ID alias is used
instead of the original numeric client ID when a new access token is created.
'
x-mint:
metadata:
description: A boolean request parameter which indicates whether to emulate that the client ID alias is used instead of the original numeric client ID when a new access token is created.
content: '<Accordion title="Full description" defaultOpen={false}>
This has an effect only on the value of the aud claim in a response from [UserInfo endpoint](https://openid.net/specs/openid-connect-core-1_0.html#UserInfo).
When you access the UserInfo endpoint (which is expected to be implemented using Authlete''s
`/api/auth/userinfo` API and `/api/auth/userinfo/issue` API) with an access token which has been
created using Authlete''s `/api/auth/token/create` API with this property (`clientIdAliasUsed`)
`true`, the client ID alias is used as the value of the aud claim in a response from the UserInfo
endpoint.
Note that if a client ID alias is not assigned to the client when Authlete''s `/api/auth/token/create`
API is called, this property (`clientIdAliasUsed`) has no effect (it is always regarded as `false`).
</Accordion>
'
accessToken:
type: string
description: 'The value of the new access token.
'
x-mint:
metadata:
description: The value of the new access token.
content: '<Accordion title="Full description" defaultOpen={false}>
The `/api/auth/token/create` API generates an access token. Therefore, callers of the API do not
have to specify values of newly created access tokens. However, in some cases, for example, if
you want to migrate existing access tokens from an old system to Authlete, you may want to specify
values of access tokens. In such a case, you can specify the value of a newly created access token
by passing a non-null value as the value of accessToken request parameter. The implementation
of the `/api/auth/token/create` uses the value of the accessToken request parameter instead of
generating a new value when the request parameter holds a non-null value.
Note that if the hash value of the specified access token already exists in Authlete''s database,
the access token cannot be inserted and the `/api/auth/token/create` API will report an error.
</Accordion>
'
refreshToken:
type: string
description: 'The value of the new refresh token.
'
x-mint:
metadata:
description: The value of the new refresh token.
content: '<Accordion title="Full description" defaultOpen={false}>
The `/api/auth/token/create` API may generate a refresh token. Therefore, callers of the API do
not have to specify values of newly created refresh tokens. However, in some cases, for example,
if you want to migrate existing refresh tokens from an ol
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/authlete/refs/heads/main/openapi/authlete-token-operations-api-openapi.yml