Update a capsule

Package this capsule as a Claude Code agent (true) or stop packaging it (false). Omit to leave unchanged. An agent's system prompt is its resolved body — its authored markdown, or its Type's output_template when it borrows one, with its field values composed in whenever the Type declares fields (those fields are prompt inputs, not dropped data); its alias is its name, and its summary is its description; encrypted capsules can't be agents.

Required alongside content_md: "" when the Type has an output_template: confirms you want an empty authored body instead of the template. false asks for the refusal (422 empty_body_on_templated_type) now; omitting it is accepted with a warning until the API changelog's effective date, then refused.

Optimistic-concurrency token. ISO-8601 datetime WITH offset (Z or ±HH:MM); pass the value returned by get_capsule's updated_at field verbatim. (Tightened from legacy: bare ISO without offset is now rejected as a 422 instead of silently bypassing OCC.) If the server's stored updated_at differs, the request 409s.

Markdown body (source of truth). Omit to leave it unchanged. Send body text to author the body. Send null to borrow the Type's output template live again (un-fork), which also resets token_bindings. Send an empty string for an empty authored body; on a Type with an output template that also needs authored_blank: true (see authored_blank). Maximum length is configured per-Type via content_md_max (default 20000, ceiling 90000).

Draft session id the drafts in draftAttachmentIds were staged in. Required when draftAttachmentIds is non-empty.

Set the capsule's incomplete state (issue #1703). Send false to complete it — the Type's required fields are enforced at that moment and completion fails naming any still missing; send true to re-open it. Omit to leave unchanged, except that a field_values write to an incomplete capsule that leaves no required field unmet completes it (the reply carries marked_complete: true), after which required fields are enforced.

One-way: set to true to enable E2EE on this capsule. Cannot be reverted to false.

Expose this capsule on the MCP prompts surface, or remove it. Toggling does not move the capsule or change its @type/ref. Omit to leave unchanged.

UUID v4 string

Set true with slug to reuse an alias that belonged to a deleted capsule; without it that alias returns 409. Never frees an alias another capsule still answers to. Older mentions of the alias stay unresolved; only new mentions reach this capsule.

For a capsule published as a skill: whether editing it republishes the skill so the served content follows the edit. When omitted, an AI assistant's edit republishes and an API key's or a signed-in person's does not. Send true to republish, or false to leave the published skill stale and republish manually. The reply's republish object says whether a republish was started. No effect on capsules that aren't published skills.

How this capsule renders on its public share page: article, prompt, or showcase. Omit (or send null on update) to INHERIT the Type's share_template live; a concrete value pins it permanently. Independent of is_prompt (which controls MCP prompt exposure).

Optional human-readable alias (@type/alias). Lowercase slug, max 60 chars, not purely numeric. Resolves to the same capsule as its numeric ref.

Short summary. A non-empty value is REQUIRED from AI/MCP callers whenever the edit changes content_md or field_values on an unencrypted capsule — resend the current one if it still fits. null clears the summary and is accepted only where that requirement does not apply: a metadata-only edit, an encrypted capsule, or a non-AI caller.

New capsule title

Wrapped CEK; required when enabling encryption.

UUID v4 string

When the capsule's age clock was last renewed. Staleness and auto-archive measure from it. Equal to updated_at except after a Type field rename or retype, which advances updated_at (the edit token) and keeps this. Read-only; absent from older servers.

The owning capsule's id, when this is an owned log and you may read the owner; otherwise null. Always null in write responses.

What the capsule's shared page renders, after the cover fallback: a Showcase with no cover image renders as article. Present on server single-capsule reads and write responses, absent where cover presence was not looked up.

Why share_display_rendered differs from share_display_effective: showcase_no_cover when Showcase was chosen and the capsule has no cover image, else null. Present exactly when share_display_rendered is.

Present with name_changed: the name the next publish would serve it under.

Present with name_changed: the name the skill is served under now.

UUID v4 string