> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add tags to a call

> Adds 1 to 100 plain tags from [List call tags](/api-reference/call-tags/list-call-tags) to a call and returns all tags on the call after the change. Tags already on the call are skipped, so a repeated request is safe. If any id cannot be added, nothing is added and the error lists each refused id in `details`.

Dispositions and system tags cannot be added: a Dialer disposition is recorded by the Dialer, not by a label. Tags you add show `taggedByUserId: null`.

**Which calls.** `callId` is the numeric call id from call history or the call uuid that call webhooks carry as `call_uuid`, in any letter case. Only ended calls are served: a call still in progress returns `409 CALL_TAGS.CALL_NOT_ENDED`, and a transferred call counts as ended only when no leg is live. A call that is ringing, or that ended in the last 30 seconds or so, can return `404 CALL_TAGS.CALL_NOT_FOUND` because its record is not stored yet: retry, or act on the [`call.ended`](/guides/webhooks/events/calls#call-ended) webhook.

**Tags belong to the whole call.** A transferred call has one record per leg, and its tags are shared by every leg. Reading or removing by one leg's numeric id also covers tags added on the other legs, and a tag added by call uuid is stored on the first leg.

When at least one tag was added, the [`call.tags_modified`](/guides/webhooks/events/calls#call-tags_modified) webhook is sent with `tag_action: added`, except for an older call record that has no call uuid.

An agent who edits the call's tags in the Phone's dialer view saves the whole tag set, so they can remove a tag you added.



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://help.cloudtalk.io/llms.txt).


## Related topics

- [List call tags](https://help.cloudtalk.io/api-reference/call-tags/list-call-tags.md)
- [Remove tags from a call](https://help.cloudtalk.io/api-reference/call-tags/remove-tags-from-a-call.md)
- [Changelog](https://help.cloudtalk.io/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.