APITag

Delete a tag

DELETE
/public/v1/tags/{id}

Permanently deletes the tag. This is a hard delete — the tag is gone for good and cannot be recovered; to reuse the name later you must create a fresh tag.

Deleting a tag also detaches it from everything it was applied to: it is removed from every product and every tax that carried it. Those products and taxes are not otherwise changed — only the tag label disappears from them. No inventory and no compliance system (Metrc/BioTrack) is affected.

Returns 404 when no tag with that ID exists for the authenticated company.

Any authenticated API key for the company may manage tags; no additional settings permission is required.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the tag to delete.

Response Body

No Content

Example Request
curl -X DELETE 'https://app.distru.com/public/v1/tags/00000000-0000-0000-0000-00000000001a'
Example Response
Empty