Auth

Issue a new access token

Issue a new access token

post/api/v1/oauth2/token

Request body

OR
OR
OR

Example request

{
  "client_id": "547544c3-eeac-492e-8df9-5a52ca4e6bdf",
  "client_secret": "b717adcac3f26e8034574021fa647cd7d4edd67b615046df387f6712c3601048"
}

Response

Success

successboolean required

Indicates if the request was successful

Example response

{
  "success": true,
  "data": {
    "access_token": "example_access_token_xyz789",
    "refresh_token": "example_refresh_token_abc123",
    "token_type": "Bearer",
    "expires_in": 900
  }
}

Changes

Changed in 3 of the 8 revisions of this API.735

  • b372e7d5563d634See the full diff
    • added subschema #1: Unauthorized Error subschema #2 to the response body oneOf list for the response status 401

      response-body-one-of-added

    • the response's body type/format changed from object/ to / for status 401

      response-body-type-changed

    • the response property data/refresh_token became optional for the status 200

      response-property-became-optional

    • the error/code response's property type/format changed from string/ to / for status 400

      response-property-type-changed

    • removed the required property error from the response with the 401 status

      response-required-property-removed

    • removed the required property success from the response with the 401 status

      response-required-property-removed

    • removed the request property client_id

      request-property-removed

    • removed the request property client_secret

      request-property-removed

    • removed the optional property error/errors from the response with the 400 status

      response-optional-property-removed

    • added request discriminator

      request-body-discriminator-added

    • added subschema #1 subschema #2 subschema #3 subschema #4 to the request body oneOf list

      request-body-one-of-added

    • added the optional property error/metadata to the response with the 400 status

      response-optional-property-added

    • added subschema #1 subschema #2 to the error/code response property allOf list for the response status 400

      response-property-all-of-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • endpoint added

      endpoint-added

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 367 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog