> 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.md).

# Opportunity Tags

The tags you can attach to an opportunity. They come from two lists, and this resource returns both together, because an admin picking tags in Vome chooses from one control without caring which list each came from.

* **Vome's list** is shared by every organization. You can link these to your opportunities, but you cannot change them.
* **Your organization's list** is yours to create, rename and hide.

Base path:

```plaintext
/api/opportunity-tags/
```

<mark style="color:red;">The two lists have independent IDs that can collide, so a tag is always referred to by a</mark> <mark style="color:red;">**type and id pair**</mark><mark style="color:red;">, never an id alone.</mark>

```json
{ "type": "vome", "id": "..." }
{ "type": "custom", "id": "..." }
```

That pair is what Create opportunities expects in its `tags` array.