/
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 files a skill carries, with sizes, modes, limits and usage
get
/api/preview/capsules/{id}/skill-files
Nov 8, 2026
fd7b0a7085e4
Revision changes
info
endpoint added