Skip to the page

Revoke a mail grant (owner or admin); its inboxes are paused

DELETE/v1/organisations/{id}/mail-grants/{grantId}

Operation organisations.revokeMailGrant · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OK

{ "grant" }: revoked; its inboxes are paused.

Path parameters

idstring (uuid)required
The organisation id.
grantIdstringrequired
The mail grant id.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:

  • not_org_admin
DELETE/v1/organisations/{id}/mail-grants/{grantId}
curl -X DELETE "https://api.rykloud.com/v1/organisations/$ORG_ID/mail-grants/$GRANT_ID" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN"