Applies a batch tag operation to all entities of the specified type in the workspace. | awork API

The user must be an admin or have workspace-manage-config:write permissions.

<Check title="Required Permissions" icon="key">The user must be an admin or have `workspace-manage-config:write` permissions.</Check>

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

operationstringRequired

This endpoint expects an object.

tagNameslist of strings or nullOptional

The tag names used by delete and update-color operations.

sourceTagNameslist of strings or nullOptional

The source tag names used by merge operations.

targetTagobjectOptional

colorstring or nullOptional

The color used by update-color operations.

Multi-Status

okobject

A collection of requested tag names that share the same batch-operation status.

notFoundobject

A collection of requested tag names that share the same batch-operation status.

badRequestobject

A collection of requested tag names that share the same batch-operation status.

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

1	curl -X POST https://api.awork.com/api/v1/companies/tags/batch/operation \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{}'

1	{
2	"ok": {
3	"tagNames": [
4	"Urgent",
5	"Client"
6	]
7	},
8	"notFound": {
9	"tagNames": [
10	"NonExistentTag",
11	"OldTag"
12	]
13	},
14	"badRequest": {
15	"tagNames": [
16	"Invalid#Tag",
17	"TooLongTagNameThatExceedsTheAllowedLengthForTagsInTheSystem"
18	]
19	}
20	}