Skip to content
PhyStack

PhyStack API (2026-03)

Every consumer-affecting change to the PhyStack API version 2026-03, newest first. Entries are generated automatically from the OpenAPI specification when a change reaches production.

The 2026-03 API is additive-only: existing endpoints, fields, and types are never removed or changed within this version. Everything listed here is backward-compatible — new endpoints, new optional parameters, new response fields, or documentation improvements.

September 3, 2026

Section titled “September 3, 2026”

GET /invoices

Section titled “GET /invoices”
  • added the new optional query request parameter includeChildren
  • added the required property items to the response with the 200 status
  • added the required property total to the response with the 200 status

GET /tenants/{tenantId}/consumption

Section titled “GET /tenants/{tenantId}/consumption”
  • endpoint added

GET /tenants/{tenantId}/consumption/summary

Section titled “GET /tenants/{tenantId}/consumption/summary”
  • endpoint added

POST /web-endpoints/{endpointId}/code

Section titled “POST /web-endpoints/{endpointId}/code”
  • endpoint added

August 21, 2026

Section titled “August 21, 2026”

GET /apps

Section titled “GET /apps”
  • added the new optional query request parameter filter[type]

GET /installations/{installationId}/devices/{deviceId}/settings

Section titled “GET /installations/{installationId}/devices/{deviceId}/settings”
  • the response property data/version became not nullable for the status 200
  • the response property data/version became required for the status 200

PUT /installations/{installationId}/devices/{deviceId}/settings

Section titled “PUT /installations/{installationId}/devices/{deviceId}/settings”
  • the response property data/version became not nullable for the status 200
  • the response property data/version became required for the status 200

GET /installations/{installationId}/spaces/{spaceId}/settings

Section titled “GET /installations/{installationId}/spaces/{spaceId}/settings”
  • the response property data/version became not nullable for the status 200
  • the response property data/version became required for the status 200

PUT /installations/{installationId}/spaces/{spaceId}/settings

Section titled “PUT /installations/{installationId}/spaces/{spaceId}/settings”
  • the response property data/version became not nullable for the status 200
  • the response property data/version became required for the status 200

GET /peripherals

Section titled “GET /peripherals”
  • added the new optional query request parameter search

GET /tenants

Section titled “GET /tenants”
  • added the new optional query request parameter filter[country]
  • added the new optional query request parameter filter[parentTenantId]

GET /tenants/{id}/subscription

Section titled “GET /tenants/{id}/subscription”
  • added the optional property subscription/oneOf[#/components/schemas/SubscriptionDetails]/card to the response with the 200 status

GET /web-endpoints

Section titled “GET /web-endpoints”
  • endpoint added

POST /web-endpoints

Section titled “POST /web-endpoints”
  • endpoint added

DELETE /web-endpoints/{endpointId}

Section titled “DELETE /web-endpoints/{endpointId}”
  • endpoint added

GET /web-endpoints/{endpointId}

Section titled “GET /web-endpoints/{endpointId}”
  • endpoint added

PUT /web-endpoints/{endpointId}

Section titled “PUT /web-endpoints/{endpointId}”
  • endpoint added

August 1, 2026

Section titled “August 1, 2026”

GET /peripherals

Section titled “GET /peripherals”
  • :warning: removed the required property data/items/settings from the response with the 200 status
  • :warning: removed the required property data/items/telemetry from the response with the 200 status
  • added the optional property data/items/hardwareStatus to the response with the 200 status
  • removed the optional property data/items/createdAt from the response with the 200 status
  • removed the optional property data/items/hardwareId from the response with the 200 status
  • removed the optional property data/items/tenantId from the response with the 200 status
  • removed the optional property data/items/updatedAt from the response with the 200 status
  • the response property data/items/deviceId became not nullable for the status 200
  • the response property data/items/name became not nullable for the status 200
  • the response property data/items/status became not nullable for the status 200
  • the response property data/items/deviceId became required for the status 200
  • the response property data/items/name became required for the status 200
  • the response property data/items/status became required for the status 200
  • added the required property data/items/deviceDisplayName to the response with the 200 status

DELETE /peripherals/{id}

Section titled “DELETE /peripherals/{id}”
  • endpoint added

GET /peripherals/{id}

Section titled “GET /peripherals/{id}”
  • the response property data/createdAt became not nullable for the status 200
  • the response property data/deviceId became not nullable for the status 200
  • the response property data/hardwareId became not nullable for the status 200
  • the response property data/name became not nullable for the status 200
  • the response property data/status became not nullable for the status 200
  • the response property data/tenantId became not nullable for the status 200
  • the response property data/updatedAt became not nullable for the status 200
  • the response property data/createdAt became required for the status 200
  • the response property data/deviceId became required for the status 200
  • the response property data/hardwareId became required for the status 200
  • the response property data/name became required for the status 200
  • the response property data/status became required for the status 200
  • the response property data/tenantId became required for the status 200
  • the response property data/updatedAt became required for the status 200

GET /peripherals/{id}/schema

Section titled “GET /peripherals/{id}/schema”
  • endpoint added

PUT /peripherals/{id}/settings

Section titled “PUT /peripherals/{id}/settings”
  • the response property data/createdAt became not nullable for the status 200
  • the response property data/deviceId became not nullable for the status 200
  • the response property data/hardwareId became not nullable for the status 200
  • the response property data/name became not nullable for the status 200
  • the response property data/status became not nullable for the status 200
  • the response property data/tenantId became not nullable for the status 200
  • the response property data/updatedAt became not nullable for the status 200
  • the response property data/createdAt became required for the status 200
  • the response property data/deviceId became required for the status 200
  • the response property data/hardwareId became required for the status 200
  • the response property data/name became required for the status 200
  • the response property data/status became required for the status 200
  • the response property data/tenantId became required for the status 200
  • the response property data/updatedAt became required for the status 200

GET /spaces/{id}/ancestors

Section titled “GET /spaces/{id}/ancestors”
  • endpoint added

July 15, 2026

Section titled “July 15, 2026”

POST /apps/{appId}/builds

Section titled “POST /apps/{appId}/builds”
  • endpoint added

GET /apps/{appId}/builds/upload-token

Section titled “GET /apps/{appId}/builds/upload-token”
  • endpoint added

POST /apps/{appId}/builds/{buildId}/publish

Section titled “POST /apps/{appId}/builds/{buildId}/publish”
  • endpoint added

POST /auth/device/approve

Section titled “POST /auth/device/approve”
  • endpoint added

POST /auth/device/authorize

Section titled “POST /auth/device/authorize”
  • endpoint added

POST /auth/device/token

Section titled “POST /auth/device/token”
  • endpoint added

GET /auth/sessions

Section titled “GET /auth/sessions”
  • endpoint added

DELETE /auth/sessions/{id}

Section titled “DELETE /auth/sessions/{id}”
  • endpoint added

GET /content-tags

Section titled “GET /content-tags”
  • endpoint added

POST /content-tags

Section titled “POST /content-tags”
  • endpoint added

DELETE /content-tags/{id}

Section titled “DELETE /content-tags/{id}”
  • endpoint added

GET /content-tags/{id}

Section titled “GET /content-tags/{id}”
  • endpoint added

PUT /content-tags/{id}

Section titled “PUT /content-tags/{id}”
  • endpoint added

GET /descriptors

Section titled “GET /descriptors”
  • endpoint added

POST /descriptors

Section titled “POST /descriptors”
  • endpoint added

GET /descriptors/{name}

Section titled “GET /descriptors/{name}”
  • endpoint added

POST /descriptors/{name}/versions

Section titled “POST /descriptors/{name}/versions”
  • endpoint added

GET /descriptors/{name}/versions/{version}

Section titled “GET /descriptors/{name}/versions/{version}”
  • endpoint added

POST /devices/{id}/reboot

Section titled “POST /devices/{id}/reboot”
  • endpoint added

POST /devices/{id}/shell

Section titled “POST /devices/{id}/shell”
  • endpoint added

POST /installations/{id}/clone

Section titled “POST /installations/{id}/clone”
  • endpoint added

GET /installations/{id}/devices

Section titled “GET /installations/{id}/devices”
  • endpoint added

POST /installations/{id}/devices

Section titled “POST /installations/{id}/devices”
  • endpoint added

DELETE /installations/{id}/devices/{deviceId}

Section titled “DELETE /installations/{id}/devices/{deviceId}”
  • endpoint added

GET /installations/{id}/settings/migration

Section titled “GET /installations/{id}/settings/migration”
  • endpoint added

DELETE /installations/{installationId}/devices/{deviceId}/settings

Section titled “DELETE /installations/{installationId}/devices/{deviceId}/settings”
  • endpoint added

GET /installations/{installationId}/devices/{deviceId}/settings

Section titled “GET /installations/{installationId}/devices/{deviceId}/settings”
  • endpoint added

PUT /installations/{installationId}/devices/{deviceId}/settings

Section titled “PUT /installations/{installationId}/devices/{deviceId}/settings”
  • endpoint added

DELETE /installations/{installationId}/spaces/{spaceId}/settings

Section titled “DELETE /installations/{installationId}/spaces/{spaceId}/settings”
  • endpoint added

GET /installations/{installationId}/spaces/{spaceId}/settings

Section titled “GET /installations/{installationId}/spaces/{spaceId}/settings”
  • endpoint added

PUT /installations/{installationId}/spaces/{spaceId}/settings

Section titled “PUT /installations/{installationId}/spaces/{spaceId}/settings”
  • endpoint added

GET /invitations

Section titled “GET /invitations”
  • endpoint added

POST /invitations

Section titled “POST /invitations”
  • endpoint added

DELETE /invitations/{id}

Section titled “DELETE /invitations/{id}”
  • endpoint added

GET /invitations/{id}

Section titled “GET /invitations/{id}”
  • endpoint added

GET /invoices

Section titled “GET /invoices”
  • endpoint added

GET /invoices/{id}

Section titled “GET /invoices/{id}”
  • endpoint added

GET /media

Section titled “GET /media”
  • endpoint added

POST /media/folders

Section titled “POST /media/folders”
  • endpoint added

POST /media/uploads

Section titled “POST /media/uploads”
  • endpoint added

POST /media/{assetId}/complete

Section titled “POST /media/{assetId}/complete”
  • endpoint added

DELETE /media/{mediaId}

Section titled “DELETE /media/{mediaId}”
  • endpoint added

GET /media/{mediaId}

Section titled “GET /media/{mediaId}”
  • endpoint added

PATCH /media/{mediaId}

Section titled “PATCH /media/{mediaId}”
  • endpoint added

GET /peripherals

Section titled “GET /peripherals”
  • endpoint added

GET /peripherals/{id}

Section titled “GET /peripherals/{id}”
  • endpoint added

GET /peripherals/{id}/actions

Section titled “GET /peripherals/{id}/actions”
  • endpoint added

POST /peripherals/{id}/actions/{name}

Section titled “POST /peripherals/{id}/actions/{name}”
  • endpoint added

GET /peripherals/{id}/events

Section titled “GET /peripherals/{id}/events”
  • endpoint added

GET /peripherals/{id}/settings

Section titled “GET /peripherals/{id}/settings”
  • endpoint added

PUT /peripherals/{id}/settings

Section titled “PUT /peripherals/{id}/settings”
  • endpoint added

GET /peripherals/{id}/telemetry

Section titled “GET /peripherals/{id}/telemetry”
  • endpoint added

GET /roles

Section titled “GET /roles”
  • endpoint added

GET /roles/{id}

Section titled “GET /roles/{id}”
  • endpoint added

GET /short-urls

Section titled “GET /short-urls”
  • endpoint added

POST /short-urls

Section titled “POST /short-urls”
  • endpoint added

DELETE /short-urls/{id}

Section titled “DELETE /short-urls/{id}”
  • endpoint added

GET /short-urls/{id}

Section titled “GET /short-urls/{id}”
  • endpoint added

PUT /short-urls/{id}

Section titled “PUT /short-urls/{id}”
  • endpoint added

GET /spaces

Section titled “GET /spaces”
  • added the new optional query request parameter filter[childrenType]
  • added the new optional query request parameter include
  • added the optional property data/items/billingAddress to the response with the 200 status
  • added the optional property data/items/billingContact to the response with the 200 status
  • added the optional property data/items/children to the response with the 200 status

POST /spaces

Section titled “POST /spaces”
  • added the new optional request property billingAddress
  • added the new optional request property billingContact
  • added the optional property data/billingAddress to the response with the 201 status
  • added the optional property data/billingContact to the response with the 201 status
  • added the optional property data/children to the response with the 201 status

POST /spaces/batch

Section titled “POST /spaces/batch”
  • endpoint added

GET /spaces/map

Section titled “GET /spaces/map”
  • endpoint added

GET /spaces/{id}

Section titled “GET /spaces/{id}”
  • added the optional property data/billingAddress to the response with the 200 status
  • added the optional property data/billingContact to the response with the 200 status
  • added the optional property data/children to the response with the 200 status

PUT /spaces/{id}

Section titled “PUT /spaces/{id}”
  • added the optional property data/billingAddress to the response with the 200 status
  • added the optional property data/billingContact to the response with the 200 status
  • added the optional property data/children to the response with the 200 status

GET /tenants

Section titled “GET /tenants”
  • added the required property data/items/tenantName to the response with the 200 status

POST /tenants

Section titled “POST /tenants”
  • :warning: removed the request property parentTenantId
  • added the required property data/tenantName to the response with the 201 status

GET /tenants/{id}

Section titled “GET /tenants/{id}”
  • added the required property data/tenantName to the response with the 200 status

PUT /tenants/{id}

Section titled “PUT /tenants/{id}”
  • added the new optional request property billingAddress/oneOf[#/components/schemas/BillingAddress]/notes
  • added the required property data/tenantName to the response with the 200 status

GET /tenants/{id}/deletion-blockers

Section titled “GET /tenants/{id}/deletion-blockers”
  • endpoint added

GET /tenants/{parentTenantId}/available-child-plans

Section titled “GET /tenants/{parentTenantId}/available-child-plans”
  • endpoint added

POST /tenants/{parentTenantId}/managed-tenants

Section titled “POST /tenants/{parentTenantId}/managed-tenants”
  • endpoint added

GET /tokens

Section titled “GET /tokens”
  • endpoint added

POST /tokens

Section titled “POST /tokens”
  • endpoint added

DELETE /tokens/{id}

Section titled “DELETE /tokens/{id}”
  • endpoint added

GET /users

Section titled “GET /users”
  • endpoint added

GET /users/{id}

Section titled “GET /users/{id}”
  • endpoint added

GET /{id}/users

Section titled “GET /{id}/users”
  • endpoint added