---
title: "Changes to Exchange an authorization code for a session"
method: POST
path: "/auth/identity/token"
---

# Changes to Exchange an authorization code for a session

`POST /auth/identity/token`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 30 revisions.

- **2026-10-28** `a9a10e328ba5`: 16 info
- **2026-10-28** `56d7c265a77a`: 4 breaking
- **2026-10-28** `fecd5111028e`: 1 info
- **2026-10-27** `6f5f69de6706`: 1 info
- **2026-10-22** `f5ac9c809ef7`: 2 info
- **2026-10-21** `9f5e902abd83`: 1 info
- **2026-10-16** `53a9c3693f70`: 5 info

## Changes

- **2026-10-28** `a9a10e328ba5`: 16 info
  - the response property `error/details` became required for the status `400`
  - the response property `error/details` became required for the status `401`
  - the response property `error/details` became required for the status `403`
  - the response property `error/details` became required for the status `503`
  - the response property `meta` became required for the status `400`
  - the response property `meta` became required for the status `401`
  - the response property `meta` became required for the status `403`
  - the response property `meta` became required for the status `503`
  - the response property `meta/api_version` became required for the status `400`
  - the response property `meta/api_version` became required for the status `401`
  - the response property `meta/api_version` became required for the status `403`
  - the response property `meta/api_version` became required for the status `503`
  - added the required property `meta/request_id` to the response with the `400` status
  - added the required property `meta/request_id` to the response with the `401` status
  - added the required property `meta/request_id` to the response with the `403` status
  - added the required property `meta/request_id` to the response with the `503` status
- **2026-10-28** `56d7c265a77a`: 4 breaking
  - the response property `error/details` became nullable for the status `400`
  - the response property `error/details` became nullable for the status `401`
  - the response property `error/details` became nullable for the status `403`
  - the response property `error/details` became nullable for the status `503`
- **2026-10-28** `fecd5111028e`: 1 info
  - added the new optional request property `expected_subject`
- **2026-10-27** `6f5f69de6706`: 1 info
  - added the required property `data/account/oneOf[#/components/schemas/Account]/email_file_names` to the response with the `200` status
- **2026-10-22** `f5ac9c809ef7`: 2 info
  - the response property `data/account/oneOf[#/components/schemas/Account]/organization_handle` became required for the status `200`
  - added the required property `data/account/oneOf[#/components/schemas/Account]/time_zone` to the response with the `200` status
- **2026-10-21** `9f5e902abd83`: 1 info
  - added the optional property `data/account/oneOf[#/components/schemas/Account]/organization_handle` to the response with the `200` status
- **2026-10-16** `53a9c3693f70`: 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `503`
  - added the success response with the status `200`

---

[Operation](https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/auth/identity/token/post.md) - [API](https://skmtc.dev/sparkvault/apis/sparkvault-api.md) - [Page](https://skmtc.dev/sparkvault/apis/sparkvault-api/changes/auth/identity/token/post)