Delete Tags (by IDs)

The Delete Tags (by IDs) endpoint deactivates one or more tags in a single call. It is a soft delete: matching tags are marked inactive rather than removed from the database, so they immediately stop appearing in Read Tag and tag pickers.

When to use it

Use this endpoint to let users bulk-remove tags they no longer need, instead of calling a single-tag delete endpoint in a loop.

Example request

curl -X DELETE "https://api.turbodocx.com/Tag/Bulk/Action" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90", "9d2b1c63-0f77-4a9c-b1d0-2c5e6f7a8b90"]}'

Example response

On success the endpoint returns 200 OK with an empty data object:

{
  "data": {}
}

Deletion is idempotent: IDs that do not exist, or belong to another organization, are silently skipped rather than causing an error.

Common errors

Status	When	Response body
401	Missing or invalid API key/token, or the organization cannot be resolved	Empty (status only)
403	The key's role is not administrator, contributor, or user	Empty (status only)
400	ids is missing or not an array	{ "message", "type": "ValidationError", "data": { "errors": [...] } }

Related endpoints

• Read Tag to find the tag IDs to delete

• Create Tag to add a new tag

• Update Tag to rename a tag instead of deleting it

  DELETE

  /Tag/bulk/action