---
title: "Changes to Add capsules to a collection. Answers per item: 200, 207 when some items failed, 400 when all did. An archived capsule refuses the whole request with 409 `CAPSULE_ARCHIVED` naming it in `details.archived`."
method: POST
path: "/api/preview/collections/{id}/capsules"
---

# Changes to Add capsules to a collection. Answers per item: 200, 207 when some items failed, 400 when all did. An archived capsule refuses the whole request with 409 `CAPSULE_ARCHIVED` naming it in `details.archived`.

`POST /api/preview/collections/{id}/capsules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 12 revisions.

- **2026-10-19** `5778844d1f9e`: 4 info

## Changes

- **2026-10-19** `5778844d1f9e`: 4 info
  - added the optional property `detail` to the response with the `200` status
  - added the required property `failed` to the response with the `200` status
  - added the required property `items` to the response with the `200` status
  - added the required property `unchanged` to the response with the `200` status

---

[Operation](https://skmtc.dev/symbol/apis/symbol-api/docs/api/preview/collections/:id/capsules/post.md) - [API](https://skmtc.dev/symbol/apis/symbol-api.md) - [Page](https://skmtc.dev/symbol/apis/symbol-api/changes/api/preview/collections/:id/capsules/post)
