> ## 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.

# Remove tags from a call

> Removes 1 to 100 plain call tags from a call and returns the tags left on it. Removing a plain tag that is not on the call does nothing, so a repeated request is safe. A plain tag that was archived after it was added can still be removed. If any id cannot be removed, nothing is removed and the error lists each refused id in `details`.

Only plain call tags can be removed through the API: dispositions, system tags and Dialer campaign tags cannot, the same tags [Add tags to a call](/api-reference/call-tags/add-tags-to-a-call) refuses. A Dialer disposition is recorded by the Dialer, not by a label.

**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 removed, the [`call.tags_modified`](/guides/webhooks/events/calls#call-tags_modified) webhook is sent with `tag_action: removed`, except for an older call record that has no call uuid.



## API Specification

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


## Related topics

- [Changelog](https://help.cloudtalk.io/changelog.md)
- [CloudTalk API HTTP Error Codes: Causes and Resolutions](https://help.cloudtalk.io/guides/error-codes.md)
- [Call Tags](https://help.cloudtalk.io/en/articles/5854602-call-tags.md)


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