---
title: "Changes to Create a new instance under an existing app"
method: POST
path: "/api/v1/apps/{app_id}/instances"
---

# Changes to Create a new instance under an existing app

`POST /api/v1/apps/{app_id}/instances`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-11-07** `c71a8dc90391`: 2 breaking, 2 warning, 3 info

## Changes

- **2026-11-07** `c71a8dc90391`: 2 breaking, 2 warning, 3 info
  - response property `id` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - response property `user_id` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - removed the request property `node_id`
  - removed the request property `teepod_id`
  - added the new optional request property `name`
  - added the new optional request property `node`
  - added the new optional request property `os_image`

---

[Operation](https://skmtc.dev/phala/apis/phala-cloud-api/docs/api/v1/apps/:app_id/instances/post.md) - [API](https://skmtc.dev/phala/apis/phala-cloud-api.md) - [Page](https://skmtc.dev/phala/apis/phala-cloud-api/changes/api/v1/apps/:app_id/instances/post)