Sign in

v1

latestOpenAPI 3.0.3Lucid2026-07-14155181312.3 KB
OAuth 2.0 Tokens

Create or Refresh Access Token

post/v1/oauth2/token

Request body

OR

Response

OK application/json with the access token and refresh token (if the offline_access scope was included for creating access token).

access_tokenstring required

Token to be used when making requests with OAuth 2.0 authentication.

client_idstring required

The client ID.

expires_innumber required

The lifetime in seconds of the access token.

expiresnumber required

Time until this token expires (expressed in milliseconds since Unix epoch).

refresh_tokenstring

If the token includes the scope offline_access, then a refresh token will be provided.

scopesstring[] required

Scopes granted on this token.

token_typestring required

Value is always "bearer".

user_idnumber required

ID of the user this token is on behalf of. Only returned when the token was granted on behalf of a user. Mutually exclusive with account_id.

account_idnumber required

ID of the account this token is on behalf of. Only returned when the token was granted on behalf of an account. Mutually exclusive with user_id.

Example response

{
  "access_token": "oauth2-Yzh4Y2Q3ZTVhY2FjYjkwOGJlZGNjNjU5NDM2NjgzZmUwMmNmMjkzM...",
  "client_id": "30VYbvlkqZv-SmJd7fTdpH9B9et2yqZA6Wvi5NY_",
  "expires_in": 3600,
  "expires": 1605732868411,
  "refresh_token": "oauth2-AVU=-yPcwtzLkusIEnT7D9slQH4g8Ur0MdpUmpT0Z6BSMf6lmesRpTTSBGNniKd",
  "scopes": [
    "lucidchart.document.app",
    "offline_access"
  ],
  "token_type": "bearer",
  "user_id": 341,
  "account_id": 52
}
All 155 operations