Message

20 fields, returned by 9 endpoints.

Fields

idstring · uuid
New records use UUID v7
created_atstring · date-time
updated_atstring · date-time
childrenarray of object or object or object
Optional message UI. Replaces the whole array on edit; [] clears it. At most 32 components and 40,000 combined characters, including info labels and children. Info contains text only and appears beside the preceding component. Loading expires 30 minutes after a children update.
loading_expires_atstring · date-timeNullable
UTC expiry for loading indicators. Null when no loading component is present.
saved_atstring · date-timeNullable
The caller’s private save timestamp; null when not saved.
reply_countnumber
Number of non-deleted replies to this message. Zero for replies.
reply_actor_idsarray of string
First four distinct authors of non-deleted replies, in participation order.
last_reply_atstring · date-timeNullable
reactionsarray of MessageReaction
Cached reactions; empty when nobody has reacted.
reactions_versionnumber
assetsarray of Asset
workspace_idstring · uuid
conversation_idstring · uuid
author_actor_idstring · uuidNullable
Author actor; null if their workspace identity was removed.
body_textstringNullable
Plain text, preserved as sent; null after deletion.
mentioned_actor_idsarray of stringNullable
Mentioned workspace actor IDs captured at write time. Null only for legacy messages awaiting backfill.
parent_message_idstring · uuidNullable
edited_atstring · date-timeNullable
deleted_atstring · date-timeNullable

Returned by

Example

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "children": [
    {
      "type": "text",
      "text": "Deployed api v1.42.1 to production"
    }
  ],
  "loading_expires_at": "2026-10-14T10:24:03.118Z",
  "saved_at": "2026-10-14T10:24:03.118Z",
  "reply_count": 0,
  "reply_actor_ids": [
    "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d"
  ],
  "last_reply_at": "2026-10-14T10:24:03.118Z",
  "reactions": [
    {
      "emoji": "👍",
      "actor_ids": [
        "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d"
      ]
    }
  ],
  "reactions_version": 0,
  "assets": [
    {
      "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
      "created_at": "2026-10-14T10:24:03.118Z",
      "updated_at": "2026-10-14T10:24:03.118Z",
      "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
      "message_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
      "name": "deploys",
      "size_bytes": 1,
      "content_type": "image/png",
      "status": "pending",
      "preview_kind": "image"
    }
  ],
  "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "author_actor_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "body_text": "Deployed api v1.42.1 to production",
  "mentioned_actor_ids": [
    "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f"
  ],
  "parent_message_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "edited_at": "2026-10-14T10:24:03.118Z",
  "deleted_at": "2026-10-14T10:24:03.118Z"
}

{ "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d", "created_at": "2026-10-14T10:24:03.118Z", "updated_at": "2026-10-14T10:24:03.118Z", "children": [ { "type": "text", "text": "Deployed api v1.42.1 to production" } ], "loading_expires_at": "2026-10-14T10:24:03.118Z", "saved_at": "2026-10-14T10:24:03.118Z", "reply_count": 0, "reply_actor_ids": [ "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d" ], "last_reply_at": "2026-10-14T10:24:03.118Z", "reactions": [ { "emoji": "👍", "actor_ids": [ "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d" ] } ], "reactions_version": 0, "assets": [ { "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d", "created_at": "2026-10-14T10:24:03.118Z", "updated_at": "2026-10-14T10:24:03.118Z", "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c", "message_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f", "name": "deploys", "size_bytes": 1, "content_type": "image/png", "status": "pending", "preview_kind": "image" } ], "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f", "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c", "author_actor_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d", "body_text": "Deployed api v1.42.1 to production", "mentioned_actor_ids": [ "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f" ], "parent_message_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d", "edited_at": "2026-10-14T10:24:03.118Z", "deleted_at": "2026-10-14T10:24:03.118Z" }