---
title: "Changes to Create a partner residency application"
method: POST
path: "/api/v1/partner/residency_applications"
---

# Changes to Create a partner residency application

`POST /api/v1/partner/residency_applications`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 12 revisions.

- **2026-10-05** `4e7a4c475288`: 2 breaking, 2 warning
- **2026-09-22** `d2c5a5cda002`: 7 info
- **2026-09-15** `197106eab8bc`: 3 breaking, 5 warning

## Changes

- **2026-10-05** `4e7a4c475288`: 2 breaking, 2 warning
  - added the pattern `^\p{L}(?:[\p{L}\p{M}]|\u200c|\u200d)*(?:(?: +|['\u2019\u02bc\u00b7-]|\. ?)\p{L}(?:[\p{L}\p{M}]|\u200c|\u200d)*)*\.?$` to the request property `applicationData/personalDetails/givenName`
  - added the pattern `^\p{L}(?:[\p{L}\p{M}]|\u200c|\u200d)*(?:(?: +|['\u2019\u02bc\u00b7-]|\. ?)\p{L}(?:[\p{L}\p{M}]|\u200c|\u200d)*)*\.?$` to the request property `applicationData/personalDetails/surname`
  - the `applicationData/personalDetails/givenName` request property's maxLength was set to `100`
  - the `applicationData/personalDetails/surname` request property's maxLength was set to `100`
- **2026-09-22** `d2c5a5cda002`: 7 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `code` to the response with the `429` status
  - added the optional property `code` to the response with the `500` status
- **2026-09-15** `197106eab8bc`: 3 breaking, 5 warning
  - the `header` request parameter `Idempotency-Key` became required
  - for the `header` request parameter `Idempotency-Key`, the minLength was increased from `1` to `8`
  - added the pattern `^[A-Za-z0-9_.~-]+$` to the `header` request parameter `Idempotency-Key`
  - for the `header` request parameter `Idempotency-Key`, the maxLength was set to `128`
  - added the new `Approved` enum value to the `data/statusId` response property for the response status `200`
  - added the new `Draft` enum value to the `data/statusId` response property for the response status `200`
  - added the new `Pending Review` enum value to the `data/statusId` response property for the response status `200`
  - added the new `Rejected` enum value to the `data/statusId` response property for the response status `200`

---

[Operation](https://skmtc.dev/eprospera/apis/e-pro-spera-api/docs/api/v1/partner/residency_applications/post.md) - [API](https://skmtc.dev/eprospera/apis/e-pro-spera-api.md) - [Page](https://skmtc.dev/eprospera/apis/e-pro-spera-api/changes/api/v1/partner/residency_applications/post)