---
title: "Changes to Create a new subscription"
method: POST
path: "/api/v1/new-subscription"
---

# Changes to Create a new subscription

`POST /api/v1/new-subscription`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 33 revisions.

- **2026-08-06** `9112415ceeca` — 8 info
- **2026-04-23** `16b3a54841ce` — 2 info
- **2026-04-15** `b1e5c0b1fe19` — 2 info
- **2026-04-10** `cf6b85982e17` — 3 info
- **2026-04-06** `32fce875199e` — 2 warning, 2 info
- **2026-03-30** `b624ef0376c5` — 2 info
- **2026-03-23** `1428a3203bfb` — 1 breaking, 1 warning, 1 info
- **2026-03-18** `4e69495b0c8e` — 1 info
- **2026-02-02** `232174554498` — 1 breaking

## Changes

- **2026-08-06** `9112415ceeca` — 8 info
  - added the optional property `authPolicy/conditionType` to the response with the `201` status
  - added the optional property `authPolicy/lastTransitionTime` to the response with the `201` status
  - added the optional property `authPolicy/reason` to the response with the `201` status
  - added the optional property `authPolicy/status` to the response with the `201` status
  - added the optional property `subscription/conditionType` to the response with the `201` status
  - added the optional property `subscription/lastTransitionTime` to the response with the `201` status
  - added the optional property `subscription/reason` to the response with the `201` status
  - added the optional property `subscription/status` to the response with the `201` status
- **2026-04-23** `16b3a54841ce` — 2 info
  - added the optional property `authPolicy/deletionTimestamp` to the response with the `201` status
  - added the optional property `subscription/deletionTimestamp` to the response with the `201` status
- **2026-04-15** `b1e5c0b1fe19` — 2 info
  - added the optional property `authPolicy/statusMessage` to the response with the `201` status
  - added the optional property `subscription/statusMessage` to the response with the `201` status
- **2026-04-10** `cf6b85982e17` — 3 info
  - added the optional property `authPolicy/creationTimestamp` to the response with the `201` status
  - added the optional property `authPolicy/description` to the response with the `201` status
  - added the optional property `authPolicy/displayName` to the response with the `201` status
- **2026-04-06** `32fce875199e` — 2 warning, 2 info
  - removed the request property `modelRefs/items/tokenRateLimitRef`
  - removed the optional property `subscription/modelRefs/items/tokenRateLimitRef` from the response with the `201` status
  - added the new optional request property `description`
  - added the new optional request property `displayName`
- **2026-03-30** `b624ef0376c5` — 2 info
  - added the optional property `subscription/description` to the response with the `201` status
  - added the optional property `subscription/displayName` to the response with the `201` status
- **2026-03-23** `1428a3203bfb` — 1 breaking, 1 warning, 1 info
  - the response property `authPolicy` became optional for the status `201`
  - removed the request property `namespace`
  - added the new optional request property `createAuthPolicy`
- **2026-03-18** `4e69495b0c8e` — 1 info
  - endpoint added
- **2026-02-02** `232174554498` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/opendatahub-io/apis/maas-bff-api/docs/api/v1/new-subscription/post.md) · [API](https://skmtc.dev/opendatahub-io/apis/maas-bff-api.md) · [Page](https://skmtc.dev/opendatahub-io/apis/maas-bff-api/changes/api/v1/new-subscription/post)