---
title: "Create a new collection"
method: POST
path: "/collections"
tags: ["Collections"]
---

# Create a new collection

`POST /collections`

## Response `201`

Collection created

## Other responses

- `400` — The request structure was incorrect
- `401` — Unauthorized; the request did not provide valid authentication details
- `403` — Forbidden; the provided credentials do not have permission to perform the requested action
- `422` — Creation failed due to invalid data

## Changes

> 45 revisions in range; 1 could not be searched.

- **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`
  - …5 more
- **2025-04-11** (v0) `badc7519e513` — 1 breaking, 6 info
  - the response's body type/format changed from ``/`` 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
  - …3 more
- **2025-04-11** (v0) `19b0d4bc9ea6` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/manyfold3d/apis/manyfold-api/changes/collections/post.md)

---

[API](https://skmtc.dev/manyfold3d/apis/manyfold-api.md) · [All operations](https://skmtc.dev/manyfold3d/apis/manyfold-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/manyfold3d/manyfold-api/revisions/a3cbfc387e66/schema)