Skip to content
Mindtickle Developer DocsBeta

Try searching for

↑↓ to navigate↵ to openesc to close
Dark mode

Get an authorization code

Returns a temporary authorization code that you exchange for a Call AI access token.

View as Markdown(opens in a new tab)
Use with AI

Open this page in

ChatGPT(opens in a new tab)Claude(opens in a new tab)Cursor(opens in a new tab)

Prerequisites

  1. Authentication: Client credentials, tenant details, and the authentication base URL from Mindtickle Support.

Endpoint

Section titled “Endpoint”
POST /get-authorisation-grant

Base URL: the authentication base URL Mindtickle Support provides for issuing tokens.

Headers: Content-Type: application/json.

Request

Section titled “Request”
Parameter Type Required Description
client_id string Not specified Your unique client identifier.
user_id string Not specified The user authorized to make requests.
tenant_id string Not specified Your tenant identifier.

Request example

Section titled “Request example”
{
  "client_id": "CLIENT_ID",
  "user_id": "USER_ID",
  "tenant_id": "TENANT_ID"
}

Response

Section titled “Response”
Field Type Description
status number Status code in the response body. Check the HTTP status separately.
grant_type string The grant type of the code returned, authorization_code.
code string The authorization code to exchange for an access token.

Response example

Section titled “Response example”
{
  "status": 200,
  "grant_type": "authorization_code",
  "code": "AUTHORIZATION_CODE"
}

Notes

Section titled “Notes”
  • Limits: The code in the response expires in 10 minutes. Use it immediately to generate an access token.
  • Behavior: Run this request once per client during initial setup. If the refresh token expires, restart this step as described in Refresh an access token.