Letter template groups

Delete a letter template group

Removes a group and returns it one last time. The templates that were filed under it are kept — they simply become ungrouped. Requires the letter_templates:delete permission.

DELETE
https://services.magicdoor.com/communications/company-portal/letter-templates/groups/{id}

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

idstringrequired

The group to delete. A 64-bit number sent as a string.

example: 1829911204830429184

Response

200 · The group as it was at the moment it was deleted.

idstringrequired

The letter template group. A 64-bit number sent as a string.

namestringrequired

The group's name, as the property manager typed it.

createdstring · date-timerequired

When the group was created, in the company's timezone and with no offset.

updatedstring · date-timerequired

When the group was last renamed, in the company's timezone and with no offset.

401 · The access token is missing, expired, or not a property-manager token.

403 · The token is valid but the caller does not hold the `letter_templates:delete` permission.

404 · No group with that id belongs to the caller's company.

Deleting a group clears letterTemplateGroupId on every letter template that pointed at it. Nothing is lost — the templates keep their content and stay in the list, just without a group.