Skip to main content
Pins are markdown artifacts in the workspace that Load returns first, in order, as read-first context. A workspace holds at most 20. Managing pins requires manageContext (editors and admins). Every member’s load returns the same pins. MCP: workspace_pin / workspace_unpin. CLI: rip workspace pin add|remove <artifact>. A pin names the artifact alone: it goes in the artifact’s own workspace. Auth: Authorization: Bearer tr_... (an account API key).

POST /v0/pins

Returns (201):
Pinning an artifact that is already pinned returns its current position and changes nothing.

DELETE /v0/pins/{artifactId}

{artifactId} is the artifact’s id or alias. Returns 204, also when the artifact was not pinned. The artifact itself is untouched, and later pins move up one slot.

Errors