tags/delete_by_id
Tool: delete
Delete a tag.
Deletes a tag from the organization. By default fails with 409 if the tag has active assignments; pass force=true to cascade-delete all assignments first.
Without
force=true, deleting a tag with active prospect, campaign, or sender assignments returns 409 CONFIRMATION_REQUIRED.
Idempotent: deletes are idempotent — a 404 means this tag is already gone (including because an earlier call already deleted it). Treat it as the desired end state, not a failure.
Arguments
| name | type | req | notes |
|---|---|---|---|
| id | integer | ✓ | Tag ID — the object's tagId |
| force | boolean | – | Default false. If true, cascade-deletes all tag assignments before deleting. |
Response
200 — {ok:true} acknowledgement (upstream: 204 No Content).
Errors: 400, 401, 404, 406, 409, 422, 429, 500 — shared schema: schemas/errors. 409 = tag has assignments and force is false.
Invoke
Call delete with name: "tags/delete_by_id".