Email & PEC

Delete a label

Permanently removes a label AND its whole subtree — every label nested under it goes too, and any message tagged with any of them loses that tag. It does not touch the messages themselves, only the tag. Confirm with the user before calling this: there is no undo.

Examples

  • Delete the «Bozze 2024» label DELETE /api/v1/rest/email/labels/33333333-4444-4555-8666-777777777777
delete/api/v1/rest/email/labels/{id}

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/email/labels/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.