---
title: "Atualizar oportunidade"
method: PUT
path: "/deals/{deal_id}"
---

# Atualizar oportunidade

`PUT /deals/{deal_id}`

## Path parameters

- `deal_id` integer, required

## Request body

- object
  - `pipeline_id` integer — ID do funil da oportunidade
  - `stage_id` integer — ID da etapa da oportunidade
  - `title` string — Título da oportunidade
  - `frozen_at` string, date — Data em que a oportunidade foi congelada. Formatos aceitos: AAAA-MM-DD / AAAA-MM-DD HH:MM:SS
  - `reference` string — Referência da oportunidade para integração com outros sistemas. Por exemplo, ID do lead no RD Station
  - `temperature` integer — Temperatura da oportunidade: (1= muito quente / 2= quente / 3= morna / 4= fria)
  - `probability` integer — Probabilidade de fechamento da oportunidade, sendo possível informar de "0" até "90".
  - `owner_id` integer — ID do usuário dono da oportunidade
  - `person_id` integer — ID da pessoa vinculada à oportunidade
  - `company_id` integer — ID da empresa vinculada à oportunidade
  - `lost_reason_id` integer — ID do motivo de perda da oportunidade
  - `origin_id` integer — ID da origem da oportunidade
  - `started_in_stage_id` integer — ID da etapa onde a oportunidade foi criada
  - `created_at` string, date — Data de criação da oportunidade. Formatos aceitos: AAAA-MM-DD / AAAA-MM-DD HH:MM:SS
  - `closed_at` string, date — Data de fechamento da oportunidade. Formatos aceitos: AAAA-MM-DD / AAAA-MM-DD HH:MM:SS
  - `reason_close` string — Comentário do motivo de perda.
  - `status` integer — Status da oportunidade (0= aberta / 1= ganha / 3= perdida)
  - `deleted` boolean — Oportunidade na lixeira (False= fora da lixeira / True= na lixeira)
  - `freezed` boolean — Oportunidade congelada (False= oportunidade não congelada / True= oportunidade congelada)
  - `value` number, float — Valor de produtos e serviços (P&S) da oportunidade
  - `value_mrr` number, float — Valor de recorrência (MRR) da oportunidade
  - `order` integer — Ordem (ou posição) da oportunidade na etapa do funil
  - `probably_closed_at` string, date — Data de previsão de fechamento
  - `last_contact_at` string, date — Data do último contato. Formatos aceitos: AAAA-MM-DD / AAAA-MM-DD HH:MM:SS
  - `custom_fields` object[] — Array contendo o ID e os valores dos campos customizados da oportunidade
    - `id` integer — ID do campo customizado.
    - `value` string — Valor do campo customizado.
  - `tags` object[] — Array contendo o ID das tags vinculadas à oportunidade
    - `id` integer — ID da Tag.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` integer
    - `account_id` integer
    - `hash` string
    - `type_reference` integer
    - `reference` string
    - `temperature` integer
    - `probability` integer
    - `pipeline_id` integer
    - `owner_id` integer
    - `stage_id` integer
    - `person_id` integer
    - `company_id` integer
    - `lost_reason_id` integer
    - `origin_id` integer
    - `started_in_stage_id` integer
    - `city_id` integer
    - `created_at` string
    - `title` string
    - `description` string
    - `observation` string
    - `status` integer
    - `closed_at` string
    - `reason_close` string
    - `deleted` integer
    - `freezed` integer
    - `value` integer
    - `order` integer
    - `updated_at` string
    - `last_stage_updated_at` string
    - `value_mrr` integer
    - `probably_closed_at` string
    - `last_contact_at` string
    - `stage_changed_at` string

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/pipe/apis/application-json.md) · [All operations](https://skmtc.net/pipe/apis/application-json/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipe/application-json/revisions/0a130198f0a3/schema)