comment-on-design

Use comment-on-design to leave feedback, ask a question, flag an issue, or add context on a design, either as a note to self or for collaborators. The comment is visible to everyone who has access to the design. To respond inside an existing thread, use reply-to-comment instead.

"Leave a comment on the Q3 launch deck asking the team to double-check the pricing slide."

Pass the design_id and the message_plaintext (1 to 1,000 characters).

IDs below are placeholders; field names and structure are exactly as returned.

{
  "thread": {
    "id": "COMMENT_EXAMPLE",
    "design_id": "DAF_EXAMPLE",
    "thread_type": {
      "type": "comment",
      "content": { "plaintext": "Please double-check the pricing slide before Friday." },
      "mentions": {}
    },
    "author": { "id": "USER_EXAMPLE", "display_name": "Example User" },
    "created_at": 1758000000,
    "updated_at": 1758000000
  }
}

The new comment is returned as a thread. Its thread.id is the comment_id to pass to reply-to-comment and list-replies. The message text is in thread_type.content.plaintext.

• MCP tools and rate limits
• list-comments
• reply-to-comment
• search-designs
• Verify your Canva MCP app