Request a new token
Request a new token granting access to the MK.IO API. There are four types of tokens.
- 'restricted' tokens can have an
expireDateset to up to a year in the future grant a reduced set of capabilities. Please see our online documentation for a description of how the capabilities are defined. - 'login' tokens are short-lived and grant the full user capabilities.
- 'full-access' tokens can have an
expireDateset to up to a year in the future and grant the full user capabilities. - 'ephemeral' tokens are short-lived and grant a reduced set of capabilities, similar to 'restricted' tokens.
Where possible you should prefer 'restricted' tokens over 'full-access' tokens to reduce the impact if one is exposed accidentally.
An API token allows access to MK.IO to anyone who has a copy of it - you should treat these like your car keys and keep them safe.
Requires authentication; no additional RBAC permissions required.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
Loading schema details…
Response
201Created
Loading schema details…
Errors
400Bad Request
Loading schema details…
401Unauthorized
Loading schema details…
403Forbidden
Loading schema details…
404Not Found
Loading schema details…
429Too Many Requests
Loading schema details…
500Internal Server Error
Loading schema details…