Update opportunity tags
This endpoint renames your organization's tags or changes who can see them. Only the fields you send are changed.
Sending the ID of a Vome tag is refused with an explanation, because those are shared across every organization. It is not reported as missing, so you can tell a shared tag apart from a wrong ID.
Endpoint
PUT api/opportunity-tags/bulk-update/Example Request Payload
{
"allow_partial": false,
"opportunity_tags": [
{
"id": "9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
"name": "Weekend team"
},
{
"id": "4b5c6d7e-8f9a-0b1c-2d3e-4f5a6b7c8d9e",
"visible_to_users": true
}
]
}Behavior
Omitting a field leaves it unchanged.
namecannot be set to an empty value, and must stay unique within your organization.Opportunities already carrying the tag pick up the new name, because they reference it by ID.