move_inbox_thread

This reference is generated from the published tool contract.

Behavior and boundaries

Moves an Agent Mailbox thread to inbox, archive or trash. Trash requires expectedSequence from get_inbox_thread; other moves may supply it to reject a concurrent message. All folders preserve messages, attachments, read state and storage usage; moving does not cancel queued sends. Restore by moving to inbox or archive. New incoming mail reopens a retained thread in inbox. Only delete_inbox_thread permanently deletes from trash; there is no automatic expiry. Changes are also visible in the mailbox UI. Requires the client’s write policy, without an additional Ridian approval step.

Permissions

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

inbox:write

Consent and boundaries

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "folder": {
      "type": "string",
      "enum": [
        "inbox",
        "archive",
        "trash"
      ]
    },
    "expectedSequence": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "folder"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "changed": {
      "type": "boolean"
    }
  },
  "required": [
    "changed"
  ],
  "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