---
title: "Agrupar ticket"
method: POST
path: "/tickets/{ticket_number}/merge"
tags: ["Tickets"]
---

# Agrupar ticket

`POST /tickets/{ticket_number}/merge`

## Request

- Base URL: `https://api.tiflux.com/api/v2`
- URL: `https://api.tiflux.com/api/v2/tickets/{ticket_number}/merge`
- Auth: HTTP bearer

Agrupa um ticket em um determinado ticket.
- O ticket agrupado (`merge_ticket_number`) é cancelado e todo o seu conteúdo é movido para o ticket principal (`ticket_number`).

## Path parameters

- `ticket_number` integer, required

## Request body

- object
  - `merge_ticket_number` integer, required: Número do ticket a ser agrupado no ticket principal

## Response `200`

- object: Confirmação do agrupamento do ticket informado em `merge_ticket_number` no ticket principal
  - `message` string, required: Mensagem de confirmação com os números do ticket agrupado e do ticket principal

## Other responses

- `403`: ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `404`: ### **Ticket principal não encontrado**
- `422`: ### **Não foi possível agrupar o ticket** Os dois tickets precisam estar abertos e ser do mesmo cliente, e o ticket agrupado não pode ter pré-apontamentos pendentes. Os motivos estão detalhados no atributo `detail` dessa resposta. Quando a resposta é 422, nenhum dos tickets é alterado.

## Changes

- **2026-10-15** `13f53ba16095`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiflux/apis/tiflux-official-api/changes/tickets/:ticket_number/merge/post.md)

---

[API](https://skmtc.dev/tiflux/apis/tiflux-official-api.md) - [All operations](https://skmtc.dev/tiflux/apis/tiflux-official-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiflux/apis/tiflux-official-api/revisions/2936ac99a76d?raw)
