Update Opportunities (Bulk by IDs)

๐Ÿงพ Update Opportunities (Bulk by IDs)

Endpoint: PATCH /api/v3/opportunities

Auth Required: โœ… Yes (Bearer Token)


๐Ÿ“ Description

Performs a partial update on multiple opportunities using their IDs. Useful for bulk status updates, mass stage changes, or other field modifications across a group of opportunities.


๐Ÿ” Query Parameters

None.


๐Ÿ“ฅ Request Body

Content-Type: application/json

Submit an array of opportunity IDs along with the fields to be updated.

๐Ÿ”ง Sample Schema

{  
"ids": ["<id1>", "<id2>"],  "values": {    "<fieldToUpdate>": "<newValue>"  } }  

๐Ÿ“ค Request Example

PATCH https://api.briefingedge.com/api/v3/opportunities Authorization: Bearer <token> Content-Type: application/json  {  "ids": ["1001", "1002"],  "values": {    "stageId": 4  } }  

โœ… Success Response (200 OK)

Returns either the updated opportunities or a summary of the operation.

Example:

{  "updated": 2,  "skipped": 0,  "errors": [] }  

โŒ Error Responses

Code Message Description
400 Bad Request Malformed IDs or invalid update fields.
401 Unauthorized Missing or invalid bearer token.
500 Internal Server Error Unexpected server-side failure.