---
title: "Changes to Enroll an identity via one-time-token"
method: POST
path: "/enroll"
---

# Changes to Enroll an identity via one-time-token

`POST /enroll`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 11 revisions.

- **2026-10-14** `f7b51eaafbbb`: 1 breaking, 3 warning, 1 info
- **2025-11-04** `e8b8c6cc7e72`: 2 info
- **2025-03-17** `058711718149`: 5 breaking, 4 info
- **2025-01-24** `19dfd92f02a2`: 1 info
- **2024-06-07** `26670d8bbc37`: 6 breaking
- **2024-05-29** `cce2800c1357`: 1 breaking, 6 warning, 9 info

## Changes

- **2026-10-14** `f7b51eaafbbb`: 1 breaking, 3 warning, 1 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/ca` from the response with the `200` status
  - removed the optional property `data/cert` from the response with the `200` status
  - removed the optional property `data/serverCert` from the response with the `200` status
  - added `#/components/schemas/enrollmentResponse, subschema #2` to the `data` response property `allOf` list for the response status `200`
- **2025-11-04** `e8b8c6cc7e72`: 2 info
  - added the non-success response with the status `409`
  - added the non-success response with the status `410`
- **2025-03-17** `058711718149`: 5 breaking, 4 info
  - the response's body type changed from `string` to `object` for status `200`
  - removed the media type `application/x-pem-file` for the response with the status `200`
  - removed the media type `application/x-pem-file` for the response with the status `404`
  - removed the media type `application/x-pem-file` for the response with the status `429`
  - removed the media type `application/x-pem-file` for the response with the status `503`
  - added optional request body
  - added the non-success response with the status `400`
  - added the optional property `data` to the response with the `200` status
  - added the optional property `meta` to the response with the `200` status
- **2025-01-24** `19dfd92f02a2`: 1 info
  - added the non-success response with the status `503`
- **2024-06-07** `26670d8bbc37`: 6 breaking
  - the response's body type changed from `object` to `string` for status `200` (media type: application/x-pem-file)
  - the response's body type changed from `object` to `string` for status `200` (media type: application/json)
  - removed the required property `data` from the response with the `200` status (media type: application/x-pem-file)
  - removed the required property `data` from the response with the `200` status (media type: application/json)
  - removed the required property `meta` from the response with the `200` status (media type: application/x-pem-file)
  - removed the required property `meta` from the response with the `200` status (media type: application/json)
- **2024-05-29** `cce2800c1357`: 1 breaking, 6 warning, 9 info
  - removed the request body
  - the optional response header `WWW-Authenticate` removed for the status `200`
  - the optional response header `WWW-Authenticate` removed for the status `404`
  - the optional response header `WWW-Authenticate` removed for the status `429`
  - removed the optional property `data/ca` from the response with the `200` status
  - removed the optional property `data/cert` from the response with the `200` status
  - removed the optional property `data/serverCert` from the response with the `200` status
  - added the media type `application/x-pem-file` for the response with the status `200`
  - added the media type `application/x-pem-file` for the response with the status `404`
  - added the media type `application/x-pem-file` for the response with the status `429`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `409`
  - removed the non-success response with the status `410`
  - removed the non-success response with the status `503`
  - the response property `data` became required for the status `200`
  - the response property `meta` became required for the status `200`

---

[Operation](https://skmtc.dev/openziti/apis/ziti-edge-client/docs/enroll/post.md) - [API](https://skmtc.dev/openziti/apis/ziti-edge-client.md) - [Page](https://skmtc.dev/openziti/apis/ziti-edge-client/changes/enroll/post)