# Tags v2

Scoped tags search, policy lists and reports

## Overwrite black/whitelist

 - [PUT /api/v1/tags/list](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1list/put.md): Bulk overwrite list entries for a scope

RBAC:
- requires ANY of Data.Manage, GroupData.Manage

## Add to black/whitelist

 - [PATCH /api/v1/tags/list](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1list/patch.md): Add entries. For blacklist, soft flag toggles hard/soft.

RBAC:
- requires ANY of Data.Manage, GroupData.Manage

## Get black/whitelist for a scope

 - [GET /api/v1/tags/list](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1list/get.md): Returns array of tag names in black/whitelist. 'soft' applies only to blacklist.

RBAC:
- requires ANY of Data.Read, GroupData.Manage

## Remove from black/whitelist

 - [DELETE /api/v1/tags/list](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1list/delete.md): Remove entries. For blacklist, soft must be specified to remove from that list.

RBAC:
- requires ANY of Data.Manage, GroupData.Manage

## Set policy mode

 - [PUT /api/v1/tags/policy](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1policy/put.md): Set scope policy to 'whitelist' or 'blacklist'.

RBAC:
- requires ANY of Data.Manage, GroupData.Manage

## Get policy mode

 - [GET /api/v1/tags/policy](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1policy/get.md): Returns 'whitelist' or 'blacklist' for scope. Defaults to 'blacklist' if unset.

RBAC:
- requires ANY of Data.Read, GroupData.Manage

## Report a tag

 - [POST /api/v1/tags/report](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1report/post.md): Creates a tag report in a scope.

## List tag reports in a scope

 - [GET /api/v1/tags/reports](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1reports/get.md): RBAC:
- requires ANY of Data.Read, GroupData.Manage

## Search tags by prefix

 - [GET /api/v1/tags/search](https://docs.wellesley.social/openapi/tags-v2/paths/~1api~1v1~1tags~1search/get.md): Returns tag names matching partial name. Scope is optional.