Skip to content
My Docs

Creates a new comment on a task.

POST
/api/v1/Comments

Sample request:

POST /api/v1/comments
{
    "task_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "content": "This is a comment"
}

Authorizations

Request Body

The comment creation request containing the task ID and comment content.

object
userId
required
string format: uuid
taskId
required
string format: uuid
content
required
string
>= 3 characters <= 500 characters

Responses

201

Returns the newly created comment.

object
id
string format: uuid
taskId
string format: uuid
userId
string format: uuid
content
required
string
nullable
createdDate
string format: date-time
user
object
id
string format: uuid
username
string
nullable
name
string
nullable
email
string
nullable
createdDate
string format: date-time
accessLevel
integer format: int32

400

If the request is invalid or user ID is missing.

object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties

403

If the user doesn’t have access to the task’s project.

object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties

404

If the specified task was not found.

object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties