Token specification update! (November 6, 2023)

We’re continuing our efforts to improve our documentation based on your feedback! The Akoya token specification and documentation have been updated with several improvements and clarifications.


  • Combined the Obtain, Refresh, and Revoke endpoints into one OpenAPI specification

  • Updated the token endpoint specification to show two schemas: one for obtaining new tokens in the authorization flow, and the other for token refresh. Before, these were documented as separate paths with a workaround in the OpenAPI specification. The workaround caused unintended confusion. This is now resolved.

Please take a look at the refined Token documentation.


Please note!

Use the correct schema for your token request. The obtain (authorize) token request and the refresh token request require different security schemas and parameters.

If you have any questions regarding this Token documentation update or have any feedback, please let us know in the developer community.