> 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/categories/write-operations/update-categories.md).

# Update categories

This endpoint updates existing categories, 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.</mark> <mark style="color:red;">**title**</mark> <mark style="color:red;">cannot be set to an empty value.</mark>

#### Endpoint

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

#### Example Request Payload

```json
{
    "allow_partial": false,
    "categories": [
        {
            "id": "d610ab31-e480-4ef1-9e35-94f94ebacde9",
            "description": "Updated description."
        },
        {
            "id": "7c2a91bb-3f6d-42a7-9d21-0f0a2f5c77aa",
            "title": "Food Programs",
            "cover_image": "Food",
            "site_links": []  // clears every site link
        }
    ]
}
```

#### Behavior

* Omitting a field leaves it unchanged.
* Sending `site_links` replaces the category's links. Sending an empty list clears them, and leaving the field out leaves them alone.
* Covers work as they do on create, except that **no default is applied**. Saying nothing about the cover leaves the existing artwork in place; send `cover_image` or `cover_image_id` to change it.
