---
title: "Update Deal"
method: PUT
path: "/deals/{deal_id}"
tags: ["Deals"]
---

# Update Deal

`PUT /deals/{deal_id}`

## Request

- Base URL: `https://app.boei.help/api/v1`
- URL: `https://app.boei.help/api/v1/deals/{deal_id}`
- Auth: HTTP bearer

Update deal details, status, assignment, or temperature.

CRITICAL: Setting outcome (won, lost, abandoned) closes the deal. To move a deal to another pipeline column send status_id from dealStatuses.list instead.

## Request body

- object
  - `name` string: The deal name.
  - `email` string: Contact email.
  - `phone` string: Contact phone.
  - `company` string: Company name.
  - `value` number: Deal value.
  - `source` string: Lead source.
  - `notes` string: Internal notes.
  - `external_url` string: External URL for context.
  - `temperature` string: Deal temperature (cold, warm, hot).
  - `outcome` string: Terminal outcome (won, lost, abandoned). Setting this closes the deal.
  - `status_id` integer: Pipeline status ID.
  - `row_id` integer: Pipeline row (swimlane) ID.
  - `assigned_to` integer: User ID to assign the deal to.
  - `contact_id` string: Link to existing contact.
  - `domain_id` integer: Move the deal to a different business (must be one you own).

## Response `200`

- object
  - `data` object
    - `id` integer
    - `uuid` string
    - `status_id` string, nullable
    - `status` string, nullable
    - `row_id` string, nullable
    - `assigned_to` string, nullable
    - `assigned_user` string, nullable
    - `notification_id` string, nullable
    - `contact_id` string, nullable
    - `domain_id` string, nullable
    - `name` string
    - `email` string
    - `phone` string
    - `company` string
    - `source` string
    - `notes` string
    - `external_url` string, nullable
    - `value` string
    - `temperature` string
    - `outcome` string, nullable
    - `archived_at` string, nullable
    - `next_action_at` string, nullable
    - `next_auto_follow_up_at` string, nullable
    - `auto_follow_up_is_scheduled` boolean
    - `follow_ups_sent` string, nullable
    - `last_auto_follow_up_sent_at` string, nullable
    - `last_ai_draft` string, nullable
    - `last_ai_draft_at` string, nullable
    - `business` string, nullable
    - `follow_up_max` string, nullable
    - `created_at` string
    - `updated_at` string

---

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