# Tag many emails

**POST /local-emails/{caseId}/emails/tags**

Adds tags to emails chosen by id, or to every email matching a search. By id, the tags are added right away; by search, a background job is queued and its id returned (see bulk-tag-jobs).


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters

### Path parameters

- **caseId** (string)



### Body: application/json (object)

- **addMode** (string)

- **tags** (array[string])
  Tag ids or names to ADD (additive union). Names created in the case if absent.

- **ids** (array[string])
  Target ids (required when addMode=by_id).

- **search** (object)
  Search query (required when addMode=by_search).



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)