> 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/opportunity-tags/write-operations.md).

# Write Operations

Only your organization's own tags can be created and changed.

* **Create opportunity tags** adds new tags to your list.
* **Update opportunity tags** renames them or changes who sees them.

<mark style="color:red;">Vome's own tags are shared across every organization and cannot be created, renamed or deleted. A write aimed at one is refused with that reason, rather than reported as missing.</mark>

Every write endpoint answers with the same shape, where `errors` is keyed by the position of the entry in your request, starting at `1`.

```json
{
  "success": true,
  "processed": 1,
  "opportunity_tags": [
    {
      "id": "9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
      "type": "custom",
      "name": "Weekend crew",
      "editable": true,
      "visible_to_users": false
    }
  ],
  "errors": {}
}
```

By default nothing is written unless every entry is valid, and the response is `400`. Set `allow_partial` to `true` to write the valid entries and have the rest reported back. A request may carry at most 500 tags.
