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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Bulk delete tags

> Deletes tags synchronously or as an asynchronous bulk job.

`kit.bulkDeleteTags` deletes tags synchronously or as an asynchronous bulk job.

```ts automations/bulk-delete-tags.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { kit } from "automate.ax/kit"

export default automation("Bulk delete tags", () => {
  markSignificant(
    kit.bulkDeleteTags({
      tags: [
        {
          id: 1,
        },
      ],
    }),
  )
})
```

## Input

Pass these fields:

| Field         | Type             | Required | Description                                                                                                                                                  |
| ------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `tags`        | `object[]`       | Yes      | Tags to delete, identified by `id`. Batches of 100 or fewer are processed synchronously (200); larger batches are queued and processed asynchronously (202). |
| `callbackUrl` | `string \| null` | No       | Optional. When the batch is processed asynchronously (more than 100 tags), the results are POSTed to this URL on completion.                                 |

## Output

Returns an object with these fields:

| Field      | Type       | Required | Description |
| ---------- | ---------- | -------- | ----------- |
| `failures` | `object[]` | No       | —           |

> This action requires a Kit OAuth connection. Kit does not allow V4 API keys for this endpoint.

Kit may complete a small bulk request inline or return an asynchronous bulk job. Large queued jobs count against Kit's 300 MB account queue limit.

Kit rate limits OAuth connections to 600 requests per 60 seconds and V4 API keys to 120 requests per 60 seconds. Automate.ax honors provider retry timing for rate-limit and temporary bulk-capacity responses.