v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Authorization

Refresh access token

Refresh an Access Token using its client ID, secret, and refresh token.

post/oauth2/token#refresh

Response

Returns a new Access Token that can be used to make authenticated API calls by passing along the token in a authorization header as follows Authorization: Bearer <Token>.

access_tokenstring token

The requested access token.

expires_ininteger

The time in seconds by which this token will expire.

token_type'bearer'

The type of access token returned.

refresh_tokenstring token

The refresh token for this access token, which can be used to request a new access token when the current one expires.

issued_token_type'urn:ietf:params:oauth:token-type:access_token' urn

The type of downscoped access token returned. This is only returned if an access token has been downscoped.

Example response

{
  "access_token": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ",
  "expires_in": 3600,
  "token_type": "bearer",
  "restricted_to": [
    {
      "scope": "item_download",
      "object": {
        "id": "12345",
        "etag": "1",
        "type": "folder",
        "sequence_id": "3",
        "name": "Contracts"
      }
    }
  ],
  "refresh_token": "c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ",
  "issued_token_type": "urn:ietf:params:oauth:token-type:access_token"
}