delete_inbox

This reference is generated from the published tool contract.

Behavior and boundaries

Permanently deletes one of your own Agent Mailboxes, like deleting it in Ridian. Pass its full email address as address to confirm. The address stops receiving mail at once and cannot be reused; messages, drafts and attachments are purged in batches. Mail already handed to the provider cannot be recalled. Deleting does not reset the daily creation limit. Mailboxes shared with you by someone else cannot be deleted here. Cannot be undone; confirm with the user first.

Permissions

Granted scopes, accounts, calendars and visibility rules limit access. Workspace administrators do not automatically gain access to other users’ accounts.

inbox:manage

Consent and boundaries

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "address": {
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    }
  },
  "required": [
    "id",
    "address"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "deleted": {
      "type": "boolean"
    },
    "address": {
      "type": "string"
    }
  },
  "required": [
    "deleted",
    "address"
  ],
  "additionalProperties": false
}

Errors and retries

Check the tool result for errors. Do not blindly retry writes after a timeout. Check the current resource or send status first.

Error handling