> 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/the-category-object.md).

# The Category object

```json
{
  "id": "d610ab31-e480-4ef1-9e35-94f94ebacde9",
  "created_at": "2024-09-06T02:57:15.008656Z",
  "title": "Community Outreach",
  "description": "Programs and roles related to outreach work.",
  "cover_image": {
    "id": "8b1f0d1c-9a1e-4a3f-9d21-0f0a2f5c77aa",
    "name": "Helping Hands"
  },
  "sites": [
    {
      "id": "2b5b2f4e-9a1e-4a3f-9d21-0f0a2f5c77aa",
      "name": "Downtown Branch",
      "permission": "read"
    }
  ],
  "chat_enabled": true,
  "chat_announcement_only": false
}
```

Notes:

* `cover_image` is `null` when the category has no cover image.
* `sites` lists the sites the category is linked to, and the permission each site's admins get. `read` lets them see the category, `edit` lets them change it.
* `chat_announcement_only` only has an effect when `chat_enabled` is `true`.
