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

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

`POST /testcase-query/mapping/bulk/{otherEntities}`

## Request

- Base URL: `https://app.testiny.io/api/v1`
- URL: `https://app.testiny.io/api/v1/testcase-query/mapping/bulk/{otherEntities}`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/testiny/apis/testiny-api/docs/testcase-query/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

- object[]
  - `ids` object: An object of entity id keys for the member entities
    - `testcase_query_id` integer, required
    - `testplan_id` integer, required
  - `mapped` TestPlanTestCaseQueryValues
    - `testplan_id` integer: The testplan_id property
    - `testcase_query_id` integer: The testcase_query_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)