Create multiple comments

POST /actions/projects/{project_id}/tasks/comment-many

Create several comments at once for a specific project. Each comment requires a text, a task id, a task_status and a person as arguments. This way, comments keep history of status changes. When the comment is created, it updates the task status with the given task status.

Path parameters

  • project_id Required

    Unique identifier of the project

application/json

Body Required

  • task_status_id string(uuid) Required

    Task status identifier

  • comment string

    Comment text content

  • person_id string(uuid)

    Person identifier (optional, defaults to current user)

  • object_id string(uuid) Required

    Task identifier

  • created_at string(date-time)

    Creation timestamp (optional, defaults to current time)

  • checklist object

    Checklist items for the comment

  • links array[string]

    List of related links

Responses

  • 201 application/json

    Comments successfully created

    Hide response attributes Show response attributes object
    • id string(uuid)

      Comment unique identifier

    • task_id string(uuid)

      Task identifier

    • person_id string(uuid)

      Person identifier

    • comment string

      Comment text content

    • task_status_id string(uuid)

      Task status identifier

    • created_at string(date-time)

      Creation timestamp

POST /actions/projects/{project_id}/tasks/comment-many
curl \
 --request POST 'http://api.example.com/actions/projects/a24a6ea4-ce75-4665-a070-57453082c25/tasks/comment-many' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '[{"task_status_id":"c46c8gc6-eg97-6887-c292-79675204e47","comment":"This looks great! Ready for review.","person_id":"d57d9hd7-fh08-7998-d403-80786315f58","object_id":"e68e0ie8-gi19-8009-e514-91897426g69","created_at":"2023-01-01T12:00:00Z","checklist":{"item1":"Check lighting","item2":"Verify textures"},"links":["https://example.com/reference1","https://example.com/reference2"]}]'
Request examples
[
  {
    "task_status_id": "c46c8gc6-eg97-6887-c292-79675204e47",
    "comment": "This looks great! Ready for review.",
    "person_id": "d57d9hd7-fh08-7998-d403-80786315f58",
    "object_id": "e68e0ie8-gi19-8009-e514-91897426g69",
    "created_at": "2023-01-01T12:00:00Z",
    "checklist": {
      "item1": "Check lighting",
      "item2": "Verify textures"
    },
    "links": [
      "https://example.com/reference1",
      "https://example.com/reference2"
    ]
  }
]
Response examples (201)
[
  {
    "id": "b35b7fb5-df86-5776-b181-68564193d36",
    "task_id": "e68e0ie8-gi19-8009-e514-91897426g69",
    "person_id": "d57d9hd7-fh08-7998-d403-80786315f58",
    "comment": "This looks great! Ready for review.",
    "task_status_id": "c46c8gc6-eg97-6887-c292-79675204e47",
    "created_at": "2023-01-01T12:00:00Z"
  }
]