---
title: "Add/remove/update mappings between 'Comment' entities and other entities"
method: POST
path: "/comment/mapping/bulk/{otherEntities}"
tags: ["Comment"]
---

# Add/remove/update mappings between 'Comment' entities and other entities

`POST /comment/mapping/bulk/{otherEntities}`

## Request

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

Adds/Removes/Updates mappings between entities (e.g. test cases, test runs, etc.) if the mapping is defined. Id values are named by entity e.g. 'testcase_id', 'testrun_id' (see request schema)

## Path parameters

- `otherEntities` string, required

## Query parameters

- `op` 'add' | 'update' | 'add_or_update' | 'delete'

## Request body

- union
  - object[]
    - `ids` object: An object of entity id keys for the member entities
      - `comment_id` integer, required
      - `testcase_id` integer, required
    - `mapped` TestCaseCommentValues
      - `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
      - `comment_id` integer: The comment_id property
      - `testcase_id` integer: The testcase_id property
  - object[]
    - `ids` object: An object of entity id keys for the member entities
      - `comment_id` integer, required
      - `testcase_id` integer, required
      - `testrun_id` integer, required
    - `mapped` TestRunCommentValues
      - `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
      - `comment_id` integer: The comment_id property
      - `testrun_id` integer: The testrun_id property
      - `testcase_id` integer: The testcase_id property
      - `reference` CommentReference
        - `type` 'STEP', required
        - `rid` string, required
        - `rowNum` number, required
  - object[]
    - `ids` object: An object of entity id keys for the member entities
      - `blob_id` integer, required
      - `comment_id` integer, required
    - `mapped` BlobCommentValues
      - `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
      - `blob_id` integer: The blob_id property
      - `comment_id` integer: The comment_id property
  - object[]
    - `ids` object: An object of entity id keys for the member entities
      - `atm_result_id` integer, required
      - `comment_id` integer, required
    - `mapped` AtmResultCommentValues
      - `comment_id` integer: The comment_id property
      - `atm_result_id` integer: The atm_result_id property
  - object[]
    - `ids` object: An object of entity id keys for the member entities
      - `comment_id` integer, required
      - `milestone_id` integer, required
    - `mapped` MilestoneCommentValues
      - `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
      - `milestone_id` integer: The milestone_id property
      - `comment_id` integer: The comment_id property

## 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)