Base URL: https://app.dmu.email/api/v1
Authentication: Bearer dmk_… API key
Rate limit: 120 requests a minute per key

Delete a team

DELETE/teams/{id}

Deletes a team. No mail is deleted, so the body has to repeat the team’s name.

Needs the permissionteams:delete

Its mailboxes may open up

A mailbox shared only with this team becomes visible to everyone in the organisation. One also shared with other teams or people keeps those. Signatures made only for the team are deleted.

Path parameters

idstringrequired: The team.

Body

confirmNamestringrequired: The team’s name.

Returns

Nothing: a successful delete is 204 No Content.

Errors

400confirm_name: confirmName is missing or isn’t the team’s name.
401invalid_key: The key is wrong, expired or revoked. With no Authorization header at all, the code is missing_credentials.
403missing_scope: The key doesn’t have teams:delete. The X-Required-Scope header names what’s missing.
403not_admin: The key’s owner isn’t an administrator.
404not_found: There’s no such team.
429rate_limited: More than 120 requests a minute from this key. Wait for Retry-After seconds.

curl https://app.dmu.email/api/v1/teams/6e1b7c40 \
  -X DELETE \
  -H "Authorization: Bearer dmk_7f3a9c2e1b4d_Xq8v…" \
  -H "Content-Type: application/json" \
  -d '{ "confirmName": "Customer Service" }'

Response

204 No Content

No body.

A 204 has no body, so there’s no data to unwrap.