For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

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.

  • name cannot 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.