Lien de téléchargement d'un document

Tool nameget_document_download_link
Read-only

Returns a direct, read-only download link to a document, valid for a few minutes.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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

Parameters

NameTypePresenceDescription
documentIdintegerrequiredIdentifiant 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
NameTypePresenceDescription
documentIdintegerIdentifiant du document.
namestringnullableNom du fichier.
urlstringLien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt.
expiresAtstring (date-time)Fin de validité du lien (UTC).

MCP annotations

AnnotationValueMeaning
titleLien de téléchargement d'un documentHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe 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
  }
}