Create Comment

POST

https://primaryapi.cicle.app/api/v1/cards/:cardId/comments

Last modified:2026-07-02 07:23:00

Maintainer:Putu Aditya

Create a new comment on a card with optional mentioned users. Returns the created comment with creator details.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Comment created successfully

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://primaryapi.cicle.app/api/v1/cards//comments?companyId=&teamId=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "content": "string",
    "mentionedUsers": [
        "string"
    ]
}'

Response Example

{
    "message": "string",
    "comment": {
        "_id": "string",
        "content": "string",
        "creator": {
            "_id": "string",
            "fullName": "string",
            "photoUrl": "string"
        },
        "discussions": [
            {
                "_id": "string",
                "content": "string",
                "creator": {
                    "_id": "string",
                    "fullName": "string",
                    "photoUrl": "string"
                },
                "cheers": [
                    {
                        "_id": "string",
                        "content": "string",
                        "creator": {
                            "_id": "string",
                            "photoUrl": "string"
                        },
                        "receiver": "string",
                        "primaryParent": {
                            "id": "string",
                            "type": "string"
                        },
                        "secondaryParent": {
                            "id": "string",
                            "type": "string"
                        },
                        "isNotified": true,
                        "comment": "string",
                        "card": "string",
                        "featureType": "string",
                        "company": "string",
                        "team": "string",
                        "createdAt": "string",
                        "updatedAt": "string",
                        "__v": 0,
                        "notification": "string"
                    }
                ],
                "team": "string",
                "company": "string",
                "comment": "string",
                "card": "string",
                "featureType": "string",
                "seen": [
                    "string"
                ],
                "createdAt": "string",
                "updatedAt": "string",
                "__v": 0
            }
        ],
        "cheers": [
            {
                "_id": "string",
                "content": "string",
                "creator": {
                    "_id": "string",
                    "photoUrl": "string"
                },
                "receiver": "string",
                "primaryParent": {
                    "id": "string",
                    "type": "string"
                },
                "secondaryParent": {
                    "id": "string",
                    "type": "string"
                },
                "isNotified": true,
                "comment": "string",
                "card": "string",
                "featureType": "string",
                "company": "string",
                "team": "string",
                "createdAt": "string",
                "updatedAt": "string",
                "__v": 0,
                "notification": "string"
            }
        ],
        "team": "string",
        "company": "string",
        "featureType": "string",
        "card": "string",
        "seen": [
            "string"
        ],
        "createdAt": "string",
        "updatedAt": "string",
        "__v": 0
    }
}

Delete Cheer from Card

Get Card Comments