---
title: "Changes to Add item"
method: POST
path: "/api/collections/{namespace}/{slug}-{id}/items"
---

# Changes to Add item

`POST /api/collections/{namespace}/{slug}-{id}/items`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 82 revisions.

- **2026-09-23** `ea15a26e9ab3` — 1 info
- **2026-09-18** `74f2b0d17636` — 1 breaking, 2 warning
- **2026-09-17** `805b42ee6d4c` — 1 info
- **2026-09-15** `ee270f1bbf18` — 2 info
- **2026-09-08** `bd17546f47b8` — 3 breaking, 6 info
- **2026-08-13** `99cb19038135` — 5 warning, 3 info
- **2026-07-31** `c3e0c48d4112` — 1 info
- **2026-07-26** `36390f25f00f` — 2 info

## Changes

- **2026-09-23** `ea15a26e9ab3` — 1 info
  - added the optional property `items/items/anyOf[subschema #6]/description` to the response with the `200` status
- **2026-09-18** `74f2b0d17636` — 1 breaking, 2 warning
  - the `repoType` response property const value `bucket` was removed for the status `200`
  - added the new `bucket` enum value to the `items/items/anyOf[subschema #6]/repoType` response property for the response status `200`
  - added the new `container` enum value to the `items/items/anyOf[subschema #6]/repoType` response property for the response status `200`
- **2026-09-17** `805b42ee6d4c` — 1 info
  - added the optional property `items/items/anyOf[subschema #1]/isEnvironment` to the response with the `200` status
- **2026-09-15** `ee270f1bbf18` — 2 info
  - added `subschema #1, subschema #6` to the `items/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #6` from the `items/items/` response property `anyOf` list for the response status `200`
- **2026-09-08** `bd17546f47b8` — 3 breaking, 6 info
  - the `item/type` request property type changed from no type to `string`
  - added `subschema #1, subschema #2` to the `owner` response property `oneOf` list for the response status `200`
  - the `theme` response's property type changed from no type to `string` for status `200`
  - removed `subschema #1, subschema #2` from the `items/items/` response property `allOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `gating` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `items/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `gating` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `owner` response property `anyOf` list for the response status `200`
  - the `lastUpdated` response's property pattern was changed from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `200`
- **2026-08-13** `99cb19038135` — 5 warning, 3 info
  - added the new `admin` enum value to the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property for the response status `200`
  - added the new `contributor` enum value to the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property for the response status `200`
  - added the new `no_access` enum value to the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property for the response status `200`
  - added the new `read` enum value to the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property for the response status `200`
  - added the new `write` enum value to the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property for the response status `200`
  - added `subschema #2, subschema #3, subschema #5` to the `items/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `owner/anyOf[subschema #2]/primaryOrg/userRole` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #3, subschema #5` from the `items/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
- **2026-07-31** `c3e0c48d4112` — 1 info
  - added the required property `items/items/allOf[subschema #2]/anyOf[subschema #3]/disabled` to the response with the `200` status
- **2026-07-26** `36390f25f00f` — 2 info
  - added `subschema #2, subschema #6` to the `items/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #6` from the `items/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/huggingface/apis/hub-api-endpoints/docs/api/collections/:namespace/:slug-:id/items/post.md) · [API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [Page](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/collections/:namespace/:slug-:id/items/post)