add sub account deletion

[oshchyhol]

Motivation

The API is getting DELETE /api/organizations/{organization_id}/sub_accounts/{sub_account_id}. The SDK already lists and creates sub-accounts, so deletion is the missing piece.

Changes

• SubAccounts.Delete(ctx, subAccountID) – sends the DELETE request for the organization set with WithOrganizationID, returns *Response and error; same errNoOrganizationID guard as List and Create
• examples/sub-accounts deletes the sub-account it created after listing
• README lists delete for organization sub-accounts

How to test

Use an organization token with sub-account management permissions and a client created with WithOrganizationID.

• create a sub-account, then call client.SubAccounts.Delete(ctx, id) – returns err == nil, resp.StatusCode == 204; the id is no longer in client.SubAccounts.List
• call Delete again with the same id – returns an error with status 404
• call Delete with an id from another organization, or with a token without sub-account management permissions – error with status 403
• call Delete with an invalid token – error with status 401
• create the client without WithOrganizationID and call Delete – returns errNoOrganizationID without sending a request
• MAILTRAP_API_TOKEN=... MAILTRAP_ORGANIZATION_ID=... go run ./examples/sub-accounts – prints the created sub-account, the count, then deleted sub-account
• README renders Organization sub-accounts — list, create & delete

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-dotnet#259 – .NET SDK
• add sub-account deletion to the CLI mailtrap-cli#15 – CLI
• add delete-sub-account tool mailtrap-mcp#144 – MCP server

terraform-provider-mailtrap consumes this module; the change is additive and safe.

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: fdcd2f20-7ac8-4294-9af3-a42ca49c1521

---

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.}