Modifier un brouillon de courriel
update_email_draftUpdates a draft created by the user: recipients, subject, message, type, sending mailbox.
Description
Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).
Required access
- At least one of these permissions:
mail-inbox.list.viewormail-outbox.list.viewormail-sendbox.list.viewormail-trashbox.list.vieworall-mail.list.viewordossier-detail.tab.mailbox - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
emailId | integer | required | Brouillon (champ id de create_email_draft). |
to | string | optional | Destinataires, qui remplacent les actuels. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner. |
cc | string | optional | Copie, qui remplace l'actuelle ; chaîne vide pour la vider. |
bcc | string | optional | Copie cachée, qui remplace l'actuelle ; chaîne vide pour la vider. |
subject | string | optional | Nouvel objet. |
body | string | optional | Nouveau message, en texte simple. |
type | string | optional | Type de courriel, par son nom (availableTypes du brouillon). |
fromGeneralMailbox | boolean | optional | Vrai : boîte générale de la société ; faux : boîte de l'utilisateur. |
Result
The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.
Result fields
| Name | Type | Presence | Description |
|---|---|---|---|
id | integer | Identifiant du brouillon (emailId des autres outils). | |
from | string | nullable | Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société. |
to | string | nullable | Destinataires. |
cc | string | nullable | Destinataires en copie. |
bcc | string | nullable | Destinataires en copie cachée. |
subject | string | nullable | Objet. |
type | string | nullable | Type de courriel (obligatoire pour l'envoi). |
dossierId | integer | nullable | Dossier lié. |
body | string | nullable | Corps du courriel en texte (signature et message cité compris), tronqué s'il est long. |
attachments | object[] | Pièces jointes. | |
attachments[].documentId | integer | Identifiant du document (à passer à read_document ou get_document_download_link). | |
attachments[].name | string | nullable | Nom du fichier. |
attachments[].contentType | string | nullable | Type MIME. |
attachments[].sizeBytes | integer | Taille en octets. | |
attachments[].isInline | boolean | Vrai pour une image intégrée au corps (logo, signature). | |
sendsDocument | string | nullable | Devis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide. |
availableTypes | string[] | Types de courriel proposés (paramètre type), hors commandes fournisseur. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Modifier un brouillon de courriel | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | yes | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "update_email_draft",
"title": "Modifier un brouillon de courriel",
"description": "Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).",
"inputSchema": {
"type": "object",
"properties": {
"emailId": {
"description": "Brouillon (champ id de create_email_draft).",
"type": "integer"
},
"to": {
"description": "Destinataires, qui remplacent les actuels. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.",
"type": [
"string",
"null"
],
"default": null
},
"cc": {
"description": "Copie, qui remplace l'actuelle ; chaîne vide pour la vider.",
"type": [
"string",
"null"
],
"default": null
},
"bcc": {
"description": "Copie cachée, qui remplace l'actuelle ; chaîne vide pour la vider.",
"type": [
"string",
"null"
],
"default": null
},
"subject": {
"description": "Nouvel objet.",
"type": [
"string",
"null"
],
"default": null
},
"body": {
"description": "Nouveau message, en texte simple.",
"type": [
"string",
"null"
],
"default": null
},
"type": {
"description": "Type de courriel, par son nom (availableTypes du brouillon).",
"type": [
"string",
"null"
],
"default": null
},
"fromGeneralMailbox": {
"description": "Vrai : boîte générale de la société ; faux : boîte de l'utilisateur.",
"type": [
"boolean",
"null"
],
"default": null
}
},
"required": [
"emailId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant du brouillon (emailId des autres outils).",
"type": "integer"
},
"from": {
"description": "Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.",
"type": [
"string",
"null"
]
},
"to": {
"description": "Destinataires.",
"type": [
"string",
"null"
]
},
"cc": {
"description": "Destinataires en copie.",
"type": [
"string",
"null"
]
},
"bcc": {
"description": "Destinataires en copie cachée.",
"type": [
"string",
"null"
]
},
"subject": {
"description": "Objet.",
"type": [
"string",
"null"
]
},
"type": {
"description": "Type de courriel (obligatoire pour l'envoi).",
"type": [
"string",
"null"
]
},
"dossierId": {
"description": "Dossier lié.",
"type": [
"integer",
"null"
]
},
"body": {
"description": "Corps du courriel en texte (signature et message cité compris), tronqué s'il est long.",
"type": [
"string",
"null"
]
},
"attachments": {
"description": "Pièces jointes.",
"type": "array",
"items": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document (à passer à read_document ou get_document_download_link).",
"type": "integer"
},
"name": {
"description": "Nom du fichier.",
"type": [
"string",
"null"
]
},
"contentType": {
"description": "Type MIME.",
"type": [
"string",
"null"
]
},
"sizeBytes": {
"description": "Taille en octets.",
"type": "integer"
},
"isInline": {
"description": "Vrai pour une image intégrée au corps (logo, signature).",
"type": "boolean"
}
},
"required": [
"documentId",
"sizeBytes",
"isInline"
]
}
},
"sendsDocument": {
"description": "Devis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.",
"type": [
"string",
"null"
]
},
"availableTypes": {
"description": "Types de courriel proposés (paramètre type), hors commandes fournisseur.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
]
},
"annotations": {
"title": "Modifier un brouillon de courriel",
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": false
}
}