Beta

API ReferenceComment

Create Comment (Project)

POSThttps://api.youvico.com/api/projects/:id/comments
MCP Tool
create_project_commentCreate Project Comment
Rate Limit
Tier 4
Scope
comments:write
Project Role
OwnerManagerMemberReviewerRestricted Reviewer

Creates a comment or reply on a project.

Example

curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "content": "Project brief is ready for review.", "attachments": [{ "id": "CA1234567890ABCD" }] }'

{
  "data": {
    "id": "e3a9c4f1-5b2d-4c8e-9f7a-1d6b8e2c4a90"
  }
}
Request
curl -X POST 'https://api.youvico.com/api/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/comments' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"content": "Project brief is ready for review.",
"attachments": [
{
"id": "CA1234567890ABCD"
}
]
}'
Response201 Created
{
  "data": {
    "id": "e3a9c4f1-5b2d-4c8e-9f7a-1d6b8e2c4a90"
  }
}

Request

Path

idstringrequired
Project ID

Body

contentstring

Maximum 5000 characters

Comment text

Example: Project brief is ready for review.

parentobject
Parent comment. Omit to create a top-level comment
parent.idstringrequired

UUID

Top-level comment ID
attachmentsarray

1-10 items, unique IDs

Comment attachments
attachments[].idstringrequired
Completed comment attachment ID

Example: CA1234567890ABCD

Note

Send at least one of content or attachments with a value.

Response

Returns 201 Created.

dataobject
Created comment
data.idstring
ID of the created comment

Example: e3a9c4f1-5b2d-4c8e-9f7a-1d6b8e2c4a90