> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/opportunities/write-operations/update-opportunities.md).

# Update opportunities

This endpoint updates existing opportunities, matched by their Vome ID. Only the fields you send are changed.

<mark style="color:red;">An</mark> <mark style="color:red;">**id**</mark> <mark style="color:red;">is required on every entry, and must belong to your organization. Updating an opportunity does not notify anyone already approved onto it.</mark>

#### Endpoint

```plaintext
PUT api/opportunities/bulk-update/
```

#### Example Request Payload

```json
{
    "allow_partial": false,
    "opportunities": [
        {
            "id": "2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1",
            "description": "Updated description."
        },
        {
            "id": "7c2a91bb-3f6d-42a7-9d21-0f0a2f5c77aa",
            "published": false,
            "watcher_ids": []  // clears every watcher
        }
    ]
}
```

#### Behavior

* Omitting a field leaves it unchanged.
* Sending `tags`, `site_links` or `watcher_ids` **replaces** what is there. An empty list clears them; leaving the field out leaves them alone.
* `coordinator_ids` cannot be cleared. Sending an empty list is refused, because an opportunity must keep at least one coordinator.
* `published: false` returns the opportunity to draft.
* An opportunity can be moved to another category by sending `category_id`.
