---
title: "Merge existing tags"
method: POST
path: "/v2/tag/merge"
tags: ["Asset Tags"]
---

# Merge existing tags

`POST /v2/tag/merge`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/tag/merge`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/tag/merge/post.ts> (a function with typed inputs; its response is checked against the schema)

Merges tags. Can merge into an existing or new tag depending on the input parameters

## Request body

- object
  - `tagIds` integer[]: Array of tag ids to merge
  - `mergeMethod` 'MERGE_INTO_EXISTING_TAG' | 'MERGE_INTO_NEW_TAG': Method to use - merge into an existing tag or create a new one
  - `mergeIntoTagId` integer, nullable: If merging into an existing tag, you must provide the target tag id here
  - `name` string, nullable: If creating a new tag, you must supply the new tag name here
  - `description` string, nullable: If creating a new tag, you can supply the new tag description here

## Response `default`

default response

- object
  - `id` integer: Tag ID
  - `name` string: Tag name
  - `description` string: Description of the tag
  - `createTime` number, double: Creation time for the tag in seconds since unix epoch
  - `updateTime` number, double: Last update time for the tag in seconds since unix epoch
  - `createdByUserId` integer: Id of the user that created the tag
  - `updatedByUserId` integer: Id of the user that last updated the the tag

## Changes

- **2025-12-12** `7c00bdd989ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/tag/merge/post.md)

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)