---
title: "Changes to Update a capsule"
method: PUT
path: "/api/preview/capsules/{id}"
---

# Changes to Update a capsule

`PUT /api/preview/capsules/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 12 revisions.

- **2026-10-27** `3a2c4ebeab51`: 13 info
- **2026-10-19** `5778844d1f9e`: 5 info
- **2026-10-09** `c7729725d527`: 10 info
- **2026-09-12** `74a5f960149b`: 1 breaking, 1 warning, 3 info
- **2026-08-29** `9ca3e15b9d44`: 3 info
- **2026-08-24** `0b9410b4856e`: 3 warning, 7 info
- **2026-08-18** `c690ac22ae04`: 7 info
- **2026-08-13** `c5d204adbdc7`: 1 info

## Changes

- **2026-10-27** `3a2c4ebeab51`: 13 info
  - added the new optional request property `draftAttachmentIds`
  - added the new optional request property `draftId`
  - added the new optional request property `removeAttachmentIds`
  - added the optional property `log/owner_ref` to the response with the `200` status
  - added the optional property `packaging/republish_refused` to the response with the `200` status
  - added the optional property `republish` to the response with the `200` status
  - added the optional property `skill_name_next` to the response with the `200` status
  - added the optional property `skill_name_served` to the response with the `200` status
  - added the optional property `skill_republish_reasons` to the response with the `200` status
  - added the optional property `type_guidance_check` to the response with the `200` status
  - added the optional property `type_guidance_note` to the response with the `200` status
  - added the optional property `type_guidance_status` to the response with the `200` status
  - added the optional property `type_guidance_status_reason` to the response with the `200` status
- **2026-10-19** `5778844d1f9e`: 5 info
  - added the optional property `converted_entry` to the response with the `200` status
  - added the optional property `is_shared` to the response with the `200` status
  - added the optional property `log_paragraph_rendering` to the response with the `200` status
  - added the optional property `type_paragraph_rendering` to the response with the `200` status
  - added the optional property `viewer_can_write` to the response with the `200` status
- **2026-10-09** `c7729725d527`: 10 info
  - added the new optional request property `authored_blank`
  - added the new optional request property `prompt_arguments`
  - added the new optional request property `reclaim_alias`
  - added the optional property `alias_reclaimable` to the response with the `200` status
  - added the optional property `alias_reclaimed` to the response with the `200` status
  - added the optional property `deadCrossRefs` to the response with the `200` status
  - added the optional property `marked_complete` to the response with the `200` status
  - added the optional property `share_display_rendered` to the response with the `200` status
  - added the optional property `share_display_unhonored` to the response with the `200` status
  - added the optional property `visibility` to the response with the `200` status
- **2026-09-12** `74a5f960149b`: 1 breaking, 1 warning, 3 info
  - request property `content_md` list-of-types was narrowed by removing types `null` from media type `application/json`
  - changed the pattern of the request property `client_updated_at` 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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$` 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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$`
  - added `subschema #7` to the `field_values/additionalProperties/` request property `anyOf` list
  - the request property `content_md` became nullable
  - added the optional property `packaging` to the response with the `200` status
- **2026-08-29** `9ca3e15b9d44`: 3 info
  - added the new optional request property `incomplete`
  - added the optional property `incomplete` to the response with the `200` status
  - added the optional property `missing_required_fields` to the response with the `200` status
- **2026-08-24** `0b9410b4856e`: 3 warning, 7 info
  - removed the optional property `form_answered_at` from the response with the `200` status
  - removed the optional property `form_responses` from the response with the `200` status
  - removed the optional property `form_schema` from the response with the `200` status
  - added the new optional request property `share_display`
  - added the optional property `agent_meta` to the response with the `200` status
  - added the optional property `is_agent` to the response with the `200` status
  - added the optional property `preview_fields` to the response with the `200` status
  - added the optional property `share_display` to the response with the `200` status
  - added the optional property `share_display_effective` to the response with the `200` status
  - added the optional property `type_share_template` to the response with the `200` status
- **2026-08-18** `c690ac22ae04`: 7 info
  - added the optional property `form_answered_at` to the response with the `200` status
  - added the optional property `form_responses` to the response with the `200` status
  - added the optional property `form_schema` to the response with the `200` status
  - added the optional property `inbound_ref_count` to the response with the `200` status
  - added the optional property `skill_republish_needed` to the response with the `200` status
  - added the optional property `summary_stale` to the response with the `200` status
  - added the optional property `unreferenced` to the response with the `200` status
- **2026-08-13** `c5d204adbdc7`: 1 info
  - added the new optional request property `agent_meta`

---

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