Lien de téléchargement d'un document
Tool name
get_document_download_linkRead-only
Returns a direct, read-only download link to a document, valid for a few minutes.
Description
Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.
Required access
- At least one of these permissions:
dossier-detail.tab.documentormail-inbox.list.viewormail-outbox.list.viewormail-sendbox.list.viewormail-trashbox.list.vieworall-mail.list.viewordossier-detail.tab.mailbox - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
documentId | integer | required | Identifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email). |
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 |
|---|---|---|---|
documentId | integer | Identifiant du document. | |
name | string | nullable | Nom du fichier. |
url | string | Lien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt. | |
expiresAt | string (date-time) | Fin de validité du lien (UTC). |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Lien de téléchargement d'un document | Human-readable name shown by the MCP client. |
readOnlyHint | yes | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | no | 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": "get_document_download_link",
"title": "Lien de téléchargement d'un document",
"description": "Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.",
"inputSchema": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email).",
"type": "integer"
}
},
"required": [
"documentId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document.",
"type": "integer"
},
"name": {
"description": "Nom du fichier.",
"type": [
"string",
"null"
]
},
"url": {
"description": "Lien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt.",
"type": "string"
},
"expiresAt": {
"description": "Fin de validité du lien (UTC).",
"type": "string",
"format": "date-time"
}
},
"required": [
"documentId",
"url",
"expiresAt"
]
},
"annotations": {
"title": "Lien de téléchargement d'un document",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": true
}
}