---
title: "Update Deal"
method: PATCH
path: "/v3/deals/{id}"
tags: ["Negócios"]
---

# Update Deal

`PATCH /v3/deals/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateDealDto
  - `_id` string
  - `name` string — Nome do negócio
  - `value` number — Valor em dinheiro do negócio
  - `description` string — Descrição do ticket
  - `slaDueAt` string, date-time — Prazo de SLA do ticket
  - `lostReason` string[] — Motivos de perda
  - `productsLostReason` object[] — Motivos de perda por produto
  - `products` DealProduct[]
    - `id` string, required
    - `name` string, required
    - `price` number, required
    - `quantity` number, required
    - `discount` number, required
    - `discountType` 'percentage' | 'value', required
    - `total` number, required
  - `lostReasonObs` string — Observação de perda
  - `wonLostDate` string, date-time — Data de perda ou ganho
  - `dueDate` string, date-time — Data de vencimento
  - `status` 'open' | 'won' | 'lost' — Status do negócio
  - `contact` DealContact
    - `id` number, required
    - `name` string, required
    - `avatar` string, required
    - `phone` string, required
    - `email` string, required
    - `createdAt` string, date-time
    - `isPrivate` boolean
  - `conversation` DealConversation
    - `id` number, required
    - `platformId` number, required
    - `lastMessageAt` string, date-time
    - `showPending` boolean, required
    - `pendingAt` string, date-time
  - `operatorId` number — ID do usuário responsável pelo negócio
  - `groupId` number — ID do grupo associado ao negócio
  - `pipelineId` string — ID do pipeline associado ao negócio
  - `stageId` string
  - `origin` string
  - `campaign` string
  - `authorType` 'user' | 'bot' | 'automation' | 'workflow' | 'unknown' | 'cadence' | 'api'
  - `authorId` object
  - `tagIds` number[]
  - `position` number
  - `focusedCounts` number
  - `tasks` object
  - `timeInStage` object
  - `lastStageChanged` string, date-time
  - `comments` number
  - `context` DealContext
    - `automationId` string
    - `importId` string
  - `customFields` object

## Response `200`

---

[API](https://skmtc.net/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.net/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kinbox/kinbox-api/versions/c8469f0ba490/schema)