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

# tag.deleted

> Occurs when a tag is deleted

<ResponseExample>
  ```json Example payload theme={null}
  {
    "id": "ck9v2m5nj0xp4wq7ybftrae8",
    "seq": 89,
    "teamId": "hzcai5t59nn9vsck3rbuepyg",
    "type": "tag.deleted",
    "timestamp": "2025-01-15T17:00:00.000Z",
    "version": "1.0",
    "data": {
      "tagId": "l44e15irdq4db30i77cgphhx"
    }
  }
  ```
</ResponseExample>

## When it fires

A tag is permanently deleted from the workspace. Any prospects that had this tag will have it removed from their `context.tags` array.

<Warning>
  Deleting a tag removes it from all prospects. If you're syncing tags to an external system, use this event to clean up references to the deleted tag.
</Warning>

## Payload

<ResponseField name="tagId" type="string" required>
  The ID of the deleted tag.
</ResponseField>