---
title: "Changes to Start the authorisation process for a consent"
method: POST
path: "/v1/consents/{consentId}/authorisations"
---

# Changes to Start the authorisation process for a consent

`POST /v1/consents/{consentId}/authorisations`

> Every recorded change to this endpoint, newest first.
> 50 revisions in range; 1 not diffed.

## Timeline

Changed in 4 of 50 revisions.

- **2021-02-19** `0d82c4699548` — 3 breaking, 5 warning, 17 info
- **2021-02-10** `b51fe6ddb1fc` — 28 breaking, 17 warning, 10 info
- **2021-02-10** `3cc5b6a584f1` — 3 breaking, 5 warning, 17 info
- **2021-02-10** `f324b23056bf` — 2 breaking

## Changes

- **2021-02-19** `0d82c4699548` — 3 breaking, 5 warning, 17 info
  - removed the enum value `false` from the `header` request parameter `TPP-Redirect-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Redirect-Preferred`
  - for the `header` request parameter `TPP-Redirect-Preferred`, the type changed from `string` to `boolean`
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the new `SMTP_OTP` enum value to the `scaMethods/items/authenticationType` response property for the response status `201`
  - added the new `unconfirmed` enum value to the `scaStatus` response property for the response status `201`
  - added the optional property `_links/confirmation` to the response with the `201` status
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/problem+json)
- **2021-02-10** `b51fe6ddb1fc` — 28 breaking, 17 warning, 10 info
  - the `TPP-Redirect-Preferred` request header's property undefined was restricted to a list of enum values
  - the `header` request parameter `TPP-Redirect-Preferred` was restricted to a list of enum values
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `psuMessage` response property's maxLength was increased from `500` to `512` for the response status `201`
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/json)
  - the `challengeData/imageLink` response's property format changed from `url` to no format for status `201`
  - removed the optional property `_links/confirmation` from the response with the `201` status
  - removed the optional property `_links/confirmation` from the response with the `400` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `400` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `401` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `401` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `403` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `403` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `404` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `404` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `405` status (media type: application/json)
  - removed the optional property `_links/confirmation` from the response with the `405` status (media type: application/problem+json)
  - removed the optional property `_links/confirmation` from the response with the `406` status (media type: application/json)
  - …15 more
- **2021-02-10** `3cc5b6a584f1` — 3 breaking, 5 warning, 17 info
  - removed the enum value `false` from the `header` request parameter `TPP-Redirect-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Redirect-Preferred`
  - for the `header` request parameter `TPP-Redirect-Preferred`, the type changed from `string` to `boolean`
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the new `SMTP_OTP` enum value to the `scaMethods/items/authenticationType` response property for the response status `201`
  - added the new `unconfirmed` enum value to the `scaStatus` response property for the response status `201`
  - added the optional property `_links/confirmation` to the response with the `201` status
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/problem+json)
- **2021-02-10** `f324b23056bf` — 2 breaking
  - for the `header` request parameter `PSU-Device-ID`, the format changed from no format to `uuid`
  - for the `header` request parameter `X-Request-ID`, the format changed from no format to `uuid`

---

[Operation](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/docs/v1/consents/:consentId/authorisations/post.md) · [API](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework.md) · [Page](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/changes/v1/consents/:consentId/authorisations/post)