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. |