name: canva-comments
description: |
Collaboration and comments skill for Canva designs. Use this skill when user wants
to add comments, feedback, or collaborate on designs. Handles comment threads,
replies, and task assignments. Preview API feature.

Canva Comments & Collaboration

Add comments, feedback, and collaborate on Canva designs.

Capabilities

1. Create Comments - Add comment threads to designs
2. Reply to Comments - Respond to existing threads
3. List Replies - View conversation history
4. Assign Tasks - Assign comments to team members
5. Attach to Elements - Pin comments to specific pages/elements

Available Scripts

Create Comment

# Basic comment
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Great design! Let's adjust the colors."

# Attach to specific page
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Fix this slide" --page "page_123"

# Attach to element
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Update this text" --element "element_456"

# Assign to user
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Please review" --assignee "UAFuser123"

# JSON output
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Feedback" --json

Reply to Comment

# Add reply
.venv\Scripts\python.exe scripts/reply_to_comment.py "DAFxxxxxxxxxx" "thread_abc" "I agree, let me update that."

# JSON output
.venv\Scripts\python.exe scripts/reply_to_comment.py "DAFxxxxxxxxxx" "thread_abc" "Done!" --json

List Replies

# List replies in a thread
.venv\Scripts\python.exe scripts/list_comments.py "DAFxxxxxxxxxx" --thread "thread_abc"

# With limit
.venv\Scripts\python.exe scripts/list_comments.py "DAFxxxxxxxxxx" --thread "thread_abc" --limit 20

# JSON output
.venv\Scripts\python.exe scripts/list_comments.py "DAFxxxxxxxxxx" --thread "thread_abc" --json

Comment Structure

Comment Thread

{
  "id": "thread_abc123",
  "message": "Main comment text",
  "author": {
    "user_id": "UAFxxx",
    "display_name": "John Smith"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "attached_to": {
    "page_id": "page_123",
    "element_id": "element_456"
  },
  "assignee": {
    "user_id": "UAFyyy"
  }
}

Reply

{
  "id": "reply_xyz789",
  "message": "Reply text",
  "author": {
    "user_id": "UAFyyy",
    "display_name": "Jane Doe"
  },
  "created_at": "2024-01-15T11:00:00Z"
}

Use Cases

Design Review Workflow

# 1. Reviewer adds feedback
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" \
    "The headline needs to be more prominent. Consider increasing font size."

# 2. Designer responds
.venv\Scripts\python.exe scripts/reply_to_comment.py "DAFxxxxxxxxxx" "thread_123" \
    "Good point! I've increased it to 48pt. What do you think?"

# 3. Reviewer confirms
.venv\Scripts\python.exe scripts/reply_to_comment.py "DAFxxxxxxxxxx" "thread_123" \
    "Perfect, looks great now!"

Task Assignment

# Assign task to team member
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" \
    "Please add the updated logo to slide 3" \
    --page "page_slide3" \
    --assignee "UAFteammember"

Element-Specific Feedback

# Comment on specific element
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" \
    "This image needs to be replaced with the new product photo" \
    --element "element_image1"

3-Mode Workflow

MODE 1: PLAN

1. Identify the design to comment on
2. Determine if comment is general or attached to element
3. Check if assignment is needed

MODE 2: CLARIFY

Ask user:
- What feedback to provide?
- Should it be attached to a specific element?
- Should it be assigned to someone?

MODE 3: IMPLEMENT

# Create the comment
.venv\Scripts\python.exe scripts/create_comment.py "DAFxxxxxxxxxx" "Your feedback here"

# Output:
# Comment Created Successfully!
# ==================================================
#   Thread ID: thread_abc123
#   Design:    DAFxxxxxxxxxx
#   Message:   Your feedback here
#   Created:   2024-01-15T10:30:00Z

API Notes

Preview API

Comments API is currently in Preview status:
- Functionality may change
- Some features may have limitations
- Enterprise customers have full access

Thread IDs

Thread IDs are returned when:
- Creating a comment (returns new thread ID)
- Design metadata may include comment info

Error Handling

Design Not Found

Error: 404 - Design does not exist

Thread Not Found

Error: 404 - Comment thread does not exist

Permission Denied

Error: 403 - You don't have permission to comment on this design

Missing Scopes

Requires comment:write scope for creating comments and comment:read for viewing.

Integration with Review Workflows

Automated Review Comments

# Example: Add automated review feedback
comments = [
    "Please check spelling on slide 1",
    "Logo placement needs adjustment",
    "Color scheme approved"
]

for comment in comments:
    # Create comment via script
    pass

Collect Feedback

# Get all replies to review
.venv\Scripts\python.exe scripts/list_comments.py "DAFxxxxxxxxxx" --thread "thread_review" --json