Visibility overview

OpenDocs is built around safe sharing. The most important default is that publishing a document does not mean making it public to the internet.

Current visibility modes

Mode	Who can read it	Typical use	Plan
private	The author only	Personal drafts, sensitive notes	All
workspace	Active members of the workspace	Team docs, specs, internal plans	All
public	Anyone with the link	External docs, public notes, public references	All

CLI default

The CLI defaults to:

workspace

That's why the docs, CLI, and SKILL.md describe OpenDocs as private-by-default in spirit: the normal path is safe internal sharing, not public broadcast.

The mental model

• Use private when you're drafting alone.
• Use workspace when you want teammates to read it.
• Use public only when the link should be readable outside your workspace by anyone who receives it.

Changing visibility after publish

Every post's visibility can be changed later via POST /api/v1/posts/:postId/visibility without uploading new Markdown. Moving to public always requires confirmPublic: true — this is the one confirmation OpenDocs refuses to remove.

Related pages

• Public sharing — when and how to use public
• Workspaces and team access — how workspace membership works
• Post mutation endpoints — the visibility-change API