Internal comments

Comments are notes between teammates on a conversation, such as "called them this morning, hold off". They are the Comment tab beside Email in the app.

List comments

GET /api/v1/inbox/threads/{threadKey}/comments. Requires read:emails.

{
  "threadKey": "18c2f0a9b1d4e5f6",
  "comments": [
    {
      "id": "cmq9cmt00alk34567890",
      "body": "Called them this morning, they want pricing for 500 units. @Rita can you send it?",
      "mentionIds": ["cmq1user0alk34567891"],
      "authorId": "cmq1user0alk34567890",
      "author": { "id": "cmq1user0alk34567890", "name": "Olive Park" },
      "createdAt": "2026-09-27T14:40:00.000Z",
      "updatedAt": "2026-09-27T14:40:00.000Z"
    }
  ]
}

Oldest first. A conversation with no comments returns "comments": [].

Post a comment

POST /api/v1/inbox/threads/{threadKey}/comments. Requires write:emails.

{ "body": "Sent the 500-unit price sheet.", "asUserId": "cmq1user0alk34567891" }

Returns 201 with { "threadKey": "...", "comment": { ... } }. @Name mentions of teammates notify them, the same as in the app.

Comments can be edited and deleted in the app only.