Object types in Capacities are represented as structures in the API. Every object has a structureId that identifies which type it belongs to.

Retrieve structures for the token's space via GET /space/structures (or capacities.space.structures() in the TypeScript SDK).

Structure metadata

Each entry in the structures array includes:

Not every basic structure supports every API operation. At the moment, the following structures are supported via the standard CRUD endpoints:

• Page
• Tags
• Tasks
• Custom object types

Content IDs

All content in Capacities is identified by UUIDs.

• Space id — shown in Settings → Space settings, or via GET /user/spaces / GET /space.
• Object id — use GET /object?id=… or copy an object reference from the app (⋯ menu → Copy object reference). The last segment of a reference URL is the object id:

  capacities://SPACE_ID/OBJECT_ID
  

• Collection id — same as object ids: copy a collection reference from the app (⋯ menu → Copy object reference), or look it up under each structure's collections on GET /space/structures, or on objects in the collections array.
• Property definition id — keys in properties and blocks on objects; listed on each structure's propertyDefinitions from GET /space/structures, or in the app under that property's definition settings.
• Block id — present on blocks returned by GET /object; required for patch/delete/position operations.

Built-in structures

Built-in Capacities types use fixed structureId strings:

Custom object types you create in Capacities have their own structureId (a UUID). Look them up via GET /space/structures.