/
SY
symbol
Search skmtc…
⌘K
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 List the capsules in one workspace you deleted or may recover, deleted within the last 30 days, newest first
get
/api/preview/capsules/deleted
Oct 19, 2026
5778844d1f9e
Revision changes
info
endpoint added