---
title: "Changes to Create a new order"
method: POST
path: "/v0/orders"
---

# Changes to Create a new order

`POST /v0/orders`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 44 revisions.

- **2026-05-15** `b819ba3108b3` — 18 breaking, 6 info
- **2026-02-11** `73ad90aa5d19` — 1 warning, 1 info
- **2026-01-15** `60bc3e1c43c0` — 7 breaking, 4 info
- **2025-12-09** `00ce4132845e` — 1 breaking, 1 info

## Changes

- **2026-05-15** `b819ba3108b3` — 18 breaking, 6 info
  - removed the required property `details` from the response with the `400` status
  - removed the required property `details` from the response with the `401` status
  - removed the required property `details` from the response with the `403` status
  - removed the required property `details` from the response with the `404` status
  - removed the required property `details` from the response with the `426` status
  - removed the required property `details` from the response with the `500` status
  - removed the required property `message` from the response with the `400` status
  - removed the required property `message` from the response with the `401` status
  - removed the required property `message` from the response with the `403` status
  - removed the required property `message` from the response with the `404` status
  - removed the required property `message` from the response with the `426` status
  - removed the required property `message` from the response with the `500` status
  - removed the required property `type` from the response with the `400` status
  - removed the required property `type` from the response with the `401` status
  - removed the required property `type` from the response with the `403` status
  - removed the required property `type` from the response with the `404` status
  - removed the required property `type` from the response with the `426` status
  - removed the required property `type` from the response with the `500` status
  - added the required property `error` to the response with the `400` status
  - added the required property `error` to the response with the `401` status
  - added the required property `error` to the response with the `403` status
  - added the required property `error` to the response with the `404` status
  - added the required property `error` to the response with the `426` status
  - added the required property `error` to the response with the `500` status
- **2026-02-11** `73ad90aa5d19` — 1 warning, 1 info
  - changed the pattern of the request property `colocate_with/items/` from `"cont"_[0-9a-zA-Z]+` to `cont_[0-9a-zA-Z_-]{1,21}`
  - the `id` response's property pattern was changed from `"ordr"_[0-9a-zA-Z]+` to `ordr_[0-9a-zA-Z_-]{1,21}` for the status `201`
- **2026-01-15** `60bc3e1c43c0` — 7 breaking, 4 info
  - added the new required request property `end_at`
  - added the new required request property `price`
  - added the new required request property `quantity`
  - added the new required request property `side`
  - added the new required request property `start_at`
  - removed `subschema #1: Buy Order, subschema #2: Sell Order` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - added the new optional request property `cluster`
  - added the new optional request property `colocate_with`
  - added the new optional request property `flags`
  - added the new optional request property `instance_type`
- **2025-12-09** `00ce4132845e` — 1 breaking, 1 info
  - removed `#/components/schemas/market-api_ClusterName` from the `oneOf[subschema #1: Buy Order]/cluster` request property `oneOf` list
  - added `#/components/schemas/market-api_ZoneName` to the `oneOf[subschema #1: Buy Order]/cluster` request property `oneOf` list

---

[Operation](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/docs/v0/orders/post.md) · [API](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation.md) · [Page](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/changes/v0/orders/post)