/
SY
symbol
Search skmtc…
⌘K
Docs from a schema
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
attachment
5
bridge
2
capsule
31
get
/api/preview/capsules
List capsules visible to the caller
post
/api/preview/capsules
Create a 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
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
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
3
log-entry
3
mention
1
messaging
1
project
9
search
1
share
20
snapshot
1
sync
2
tag
2
type
10
user-profile
6
workspace
1
capsule
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Measure what reading capsules costs in characters, alone and read together; capsules you cannot read come back not available
post
/api/preview/capsules/read-cost
Oct 27, 2026
3a2c4ebeab51
Revision changes
info
endpoint added