---
title: "Replaces the Deal resource."
method: PUT
path: "/deals/{id}"
tags: ["Deal"]
---

# Replaces the Deal resource.

`PUT /deals/{id}`

Replaces the Deal resource.

## Path parameters

- `id` string, required

## Request body

- Deal
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string
  - `ownerId` string, nullable — User Id of deal responible
  - `ownerName` string, nullable — User name of deal responsible
  - `stage` string, nullable — Deal's stage e.g: decision
  - `dealName` string, nullable — name of the deal
  - `description` string, nullable — Details about the deal
  - `prospectId` string, nullable — Id of the prospect customer the deal is related to
  - `prospectName` string, nullable — name of the customer the deal is related to
  - `expectedRevenue` integer, nullable — expected revenue from the deal
  - `currency` string, nullable — currency code of the deal e.g: USD
  - `created` string, nullable — date and time the deal is first created
  - `closed` string, date-time, nullable — date and time the deal is closed
  - `associatedContactIds` string[], nullable — A list of contact IDs that are associated with the deal
  - `associatedCompanyIds` string[], nullable — A list of company IDs that are associated with the deal
  - `numAssociatedContacts` integer, nullable — The number of associated contacts

## Response `200`

Deal resource updated

- Deal
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string
  - `ownerId` string, nullable — User Id of deal responible
  - `ownerName` string, nullable — User name of deal responsible
  - `stage` string, nullable — Deal's stage e.g: decision
  - `dealName` string, nullable — name of the deal
  - `description` string, nullable — Details about the deal
  - `prospectId` string, nullable — Id of the prospect customer the deal is related to
  - `prospectName` string, nullable — name of the customer the deal is related to
  - `expectedRevenue` integer, nullable — expected revenue from the deal
  - `currency` string, nullable — currency code of the deal e.g: USD
  - `created` string, nullable — date and time the deal is first created
  - `closed` string, date-time, nullable — date and time the deal is closed
  - `associatedContactIds` string[], nullable — A list of contact IDs that are associated with the deal
  - `associatedCompanyIds` string[], nullable — A list of company IDs that are associated with the deal
  - `numAssociatedContacts` integer, nullable — The number of associated contacts

## Other responses

- `400` — Invalid input
- `404` — Resource not found
- `422` — Unprocessable entity

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/revisions/d08a107895ad/schema)