---
title: "Create multiple new 'Comment' entities"
method: POST
path: "/comment/bulk"
tags: ["Comment"]
---

# Create multiple new 'Comment' entities

`POST /comment/bulk`

## Request

- Base URL: `https://app.testiny.io/api/v1`
- URL: `https://app.testiny.io/api/v1/comment/bulk`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/testiny/apis/testiny-api/docs/comment/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates multiple new 'Comment' entities. Returns a list of new ids only.

## Request body

- Comment[]
  - `id` integer: The unique entity id - must be a positive integer
  - `is_deleted` boolean: If the entity has been soft-deleted this value is true
  - `created_at` string, date-time: The creation time for this entity or mapping value
  - `created_by` number: The creator user id of this entity or mapping value - or zero if created by the system
  - `modified_at` string, date-time: The last modification time for this entity or mapping value
  - `modified_by` number: The id of the user who last modified or undeleted this entity or mapping value - or zero if modified by the system
  - `deleted_at` string, date-time: The soft-deletion time for this entity or mapping value
  - `deleted_by` number: The id of the user who deleted this entity or mapping value - or zero if deleted by the system
  - `project_id` integer: The project id this entity or mapping belongs to
  - `parent_id` integer: Reserved for future use
  - `status` string: Reserved for future use
  - `type` string: The type of comment. Either TEXT or ATTACHMENT. For attachments, please use the specialized API to 'Upload blob data as an attachment to the given test case' instead of creating comments directly!
  - `target` string: The target of the comment. Either TC, TRTC or AR.
  - `text` string: The comment text (can be a rich text document, i.e. markdown with header line `<!--markdown-->` or Testiny JSON format)
  - `attachment` BlobRef[]
    - `id` integer, required
    - `blobId` string, required
    - `title` string, required
    - `filename` string, required
    - `mimeType` string, required
    - `size` integer

## Response `200`

Returns an array of Comment.

- Comment[]
  - `id` integer: The unique entity id - must be a positive integer
  - `is_deleted` boolean: If the entity has been soft-deleted this value is true
  - `created_at` string, date-time: The creation time for this entity or mapping value
  - `created_by` number: The creator user id of this entity or mapping value - or zero if created by the system
  - `modified_at` string, date-time: The last modification time for this entity or mapping value
  - `modified_by` number: The id of the user who last modified or undeleted this entity or mapping value - or zero if modified by the system
  - `deleted_at` string, date-time: The soft-deletion time for this entity or mapping value
  - `deleted_by` number: The id of the user who deleted this entity or mapping value - or zero if deleted by the system
  - `project_id` integer: The project id this entity or mapping belongs to
  - `parent_id` integer: Reserved for future use
  - `status` string: Reserved for future use
  - `type` string: The type of comment. Either TEXT or ATTACHMENT. For attachments, please use the specialized API to 'Upload blob data as an attachment to the given test case' instead of creating comments directly!
  - `target` string: The target of the comment. Either TC, TRTC or AR.
  - `text` string: The comment text (can be a rich text document, i.e. markdown with header line `<!--markdown-->` or Testiny JSON format)
  - `attachment` BlobRef[]
    - `id` integer, required
    - `blobId` string, required
    - `title` string, required
    - `filename` string, required
    - `mimeType` string, required
    - `size` integer

## Other responses

- `4XX`: The request failed because invalid request parameters or data were supplied or access was denied.
- `5XX`: The request failed because an error occurred during processing of the request.

---

[API](https://skmtc.dev/testiny/apis/testiny-api.md) - [All operations](https://skmtc.dev/testiny/apis/testiny-api/llms.txt) - [OpenAPI document](https://skmtc.dev/testiny/apis/testiny-api/revisions/8f7643b2429d?raw)