Browse all guides

Notes, documents, and files

Use Notes for workspace-level Markdown knowledge with hierarchy, stable slugs, search, activity, and ordering. Use Context for authoritative project intent and decisions. Use Documents for uploaded files, previews, downloads, and task attachments.

Project documents are private by default. The browser sends the project and document identifiers to ToDoddle; the server checks access, derives the storage path, and returns a non-cacheable signed URL that expires after five minutes. Do not copy signed preview or download URLs into durable comments or Notes.

Uploads are limited by the workspace's subscription plan:

  • Free: 10 MiB per file, 250 MiB total, no video upload or playback.
  • Pro: 250 MiB per file, 25 GiB total, 5 GiB source-video storage.
  • Business: 1 GiB per file, 100 GiB total, 25 GiB source-video storage.

Small files may pass through the application so thumbnails can be produced. Larger files upload directly from the browser to private object storage, while video uses the protected streaming service. Pending uploads remain hidden until storage verifies the object.

Agent Connections need explicit document scopes and a compatible project grant. Local MCP uploads are restricted to configured absolute upload roots; HTTPS uploads are fetched and streamed by the local MCP process. In either case, file bodies travel directly to storage rather than through MCP JSON-RPC or the application server.

Updated 2026-08-09. Owned by product.