From 049bbbfa6b8c1e3fb03af7df66029e4ac6ef96d8 Mon Sep 17 00:00:00 2001
From: Thomas Ritter <thomas.ritter@mocoapp.com>
Date: Tue, 27 Aug 2024 10:57:42 +0200
Subject: [PATCH] Assign an offer to a company/project/deal (#323)

---
 sections/offers.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/sections/offers.md b/sections/offers.md
index a4ae468..b5172a5 100644
--- a/sections/offers.md
+++ b/sections/offers.md
@@ -253,6 +253,26 @@ Mandatory fields are marked with a star (\*):
 - **custom_properties** – {"ext-ref": "3421"}
 - **print_detail_columns**  - true (Hide/Display 'quantity, unit, price'). Optional property, which defaults to the global account layout setting
 
+
+## PUT /offers/{id}/assign
+
+Assign an offer to a company, project, and/or deal.
+
+```bash
+curl -X PUT \
+  'https://{domain}.mocoapp.com/api/v1/offers/{id}/assign' \
+  -H 'authorization: Token token=YOUR_API_KEY' \
+  -H 'Content-Type: application/json' \
+  -d '{
+        "company_id": 1234,
+        "project_id": 2345,
+        "deal_id": 3456
+      }'
+```
+
+{: .note }
+If a `project_id` is set, the project's `company_id` is also set on this offer. If the company does not match the project's company, the project company overrides the given `company_id`.
+
 ## PUT /offers/{id}/update_status
 
 Update an offer status: