---
title: "Changes to Create a new collection"
method: POST
path: "/collections"
---

# Changes to Create a new collection

`POST /collections`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2026-05-13** (v0) `1a08399e7263`: 2 info
- **2026-04-28** (v0) `a4ff4399dc7a`: 2 info
- **2025-04-15** (v0) `04936a1943d3`: 1 breaking, 8 info
- **2025-04-11** (v0) `badc7519e513`: 1 breaking, 6 info
- **2025-04-11** (v0) `19b0d4bc9ea6`: 1 info
- **2025-03-03** (v0) `ce0a74d4942a`: 1 breaking

## Changes

- **2026-05-13** (v0) `1a08399e7263`: 2 info
  - added the new optional request property `links/items/text`
  - added the optional property `links/items/text` to the response with the `201` status
- **2026-04-28** (v0) `a4ff4399dc7a`: 2 info
  - added the new optional request property `preview_file`
  - added the optional property `preview_file` to the response with the `201` status
- **2025-04-15** (v0) `04936a1943d3`: 1 breaking, 8 info
  - the response property `name` became optional for the status `201`
  - added the new optional request property `caption`
  - added the new optional request property `creator`
  - added the new optional request property `isPartOf`
  - added the new optional request property `links`
  - added the optional property `caption` to the response with the `201` status
  - added the optional property `isPartOf` to the response with the `201` status
  - added the optional property `links` to the response with the `201` status
  - the response property `creator/@id` became required for the status `201`
- **2025-04-11** (v0) `badc7519e513`: 1 breaking, 6 info
  - the response's body type changed from no type to `object` for status `201`
  - added the optional property `creator` to the response with the `201` status
  - added the optional property `description` to the response with the `201` status
  - added the required property `@context` to the response with the `201` status
  - added the required property `@id` to the response with the `201` status
  - added the required property `@type` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
- **2025-04-11** (v0) `19b0d4bc9ea6`: 1 info
  - endpoint added
- **2025-03-03** (v0) `ce0a74d4942a`: 1 breaking
  - api path removed without deprecation

---

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