Skip to main content
Almanac uses human identifiers at interactive edges and opaque IDs at direct API edges.
The CLI, SDK, frontend, and MCP resolve a workspace/wiki handle, while direct REST paths require opaque resource IDs.
ValueExampleUsed by
Wiki handleacme/company-handbookCLI, Python SDK, frontend, MCP
Workspace IDworkspace_123Direct REST paths and query parameters
Wiki IDwiki_123Direct REST paths and SDK internals
Job IDjob_123Exact job reads and waits
Source IDsource_123Direct source record reads
Page pathoperations/onboardingPage read and provenance routes
Page paths are extensionless and folder-aware. Do not add .md, wiki/, or README.md. Direct API parameters named {*_id} do not accept handles or slugs. See Create and link a wiki for interactive scope and Call the REST API for ID discovery.