---
title: "Changes to POST /api/deployments/"
method: POST
path: "/api/deployments/"
---

# Changes to POST /api/deployments/

`POST /api/deployments/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 19 revisions.

- **2026-11-04** `b5614ae64ccc`: 9 info
- **2026-09-11** `c22670fef01b`: 2 info
- **2026-09-01** `941ab9eb01d6`: 20 breaking, 2 warning, 18 info

## Changes

- **2026-11-04** `b5614ae64ccc`: 9 info
  - added the new optional request property `extensions/items/hostPermissions` (media type: application/json)
  - added the new optional request property `extensions/items/hostPermissions` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `extensions/items/hostPermissions` (media type: multipart/form-data)
  - added the new optional request property `extensions/items/permissionWarnings` (media type: application/json)
  - added the new optional request property `extensions/items/permissionWarnings` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `extensions/items/permissionWarnings` (media type: multipart/form-data)
  - added the new optional request property `extensions/items/permissions` (media type: application/json)
  - added the new optional request property `extensions/items/permissions` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `extensions/items/permissions` (media type: multipart/form-data)
- **2026-09-11** `c22670fef01b`: 2 info
  - the response property `bindings/items/auth/label` became required for the status `201` (media type: application/json; version=1.1)
  - the response property `bindings/items/auth/label` became required for the status `201` (media type: application/vnd.pixiebrix.api+json; version=1.1)
- **2026-09-01** `941ab9eb01d6`: 20 breaking, 2 warning, 18 info
  - added the new required request property `active/items/blueprint` (media type: application/json)
  - added the new required request property `active/items/blueprint` (media type: application/x-www-form-urlencoded)
  - added the new required request property `active/items/blueprint` (media type: multipart/form-data)
  - added the new required request property `active/items/blueprintVersion` (media type: application/json)
  - added the new required request property `active/items/blueprintVersion` (media type: application/x-www-form-urlencoded)
  - added the new required request property `active/items/blueprintVersion` (media type: multipart/form-data)
  - added the new required request property `active/items/deployment` (media type: application/json)
  - added the new required request property `active/items/deployment` (media type: application/x-www-form-urlencoded)
  - added the new required request property `active/items/deployment` (media type: multipart/form-data)
  - added the pattern `^(?<major>[0-9]+)\.(?<minor>[0-9]+)\.(?<patch>[0-9]+)(-.*)?$` to the request property `version` (media type: application/json)
  - added the pattern `^(?<major>[0-9]+)\.(?<minor>[0-9]+)\.(?<patch>[0-9]+)(-.*)?$` to the request property `version` (media type: application/x-www-form-urlencoded)
  - added the pattern `^(?<major>[0-9]+)\.(?<minor>[0-9]+)\.(?<patch>[0-9]+)(-.*)?$` to the request property `version` (media type: multipart/form-data)
  - the response property `bindings/items/auth` became nullable for the status `201` (media type: application/json; version=1.1)
  - the response property `bindings/items/auth` became nullable for the status `201` (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - the response property `services/items/auth` became nullable for the status `201` (media type: application/json; version=1.1)
  - the response property `services/items/auth` became nullable for the status `201` (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - the response property `services/items/auth` became optional for the status `201` (media type: application/json; version=1.1)
  - the response property `services/items/auth` became optional for the status `201` (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - removed the required property `package/updated_by` from the response with the `201` status (media type: application/json; version=1.1)
  - removed the required property `package/updated_by` from the response with the `201` status (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - removed the optional property `package/message` from the response with the `201` status (media type: application/json; version=1.1)
  - removed the optional property `package/message` from the response with the `201` status (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - api operation id `telemetryListUserDeploymentDetail` removed and replaced with `telemetryListUserHeartbeat`
  - added the new optional `query` request parameter `platforms`
  - added the new optional request property `active/items/updatedAt` (media type: application/json)
  - added the new optional request property `active/items/updatedAt` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `active/items/updatedAt` (media type: multipart/form-data)
  - added the new optional request property `extensions` (media type: application/json)
  - added the new optional request property `extensions` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `extensions` (media type: multipart/form-data)
  - media type `application/json; version=2.0` was changed to `application/json; version=1.1` for the response status `201`
  - media type `application/vnd.pixiebrix.api+json; version=2.0` was changed to `application/vnd.pixiebrix.api+json; version=1.1` for the response status `201`
  - added the optional property `bindings/items/binding_type` to the response with the `201` status (media type: application/json; version=1.1)
  - added the optional property `bindings/items/binding_type` to the response with the `201` status (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - added the optional property `services/items/key` to the response with the `201` status (media type: application/json; version=1.1)
  - added the optional property `services/items/key` to the response with the `201` status (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - added the optional write-only property `user` to the response with the `201` status (media type: application/json; version=1.1)
  - added the optional write-only property `user` to the response with the `201` status (media type: application/vnd.pixiebrix.api+json; version=1.1)
  - the response write-only property `platform_names` became optional for the status `201` (media type: application/json; version=1.1)
  - the response write-only property `platform_names` became optional for the status `201` (media type: application/vnd.pixiebrix.api+json; version=1.1)

---

[Operation](https://skmtc.dev/pixiebrix/apis/pixiebrix-api/docs/api/deployments/post.md) - [API](https://skmtc.dev/pixiebrix/apis/pixiebrix-api.md) - [Page](https://skmtc.dev/pixiebrix/apis/pixiebrix-api/changes/api/deployments/post)
