Skip to main content
API reference sections

Schema

WorkspaceUsage

GET /v1/profiles/{id}/workspace-usage.

Live file storage is one number on purpose. A caller needs to answer how much content the visible file set represents, not expose retained recovery data or the persistence engine's page allocation.

Type object

Shape

FieldTypeDescription
workspacerequiredWorkspaceId
entriesrequiredinteger (uint64, >= 0)

Every user-visible manifest entry, across every application kind.

kindsrequiredmap of string to integer (uint64, >= 0)

Counts by application-defined kind token. The Store does not decide whether page, file, or a future token is called a document in a UI.

stored_bytesrequiredinteger (uint64, >= 0)

Deduplicated bytes referenced by live first-class file entries, excluding embedded note media, Trash, retained recovery data, database allocation and backups.

Example
{
  "workspace": "00000000-0000-4000-8000-000000000000",
  "entries": 0,
  "kinds": {
    "key": 0
  },
  "stored_bytes": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

Generated from contract version 1. Last updated .

Privacy choices

Choose which optional tools Koru may use on this site. Your choice is saved in a cookie in this browser for 12 months. Privacy policy

Privacy choices

Keep you signed in, protect forms and remember your language and this choice.

Always on

PostHog and Google Analytics 4 measure page views and actions such as downloads, using cookies or local storage.

PostHog records how pages are used, with form inputs masked and private pages excluded. Needs Analytics.

Ahrefs Web Analytics measures visits and where they come from, and Google Ads measures whether our ads led to a visit or download.