add sub account deletion

[oshchyhol]

Motivation

The organization client can list and create sub accounts but has no way to delete one. This adds the DELETE /api/organizations/{organization_id}/sub_accounts/{sub_account_id} operation.

Changes

• new IOrganizationSubAccountResource with Delete(), reached via IOrganizationResource.SubAccount(long subAccountId)
• SubAccount(id) rejects ids less than or equal to zero with ArgumentOutOfRangeException, like the other single-resource getters
• XML docs cover the operation's behaviour – requires sub account management permissions, permanent and removes all sub account data, deleting the last sub account deletes the organization, repeated call returns 404, rate limit of 10 requests per minute per organization
• Mailtrap.Example.SubAccount deletes the sub account it created

How to test

Use an organization API token with sub account management permissions and a fresh sub account created via organization.SubAccounts().Create(...).

• await organizationClient.Organization(orgId).SubAccount(subAccountId).Delete() completes without an exception; the sub account is gone from SubAccounts().GetAll()
• call Delete() again on the same id – HttpRequestFailedException with status 404
• call Delete() with a sub account id that belongs to another organization, or with a token that lacks sub account management permissions – status 403
• call Delete() with an invalid token – status 401
• SubAccount(0) and SubAccount(-1) throw ArgumentOutOfRangeException before any request is sent
• dotnet run --project examples/Mailtrap.Example.SubAccount lists, creates and then deletes the demo sub account, logging Deleted Sub Account: Id=...

Companion PRs

• backend endpoint (must deploy first)
• document the delete organization sub account endpoint mailtrap-openapi#56 – spec
• add sub account deletion mailtrap-nodejs#159 – nodejs SDK
• add sub account deletion mailtrap-ruby#130 – ruby SDK
• add sub account deletion mailtrap-python#83 – python SDK
• add sub account deletion mailtrap-php#80 – php SDK
• add sub account deletion mailtrap-java#75 – java SDK
• add sub account deletion mailtrap-go#30 – go SDK
• add sub-account deletion to the CLI mailtrap-cli#15 – CLI
• add delete-sub-account tool mailtrap-mcp#144 – MCP server

Caveat: merge and release only after the backend change ships; the endpoint is not in production yet.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 07a5d7e8-ab1c-446b-9665-dc3d55563ef9

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}