/
SY
symbol-chat
Search skmtc…
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
attachment
5
bridge
2
capsule
44
get
/api/preview/capsules
List capsules visible to the caller
post
/api/preview/capsules
Create a capsule
get
/api/preview/capsules/alias-availability
Check whether a capsule alias is free in a Type before you create the capsule
post
/api/preview/capsules/batch/archive
Archive or restore many capsules in a single call
post
/api/preview/capsules/batch/archive-impact
Preview what archiving capsules would pause (links, public pages, skills, embeds, and access for the people they are shared with) and, per capsule, whether you could archive it
post
/api/preview/capsules/batch/convert-to-entries
Convert chosen capsules into entries of an existing log Type, one entry each. dry_run previews; a write needs the preview_token and is all-or-nothing.
post
/api/preview/capsules/batch/delete
Delete many capsules in a single call. A batch containing a capsule other capsules cite needs confirm_citations: true.
post
/api/preview/capsules/batch/delete-impact
Preview which capsules cite the capsules about to be deleted (count and a sample of five)
post
/api/preview/capsules/batch/edit-fields
Set or clear one field across many capsules, with a dry run that counts first
post
/api/preview/capsules/batch/edit-tags
Add, remove or replace tags across many capsules, with a dry run that counts first
post
/api/preview/capsules/batch/move
Move many capsules to a different type in a single call
post
/api/preview/capsules/batch/move-impact
Preview the side effects (exposure, dropped collections, template changes, refusals) of moving capsules into a Type
post
/api/preview/capsules/batch/move-to-workspace
Move or copy personal capsules into an organization workspace
post
/api/preview/capsules/batch/recover
Recover many capsules from Recently deleted in a single call
get
/api/preview/capsules/by-ref
Resolve a capsule by its @type/ref or @type/alias
get
/api/preview/capsules/context
Get Type context (guidance + recent capsules) for AI assistants
get
/api/preview/capsules/deleted
List the capsules in one workspace you deleted or may recover, deleted within the last 30 days, newest first
post
/api/preview/capsules/read-cost
Measure what reading capsules costs in characters, alone and read together; capsules you cannot read come back not available
get
/api/preview/capsules/{id}
Get a single capsule by id
put
/api/preview/capsules/{id}
Update a capsule
delete
/api/preview/capsules/{id}
Delete a capsule. It moves to Recently deleted and can be recovered for 30 days; ?permanent=true deletes it for good now (also for a capsule already in Recently deleted). A capsule that owns a log answers 409 `owned_log_present` naming the log and its entry count until `confirmOwnedLog=true` is sent; the log is then deleted with it, or detached and kept when you may not delete it. A log you may not read is never named: it is detached and kept, with no 409. A capsule other capsules cite needs ?confirm_citations=true; sending confirm_citations=true or confirm_citations=false opts in to that gate before its breaking-change effective date.
patch
/api/preview/capsules/{id}/archive
Archive or restore a single capsule
get
/api/preview/capsules/{id}/backlinks
List capsules that reference the given capsule
get
/api/preview/capsules/{id}/dependency-review
List the capsules this one links to that changed since it was last reviewed, those you can read named, the rest counted
post
/api/preview/capsules/{id}/dependency-review
Confirm a capsule is still valid after capsules it links to changed, with a short note and the receipt of a full read
post
/api/preview/capsules/{id}/dependency-review/receipt
Get the review receipt for a full read answered from a local copy, when the copy matches the capsule exactly
post
/api/preview/capsules/{id}/duplicate
Duplicate a capsule
get
/api/preview/capsules/{id}/graph
Walk the references / backlinks graph rooted at this capsule
post
/api/preview/capsules/{id}/guidance-check
Check whether a read of this capsule may leave its Type's guidance out, and get fresh guidance checks
get
/api/preview/capsules/{id}/instruction-export
Render a capsule as an instruction file, with referenced summaries and bodies in place
post
/api/preview/capsules/{id}/recover
Recover a capsule from Recently deleted, with the owned log deleted with it. Links withdrawn at delete stay withdrawn.
get
/api/preview/capsules/{id}/references
List capsules that the given capsule references
delete
/api/preview/capsules/{id}/skill
Stop packaging a capsule as a skill and withdraw the served skill
get
/api/preview/capsules/{id}/skill-files
List the files a skill carries, with sizes, modes, limits and usage
post
/api/preview/capsules/{id}/skill-files
Add or replace one file of a skill. multipart/form-data: path, executable, expected_revision_id, and file or text
delete
/api/preview/capsules/{id}/skill-files
Delete a skill file (its history is kept)
patch
/api/preview/capsules/{id}/skill-files
Mark a skill file executable or not
get
/api/preview/capsules/{id}/skill-files/content
Read one page of a skill file's current content
get
/api/preview/capsules/{id}/skill-files/history
List a skill's file revisions, newest first, including deleted files (editors only)
get
/api/preview/capsules/{id}/skill-files/history/{revisionId}/content
Read one page of an earlier revision of a skill file (editors only)
post
/api/preview/capsules/{id}/skill-files/move
Rename a skill file, keeping its identity and bytes
post
/api/preview/capsules/{id}/skill-files/restore
Restore an earlier revision of a skill file as its current copy
post
/api/preview/capsules/{id}/skill/publish
Publish a capsule as a skill (enabling it when needed), optionally under a chosen name
get
/api/preview/capsules/{id}/versions/compare
Compare two versions of a capsule: title, summary, body lines and field values. `to` defaults to the newest version you can see. Needs a plan with revision history.
collection
9
discover
3
follow
3
history
2
import
8
log-entry
3
marketplace
22
mention
1
messaging
1
project
9
search
1
share
20
snapshot
1
sync
2
tag
3
type
10
user-profile
10
workspace
1
capsule
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to List the capsules this one links to that changed since it was last reviewed, those you can read named, the rest counted
get
/api/preview/capsules/{id}/dependency-review
Nov 8, 2026
fd7b0a7085e4
Revision changes
info
endpoint added