Security

Create API Auth Token

Returns an API access token specific to the Management API. This token must then be used as an authorization header for all requests to protected endpoints (this is required for the majority of operations).

Request

Request Body schema: application/json

client_id required	string Use the `client_id` value provided for authenticating with the Management API authentication provider as part of your on-boarding.
client_secret required	string Use the `client_secret` value provided for authenticating with the Management API authentication provider as part of your on-boarding.
audience required	string Use the `audience` value provided as part of your on-boarding for the Management API.
grant_type required	string Use `client_credentials`.

Responses

200

Successful response

401

Unauthorized

post/oauth/token

Request samples

application/json

{"client_id": "htf792W4p4MedZbnoWAs51EfqUt4d2",
"client_secret": "d3fYDX7FjPg1D1h2viARXsolPByQ9vMfg8LHylBy8F4s5KJLB4HhHGOxxqJnSj3G",
"audience": "https://my-tenant.vii.mattr.global",
"grant_type": "client_credentials"
}

Response samples

application/json

{"access_token": "s2dgbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6s2dcaEROemRDf5gbRVEwTTVSVFE0TmtZME9UZzVNVEpDTlVJNFJqRTBPREExTmpZMk1qazFPQSJ9",
"expires_in": 86400,
"token_type": "Bearer"
}