Comments

The review loop. Comments anchor to a deck, slide, and element, survive version changes, thread via `parent`, and resolve via a `PATCH { resolved: true }` — fully agent-addressable.

Related guides: Comments & versions

Attributes

idstringrequired
objectstringrequired
deckstringrequired
artifactstring | nullrequired
parentstring | nullrequired
The thread root; null for a root.
authorstring | nullrequired
slide_indexnumber | nullrequired
anchorobject | object | nullrequired
bodystringrequired
resolvedbooleanrequired
resolved_attimestamprequired
resolved_bystring | nullrequired
external_idstring | nullrequired
livemodebooleanrequired
metadataobjectrequired
Arbitrary key/value map; merge-on-write (§6).
created_attimestamprequired
updated_attimestamprequired

Endpoints

The Comment object

{
  "id": "com_5d2a…",
  "object": "comment",
  "deck": "deck_2a9f…",
  "artifact": "art_7c1b…",
  "parent": null,
  "author": "usr_1a2b…",
  "slide_index": 2,
  "anchor": {
    "kind": "element",
    "ref": "h2#title",
    "refKind": "id",
    "x": 0.5,
    "y": 0.5
  },
  "body": "This number looks off — should it be Q3?",
  "resolved": false,
  "resolved_at": "2026-06-19T10:30:00.000Z",
  "resolved_by": null,
  "external_id": "review-note-1",
  "livemode": true,
  "metadata": {},
  "created_at": "2026-06-19T10:30:00.000Z",
  "updated_at": "2026-06-19T10:30:00.000Z"
}