Skip to main content
Glama
Sendmux

Sendmux Email Inbox API + Sending

Official
by Sendmux

Batch Get Messages

mailbox_batch_get_messages
Read-onlyIdempotent

Fetch multiple email messages in a single request using their IDs, reducing repeated API calls and simplifying retrieval of search results or bulk processing.

Instructions

Use this when the user supplies several message IDs or a prior search returns multiple candidates. It avoids repeated single-message calls.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idsNoMessage IDs to fetch, maximum 100.
partNoBody part to return when body_mode is not `none`.
body_modeNoBody shape to include for each message.
mailbox_idNoMailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox.
include_htmlNoWhen true, include HTML content when available.
strip_quotesNoWhen true, remove quoted reply text.
include_linksNoWhen true, include links extracted from the body.
max_body_charsNoMaximum body characters per message before truncation.
include_headersNoHeader detail to include in each message.
strip_signatureNoWhen true, remove detected email signatures.
include_attachmentsNoAttachment detail to include. Contents are not returned.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.0.14
    • changedOutput schema / properties / result / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "meta": {
      -        "additionalProperties": {},
      -        "properties": {},
      -        "type": "object"
      -      },
      -      "ok": {
      -        "enum": [
      -          true
      -        ],
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "ok",
      -      "meta"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "data": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "messages": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "content": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "attachments": {
      -                      "description": "Attachment metadata only. Attachment contents are not parsed by this endpoint.",
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "content_id": {
      -                            "description": "Content ID for inline attachments, when present.",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "content_type": {
      -                            "example": "application/pdf",
      -                            "type": "string"
      -                          },
      -                          "disposition": {
      -                            "example": "attachment",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "download_url": {
      -                            "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      -                            "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      -                            "type": "string"
      -                          },
      -                          "filename": {
      -                            "example": "invoice.pdf",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "id": {
      -                            "description": "Attachment blob ID.",
      -                            "type": "string"
      -                          },
      -                          "size_bytes": {
      -                            "example": 12345,
      -                            "type": [
      -                              "integer",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "required": [
      -                          "id",
      -                          "filename",
      -                          "content_type",
      -                          "size_bytes",
      -                          "disposition",
      -                          "content_id"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "body": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "extracted_links": {
      -                          "items": {
      -                            "type": "string"
      -                          },
      -                          "type": "array"
      -                        },
      -                        "format": {
      -                          "enum": [
      -                            "text",
      -                            "html"
      -                          ],
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "html": {
      -                          "description": "HTML body when requested. Returned as a JSON string and not as rendered content.",
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "is_truncated": {
      -                          "type": "boolean"
      -                        },
      -                        "quotes_stripped": {
      -                          "type": "boolean"
      -                        },
      -                        "signature_stripped": {
      -                          "type": "boolean"
      -                        },
      -                        "text": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "truncated_at_chars": {
      -                          "type": [
      -                            "integer",
      -                            "null"
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "format",
      -                        "text",
      -                        "html",
      -                        "is_truncated",
      -                        "truncated_at_chars",
      -                        "signature_stripped",
      -                        "quotes_stripped",
      -                        "extracted_links"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "dates": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "received_at": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "sent_at": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "received_at",
      -                        "sent_at"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "headers": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "full": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "name": {
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "name",
      -                              "value"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "type": [
      -                            "array",
      -                            "null"
      -                          ]
      -                        },
      -                        "mode": {
      -                          "enum": [
      -                            "none",
      -                            "selected",
      -                            "full"
      -                          ],
      -                          "type": "string"
      -                        },
      -                        "selected": {
      -                          "properties": {
      -                            "in_reply_to": {
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            },
      -                            "message_id": {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            "references": {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            "reply_to": {
      -                              "items": {
      -                                "additionalProperties": false,
      -                                "properties": {
      -                                  "email": {
      -                                    "example": "agent@example.com",
      -                                    "format": "email",
      -                                    "type": "string"
      -                                  },
      -                                  "name": {
      -                                    "example": "Support",
      -                                    "type": [
      -                                      "string",
      -                                      "null"
      -                                    ]
      -                                  }
      -                                },
      -                                "required": [
      -                                  "email",
      -                                  "name"
      -                                ],
      -                                "type": "object"
      -                              },
      -                              "type": "array"
      -                            }
      -                          },
      -                          "required": [
      -                            "message_id",
      -                            "in_reply_to",
      -                            "references",
      -                            "reply_to"
      -                          ],
      -                          "type": [
      -                            "object",
      -                            "null"
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "mode",
      -                        "selected",
      -                        "full"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "id": {
      -                      "description": "Message ID",
      -                      "type": "string"
      -                    },
      -                    "participants": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "bcc": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "email": {
      -                                "example": "agent@example.com",
      -                                "format": "email",
      -                                "type": "string"
      -                              },
      -                              "name": {
      -                                "example": "Support",
      -                                "type": [
      -                                  "string",
      -                                  "null"
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "email",
      -                              "name"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "type": "array"
      -                        },
      -                        "cc": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "email": {
      -                                "example": "agent@example.com",
      -                                "format": "email",
      -                                "type": "string"
      -                              },
      -                              "name": {
      -                                "example": "Support",
      -                                "type": [
      -                                  "string",
      -                                  "null"
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "email",
      -                              "name"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "type": "array"
      -                        },
      -                        "from": {
      -                          "allOf": [
      -                            {
      -                              "additionalProperties": false,
      -                              "properties": {
      -                                "email": {
      -                                  "example": "agent@example.com",
      -                                  "format": "email",
      -                                  "type": "string"
      -                                },
      -                                "name": {
      -                                  "example": "Support",
      -                                  "type": [
      -                                    "string",
      -                                    "null"
      -                                  ]
      -                                }
      -                              },
      -                              "required": [
      -                                "email",
      -                                "name"
      -                              ],
      -                              "type": "object"
      -                            },
      -                            {
      -                              "type": [
      -                                "object",
      -                                "null"
      -                              ]
      -                            }
      -                          ]
      -                        },
      -                        "reply_to": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "email": {
      -                                "example": "agent@example.com",
      -                                "format": "email",
      -                                "type": "string"
      -                              },
      -                              "name": {
      -                                "example": "Support",
      -                                "type": [
      -                                  "string",
      -                                  "null"
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "email",
      -                              "name"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "type": "array"
      -                        },
      -                        "to": {
      -                          "items": {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "email": {
      -                                "example": "agent@example.com",
      -                                "format": "email",
      -                                "type": "string"
      -                              },
      -                              "name": {
      -                                "example": "Support",
      -                                "type": [
      -                                  "string",
      -                                  "null"
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "email",
      -                              "name"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          "type": "array"
      -                        }
      -                      },
      -                      "required": [
      -                        "from",
      -                        "to",
      -                        "cc",
      -                        "bcc",
      -                        "reply_to"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "states": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "email_state": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "option_hash": {
      -                          "type": "string"
      -                        }
      -                      },
      -                      "required": [
      -                        "email_state",
      -                        "option_hash"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "subject": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "thread_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "id",
      -                    "thread_id",
      -                    "subject",
      -                    "participants",
      -                    "dates",
      -                    "body",
      -                    "headers",
      -                    "attachments",
      -                    "states"
      -                  ],
      -                  "type": [
      -                    "object",
      -                    "null"
      -                  ]
      -                },
      -                "message": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "attachments": {
      -                      "description": "Attachment metadata for this message. Each item includes a short-lived `download_url`; if it expires, fetch message metadata again.",
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "content_id": {
      -                            "description": "Content ID for inline attachments, when present.",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "content_type": {
      -                            "example": "application/pdf",
      -                            "type": "string"
      -                          },
      -                          "disposition": {
      -                            "example": "attachment",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "download_url": {
      -                            "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      -                            "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      -                            "type": "string"
      -                          },
      -                          "filename": {
      -                            "example": "invoice.pdf",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "id": {
      -                            "description": "Attachment blob ID.",
      -                            "type": "string"
      -                          },
      -                          "size_bytes": {
      -                            "example": 12345,
      -                            "type": [
      -                              "integer",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "required": [
      -                          "id",
      -                          "filename",
      -                          "content_type",
      -                          "size_bytes",
      -                          "disposition",
      -                          "content_id"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "bcc": {
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "email": {
      -                            "example": "agent@example.com",
      -                            "format": "email",
      -                            "type": "string"
      -                          },
      -                          "name": {
      -                            "example": "Support",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "required": [
      -                          "email",
      -                          "name"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "cc": {
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "email": {
      -                            "example": "agent@example.com",
      -                            "format": "email",
      -                            "type": "string"
      -                          },
      -                          "name": {
      -                            "example": "Support",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "required": [
      -                          "email",
      -                          "name"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "flags": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "answered": {
      -                          "type": "boolean"
      -                        },
      -                        "draft": {
      -                          "type": "boolean"
      -                        },
      -                        "flagged": {
      -                          "type": "boolean"
      -                        },
      -                        "seen": {
      -                          "type": "boolean"
      -                        }
      -                      },
      -                      "required": [
      -                        "seen",
      -                        "flagged",
      -                        "draft",
      -                        "answered"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "folder_ids": {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "from": {
      -                      "allOf": [
      -                        {
      -                          "additionalProperties": false,
      -                          "properties": {
      -                            "email": {
      -                              "example": "agent@example.com",
      -                              "format": "email",
      -                              "type": "string"
      -                            },
      -                            "name": {
      -                              "example": "Support",
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            }
      -                          },
      -                          "required": [
      -                            "email",
      -                            "name"
      -                          ],
      -                          "type": "object"
      -                        },
      -                        {
      -                          "type": [
      -                            "object",
      -                            "null"
      -                          ]
      -                        }
      -                      ]
      -                    },
      -                    "has_attachments": {
      -                      "type": "boolean"
      -                    },
      -                    "id": {
      -                      "description": "Message ID",
      -                      "type": "string"
      -                    },
      -                    "keywords": {
      -                      "description": "Active message keywords, including system flags and custom labels.",
      -                      "example": [
      -                        "$seen",
      -                        "$flagged",
      -                        "agent_triaged"
      -                      ],
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    "preview": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "received_at": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "sent_at": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "size_bytes": {
      -                      "type": [
      -                        "integer",
      -                        "null"
      -                      ]
      -                    },
      -                    "subject": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "thread_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "to": {
      -                      "items": {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "email": {
      -                            "example": "agent@example.com",
      -                            "format": "email",
      -                            "type": "string"
      -                          },
      -                          "name": {
      -                            "example": "Support",
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "required": [
      -                          "email",
      -                          "name"
      -                        ],
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    }
      -                  },
      -                  "required": [
      -                    "id",
      -                    "thread_id",
      -                    "folder_ids",
      -                    "subject",
      -                    "preview",
      -                    "from",
      -                    "to",
      -                    "cc",
      -                    "bcc",
      -                    "received_at",
      -                    "sent_at",
      -                    "size_bytes",
      -                    "has_attachments",
      -                    "keywords",
      -                    "flags"
      -                  ],
      -                  "type": "object"
      -                },
      -                "raw_body": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "body": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "html": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "is_truncated": {
      -                          "type": "boolean"
      -                        },
      -                        "text": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        },
      -                        "truncated_at_chars": {
      -                          "type": [
      -                            "integer",
      -                            "null"
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "text",
      -                        "html",
      -                        "is_truncated",
      -                        "truncated_at_chars"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "id": {
      -                      "description": "Message ID",
      -                      "type": "string"
      -                    },
      -                    "part": {
      -                      "enum": [
      -                        "text",
      -                        "html",
      -                        "both"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "states": {
      -                      "additionalProperties": false,
      -                      "properties": {
      -                        "email_state": {
      -                          "type": [
      -                            "string",
      -                            "null"
      -                          ]
      -                        }
      -                      },
      -                      "required": [
      -                        "email_state"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "thread_id": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "id",
      -                    "thread_id",
      -                    "part",
      -                    "body",
      -                    "states"
      -                  ],
      -                  "type": [
      -                    "object",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "message",
      -                "raw_body",
      -                "content"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "not_found": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "states": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "email_state": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "email_state"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "messages",
      -          "not_found",
      -          "states"
      -        ],
      -        "type": "object"
      -      },
      -      "meta": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "request_id": {
      -            "example": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "request_id"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "data"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "meta": {
      +        "additionalProperties": {},
      +        "properties": {},
      +        "type": "object"
      +      },
      +      "ok": {
      +        "enum": [
      +          true
      +        ],
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "ok",
      +      "meta"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "data": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "messages": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "content": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "attachments": {
      +                          "description": "Attachment metadata only. Attachment contents are not parsed by this endpoint.",
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "content_id": {
      +                                "description": "Content ID for inline attachments, when present.",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "content_type": {
      +                                "example": "application/pdf",
      +                                "type": "string"
      +                              },
      +                              "disposition": {
      +                                "example": "attachment",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "download_url": {
      +                                "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      +                                "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      +                                "type": "string"
      +                              },
      +                              "filename": {
      +                                "example": "invoice.pdf",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "id": {
      +                                "description": "Attachment blob ID.",
      +                                "type": "string"
      +                              },
      +                              "size_bytes": {
      +                                "example": 12345,
      +                                "type": [
      +                                  "integer",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "id",
      +                              "filename",
      +                              "content_type",
      +                              "size_bytes",
      +                              "disposition",
      +                              "content_id"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "body": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "extracted_links": {
      +                              "items": {
      +                                "type": "string"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "format": {
      +                              "enum": [
      +                                "text",
      +                                "html"
      +                              ],
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "html": {
      +                              "description": "HTML body when requested. Returned as a JSON string and not as rendered content.",
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "is_truncated": {
      +                              "type": "boolean"
      +                            },
      +                            "quotes_stripped": {
      +                              "type": "boolean"
      +                            },
      +                            "signature_stripped": {
      +                              "type": "boolean"
      +                            },
      +                            "text": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "truncated_at_chars": {
      +                              "type": [
      +                                "integer",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "format",
      +                            "text",
      +                            "html",
      +                            "is_truncated",
      +                            "truncated_at_chars",
      +                            "signature_stripped",
      +                            "quotes_stripped",
      +                            "extracted_links"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "dates": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "received_at": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "sent_at": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "received_at",
      +                            "sent_at"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "headers": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "full": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "name": {
      +                                    "type": "string"
      +                                  },
      +                                  "value": {
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "name",
      +                                  "value"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": [
      +                                "array",
      +                                "null"
      +                              ]
      +                            },
      +                            "mode": {
      +                              "enum": [
      +                                "none",
      +                                "selected",
      +                                "full"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            "selected": {
      +                              "properties": {
      +                                "in_reply_to": {
      +                                  "type": [
      +                                    "string",
      +                                    "null"
      +                                  ]
      +                                },
      +                                "message_id": {
      +                                  "items": {
      +                                    "type": "string"
      +                                  },
      +                                  "type": "array"
      +                                },
      +                                "references": {
      +                                  "items": {
      +                                    "type": "string"
      +                                  },
      +                                  "type": "array"
      +                                },
      +                                "reply_to": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "email": {
      +                                        "example": "agent@example.com",
      +                                        "format": "email",
      +                                        "type": "string"
      +                                      },
      +                                      "name": {
      +                                        "example": "Support",
      +                                        "type": [
      +                                          "string",
      +                                          "null"
      +                                        ]
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "email",
      +                                      "name"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "type": "array"
      +                                }
      +                              },
      +                              "required": [
      +                                "message_id",
      +                                "in_reply_to",
      +                                "references",
      +                                "reply_to"
      +                              ],
      +                              "type": [
      +                                "object",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "mode",
      +                            "selected",
      +                            "full"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "id": {
      +                          "description": "Message ID",
      +                          "type": "string"
      +                        },
      +                        "participants": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "bcc": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "cc": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "from": {
      +                              "anyOf": [
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "email": {
      +                                      "example": "agent@example.com",
      +                                      "format": "email",
      +                                      "type": "string"
      +                                    },
      +                                    "name": {
      +                                      "example": "Support",
      +                                      "type": [
      +                                        "string",
      +                                        "null"
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "email",
      +                                    "name"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "type": "null"
      +                                }
      +                              ]
      +                            },
      +                            "reply_to": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "to": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            }
      +                          },
      +                          "required": [
      +                            "from",
      +                            "to",
      +                            "cc",
      +                            "bcc",
      +                            "reply_to"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "states": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "email_state": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "option_hash": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "email_state",
      +                            "option_hash"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "subject": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "thread_id": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "id",
      +                        "thread_id",
      +                        "subject",
      +                        "participants",
      +                        "dates",
      +                        "body",
      +                        "headers",
      +                        "attachments",
      +                        "states"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "message": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "attachments": {
      +                      "description": "Attachment metadata for this message. Each item includes a short-lived `download_url`; if it expires, fetch message metadata again.",
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "content_id": {
      +                            "description": "Content ID for inline attachments, when present.",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "content_type": {
      +                            "example": "application/pdf",
      +                            "type": "string"
      +                          },
      +                          "disposition": {
      +                            "example": "attachment",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "download_url": {
      +                            "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      +                            "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      +                            "type": "string"
      +                          },
      +                          "filename": {
      +                            "example": "invoice.pdf",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "id": {
      +                            "description": "Attachment blob ID.",
      +                            "type": "string"
      +                          },
      +                          "size_bytes": {
      +                            "example": 12345,
      +                            "type": [
      +                              "integer",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "id",
      +                          "filename",
      +                          "content_type",
      +                          "size_bytes",
      +                          "disposition",
      +                          "content_id"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "bcc": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "email": {
      +                            "example": "agent@example.com",
      +                            "format": "email",
      +                            "type": "string"
      +                          },
      +                          "name": {
      +                            "example": "Support",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "email",
      +                          "name"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "cc": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "email": {
      +                            "example": "agent@example.com",
      +                            "format": "email",
      +                            "type": "string"
      +                          },
      +                          "name": {
      +                            "example": "Support",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "email",
      +                          "name"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "flags": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "answered": {
      +                          "type": "boolean"
      +                        },
      +                        "draft": {
      +                          "type": "boolean"
      +                        },
      +                        "flagged": {
      +                          "type": "boolean"
      +                        },
      +                        "seen": {
      +                          "type": "boolean"
      +                        }
      +                      },
      +                      "required": [
      +                        "seen",
      +                        "flagged",
      +                        "draft",
      +                        "answered"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "folder_ids": {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "from": {
      +                      "anyOf": [
      +                        {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "email": {
      +                              "example": "agent@example.com",
      +                              "format": "email",
      +                              "type": "string"
      +                            },
      +                            "name": {
      +                              "example": "Support",
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "email",
      +                            "name"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "has_attachments": {
      +                      "type": "boolean"
      +                    },
      +                    "id": {
      +                      "description": "Message ID",
      +                      "type": "string"
      +                    },
      +                    "keywords": {
      +                      "description": "Active message keywords, including system flags and custom labels.",
      +                      "example": [
      +                        "$seen",
      +                        "$flagged",
      +                        "agent_triaged"
      +                      ],
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "preview": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "received_at": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "sent_at": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "size_bytes": {
      +                      "type": [
      +                        "integer",
      +                        "null"
      +                      ]
      +                    },
      +                    "subject": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "thread_id": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "to": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "email": {
      +                            "example": "agent@example.com",
      +                            "format": "email",
      +                            "type": "string"
      +                          },
      +                          "name": {
      +                            "example": "Support",
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "email",
      +                          "name"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    }
      +                  },
      +                  "required": [
      +                    "id",
      +                    "thread_id",
      +                    "folder_ids",
      +                    "subject",
      +                    "preview",
      +                    "from",
      +                    "to",
      +                    "cc",
      +                    "bcc",
      +                    "received_at",
      +                    "sent_at",
      +                    "size_bytes",
      +                    "has_attachments",
      +                    "keywords",
      +                    "flags"
      +                  ],
      +                  "type": "object"
      +                },
      +                "raw_body": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "body": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "html": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "is_truncated": {
      +                              "type": "boolean"
      +                            },
      +                            "text": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "truncated_at_chars": {
      +                              "type": [
      +                                "integer",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "text",
      +                            "html",
      +                            "is_truncated",
      +                            "truncated_at_chars"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "id": {
      +                          "description": "Message ID",
      +                          "type": "string"
      +                        },
      +                        "part": {
      +                          "enum": [
      +                            "text",
      +                            "html",
      +                            "both"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "states": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "email_state": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "email_state"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "thread_id": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "id",
      +                        "thread_id",
      +                        "part",
      +                        "body",
      +                        "states"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "message",
      +                "raw_body",
      +                "content"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "not_found": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "states": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "email_state": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "email_state"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "messages",
      +          "not_found",
      +          "states"
      +        ],
      +        "type": "object"
      +      },
      +      "meta": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "request_id": {
      +            "example": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "request_id"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "data"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed4 schema fields changedv1.0.8
    • addedOutput schema / $schema
      Added value: +"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / additionalProperties
      Removed value: -true
    • addedOutput schema / properties
      Added value: +{
      +  "result": {
      +    "allOf": [
      +      {
      +        "properties": {
      +          "meta": {
      +            "additionalProperties": {},
      +            "properties": {},
      +            "type": "object"
      +          },
      +          "ok": {
      +            "enum": [
      +              true
      +            ],
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "meta"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "properties": {
      +          "data": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "messages": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "content": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "attachments": {
      +                          "description": "Attachment metadata only. Attachment contents are not parsed by this endpoint.",
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "content_id": {
      +                                "description": "Content ID for inline attachments, when present.",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "content_type": {
      +                                "example": "application/pdf",
      +                                "type": "string"
      +                              },
      +                              "disposition": {
      +                                "example": "attachment",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "download_url": {
      +                                "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      +                                "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      +                                "type": "string"
      +                              },
      +                              "filename": {
      +                                "example": "invoice.pdf",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "id": {
      +                                "description": "Attachment blob ID.",
      +                                "type": "string"
      +                              },
      +                              "size_bytes": {
      +                                "example": 12345,
      +                                "type": [
      +                                  "integer",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "id",
      +                              "filename",
      +                              "content_type",
      +                              "size_bytes",
      +                              "disposition",
      +                              "content_id"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "body": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "extracted_links": {
      +                              "items": {
      +                                "type": "string"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "format": {
      +                              "enum": [
      +                                "text",
      +                                "html"
      +                              ],
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "html": {
      +                              "description": "HTML body when requested. Returned as a JSON string and not as rendered content.",
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "is_truncated": {
      +                              "type": "boolean"
      +                            },
      +                            "quotes_stripped": {
      +                              "type": "boolean"
      +                            },
      +                            "signature_stripped": {
      +                              "type": "boolean"
      +                            },
      +                            "text": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "truncated_at_chars": {
      +                              "type": [
      +                                "integer",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "format",
      +                            "text",
      +                            "html",
      +                            "is_truncated",
      +                            "truncated_at_chars",
      +                            "signature_stripped",
      +                            "quotes_stripped",
      +                            "extracted_links"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "dates": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "received_at": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "sent_at": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "received_at",
      +                            "sent_at"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "headers": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "full": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "name": {
      +                                    "type": "string"
      +                                  },
      +                                  "value": {
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "name",
      +                                  "value"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": [
      +                                "array",
      +                                "null"
      +                              ]
      +                            },
      +                            "mode": {
      +                              "enum": [
      +                                "none",
      +                                "selected",
      +                                "full"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            "selected": {
      +                              "properties": {
      +                                "in_reply_to": {
      +                                  "type": [
      +                                    "string",
      +                                    "null"
      +                                  ]
      +                                },
      +                                "message_id": {
      +                                  "items": {
      +                                    "type": "string"
      +                                  },
      +                                  "type": "array"
      +                                },
      +                                "references": {
      +                                  "items": {
      +                                    "type": "string"
      +                                  },
      +                                  "type": "array"
      +                                },
      +                                "reply_to": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "email": {
      +                                        "example": "agent@example.com",
      +                                        "format": "email",
      +                                        "type": "string"
      +                                      },
      +                                      "name": {
      +                                        "example": "Support",
      +                                        "type": [
      +                                          "string",
      +                                          "null"
      +                                        ]
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "email",
      +                                      "name"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "type": "array"
      +                                }
      +                              },
      +                              "required": [
      +                                "message_id",
      +                                "in_reply_to",
      +                                "references",
      +                                "reply_to"
      +                              ],
      +                              "type": [
      +                                "object",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "mode",
      +                            "selected",
      +                            "full"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "id": {
      +                          "description": "Message ID",
      +                          "type": "string"
      +                        },
      +                        "participants": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "bcc": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "cc": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "from": {
      +                              "allOf": [
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "email": {
      +                                      "example": "agent@example.com",
      +                                      "format": "email",
      +                                      "type": "string"
      +                                    },
      +                                    "name": {
      +                                      "example": "Support",
      +                                      "type": [
      +                                        "string",
      +                                        "null"
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "email",
      +                                    "name"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "type": [
      +                                    "object",
      +                                    "null"
      +                                  ]
      +                                }
      +                              ]
      +                            },
      +                            "reply_to": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "to": {
      +                              "items": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "email": {
      +                                    "example": "agent@example.com",
      +                                    "format": "email",
      +                                    "type": "string"
      +                                  },
      +                                  "name": {
      +                                    "example": "Support",
      +                                    "type": [
      +                                      "string",
      +                                      "null"
      +                                    ]
      +                                  }
      +                                },
      +                                "required": [
      +                                  "email",
      +                                  "name"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "type": "array"
      +                            }
      +                          },
      +                          "required": [
      +                            "from",
      +                            "to",
      +                            "cc",
      +                            "bcc",
      +                            "reply_to"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "states": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "email_state": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "option_hash": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "email_state",
      +                            "option_hash"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "subject": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "thread_id": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "id",
      +                        "thread_id",
      +                        "subject",
      +                        "participants",
      +                        "dates",
      +                        "body",
      +                        "headers",
      +                        "attachments",
      +                        "states"
      +                      ],
      +                      "type": [
      +                        "object",
      +                        "null"
      +                      ]
      +                    },
      +                    "message": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "attachments": {
      +                          "description": "Attachment metadata for this message. Each item includes a short-lived `download_url`; if it expires, fetch message metadata again.",
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "content_id": {
      +                                "description": "Content ID for inline attachments, when present.",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "content_type": {
      +                                "example": "application/pdf",
      +                                "type": "string"
      +                              },
      +                              "disposition": {
      +                                "example": "attachment",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "download_url": {
      +                                "description": "Short-lived URL for this exact attachment. Fetch it promptly; if it expires, call the message or attachment metadata endpoint again to receive a fresh URL.",
      +                                "example": "https://app.sendmux.ai/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...",
      +                                "type": "string"
      +                              },
      +                              "filename": {
      +                                "example": "invoice.pdf",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              },
      +                              "id": {
      +                                "description": "Attachment blob ID.",
      +                                "type": "string"
      +                              },
      +                              "size_bytes": {
      +                                "example": 12345,
      +                                "type": [
      +                                  "integer",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "id",
      +                              "filename",
      +                              "content_type",
      +                              "size_bytes",
      +                              "disposition",
      +                              "content_id"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "bcc": {
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "email": {
      +                                "example": "agent@example.com",
      +                                "format": "email",
      +                                "type": "string"
      +                              },
      +                              "name": {
      +                                "example": "Support",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "email",
      +                              "name"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "cc": {
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "email": {
      +                                "example": "agent@example.com",
      +                                "format": "email",
      +                                "type": "string"
      +                              },
      +                              "name": {
      +                                "example": "Support",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "email",
      +                              "name"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "flags": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "answered": {
      +                              "type": "boolean"
      +                            },
      +                            "draft": {
      +                              "type": "boolean"
      +                            },
      +                            "flagged": {
      +                              "type": "boolean"
      +                            },
      +                            "seen": {
      +                              "type": "boolean"
      +                            }
      +                          },
      +                          "required": [
      +                            "seen",
      +                            "flagged",
      +                            "draft",
      +                            "answered"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "folder_ids": {
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "from": {
      +                          "allOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "email": {
      +                                  "example": "agent@example.com",
      +                                  "format": "email",
      +                                  "type": "string"
      +                                },
      +                                "name": {
      +                                  "example": "Support",
      +                                  "type": [
      +                                    "string",
      +                                    "null"
      +                                  ]
      +                                }
      +                              },
      +                              "required": [
      +                                "email",
      +                                "name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "type": [
      +                                "object",
      +                                "null"
      +                              ]
      +                            }
      +                          ]
      +                        },
      +                        "has_attachments": {
      +                          "type": "boolean"
      +                        },
      +                        "id": {
      +                          "description": "Message ID",
      +                          "type": "string"
      +                        },
      +                        "keywords": {
      +                          "description": "Active message keywords, including system flags and custom labels.",
      +                          "example": [
      +                            "$seen",
      +                            "$flagged",
      +                            "agent_triaged"
      +                          ],
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "preview": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "received_at": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "sent_at": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "size_bytes": {
      +                          "type": [
      +                            "integer",
      +                            "null"
      +                          ]
      +                        },
      +                        "subject": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "thread_id": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        },
      +                        "to": {
      +                          "items": {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "email": {
      +                                "example": "agent@example.com",
      +                                "format": "email",
      +                                "type": "string"
      +                              },
      +                              "name": {
      +                                "example": "Support",
      +                                "type": [
      +                                  "string",
      +                                  "null"
      +                                ]
      +                              }
      +                            },
      +                            "required": [
      +                              "email",
      +                              "name"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          "type": "array"
      +                        }
      +                      },
      +                      "required": [
      +                        "id",
      +                        "thread_id",
      +                        "folder_ids",
      +                        "subject",
      +                        "preview",
      +                        "from",
      +                        "to",
      +                        "cc",
      +                        "bcc",
      +                        "received_at",
      +                        "sent_at",
      +                        "size_bytes",
      +                        "has_attachments",
      +                        "keywords",
      +                        "flags"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "raw_body": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "body": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "html": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "is_truncated": {
      +                              "type": "boolean"
      +                            },
      +                            "text": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "truncated_at_chars": {
      +                              "type": [
      +                                "integer",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "text",
      +                            "html",
      +                            "is_truncated",
      +                            "truncated_at_chars"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "id": {
      +                          "description": "Message ID",
      +                          "type": "string"
      +                        },
      +                        "part": {
      +                          "enum": [
      +                            "text",
      +                            "html",
      +                            "both"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "states": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "email_state": {
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            }
      +                          },
      +                          "required": [
      +                            "email_state"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "thread_id": {
      +                          "type": [
      +                            "string",
      +                            "null"
      +                          ]
      +                        }
      +                      },
      +                      "required": [
      +                        "id",
      +                        "thread_id",
      +                        "part",
      +                        "body",
      +                        "states"
      +                      ],
      +                      "type": [
      +                        "object",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "required": [
      +                    "message",
      +                    "raw_body",
      +                    "content"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "not_found": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "states": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "email_state": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "required": [
      +                  "email_state"
      +                ],
      +                "type": "object"
      +              }
      +            },
      +            "required": [
      +              "messages",
      +              "not_found",
      +              "states"
      +            ],
      +            "type": "object"
      +          },
      +          "meta": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "request_id": {
      +                "example": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "request_id"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "data"
      +        ],
      +        "type": "object"
      +      }
      +    ],
      +    "unevaluatedProperties": {
      +      "not": {}
      +    },
      +    "x-fastmcp-top-level-schema": "MailboxBatchGetResultResponse"
      +  }
      +}
    • addedOutput schema / required
      Added value: +[
      +  "result"
      +]
  3. First observedv1.0.0

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, so the safety profile is covered. The description adds no additional behavioral context such as response ordering, error handling, or limits beyond what the schema already states. It doesn't contradict annotations, but it also doesn't enrich them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences with zero fluff. It front-loads the primary usage condition and then explains the benefit. Every word earns its place, and it is highly efficient for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (11 parameters) and that an output schema exists, the description is adequate but minimal. It covers when to use it and the advantage over single-message calls. It does not mention response ordering or partial failure behavior, but these are not essential for tool selection given the output schema and annotations. It is complete enough for an agent to decide correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so all 11 parameters are already documented in the input schema. The description adds no parameter-specific meaning, only usage context. Since the schema carries the full semantic burden, a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool fetches multiple messages by IDs and distinguishes it from single-message retrieval. It uses a specific verb ('get') and resource ('messages'), and explicitly contrasts with repeated single-message calls, making its purpose unambiguous among siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit when-to-use scenarios ('user supplies several message IDs' or 'prior search returns multiple candidates') and notes it avoids repeated single-message calls. It doesn't name the exact sibling (mailbox_get_message) but the implication is clear. It could be more explicit about when not to use it, but the guidance is sufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.