An object is any piece of content in your space — a page, weblink, tag, daily note instance, or custom type. The primary representation is returned by GET /object.

Response shape

Example (abbreviated):

{
  "id": "7d2e7f8a-4c3b-4e1d-9f0a-123456789abc",
  "structureId": "4ba6e5c6-3f31-45f2-93a0-27a8b2d91551",
  "collections": ["9f20f3d7-7df6-4b4a-8f82-123456789abc"],
  "properties": {
    "title": { "type": "title", "title": { "value": "Example" } }
  },
  "blocks": {
    "content": [
      {
        "id": "b1111111-1111-4111-8111-111111111111",
        "type": "TextBlock",
        "tokens": [{ "type": "TextToken", "text": "Hello", "style": {} }],
        "blocks": [],
        "hierarchy": { "key": "Base", "val": 0 }
      }
    ]
  }
}

Collections

Collections are Capacities databases that group objects of a structure. On read, collections lists the collection ids the object currently belongs to.

When creating or updating:

• Pass specific collection ids to assign the object to those databases.
• Pass collections: [] to move the object back to its default database for that structure (when the structure supports collections).
• Omit collections on create to use default placement behavior.

Only structures that support collections accept collections on POST /object and PATCH /object. Others ignore or reject collection changes.

CRUD overview

Patch requires at least one of properties or collections. Delete supports hardDelete=true to permanently remove an object instead of moving it to trash.

To create or export body content as Markdown instead of block trees, see Markdown.

Media analysis (mediaContent)

For images (MediaImage), GET /object may include mediaContent when AI analysis is complete (mediaContentState is full):

Other media types and fields (audio, weblinks, categories, etc.) are not exposed yet. While analysis is still running or failed, mediaContent is omitted.