attach_files · Escouade Mail documentation

Attach files to a draft.

Returns an upload link to attach files to a draft (created with requires_approval: true). The human opens it in their browser and picks the files; an agent that holds the file posts it itself (multipart/form-data, field file). The attachments leave with the message, once it is approved. Only within a conversation (the correspondent has written in the thread themselves) or to an address of the space: a first message leaves without attachments. 10 MB and 10 attachments per message; the link is valid for one hour; 60 links per space per day.

Access

Key: an Escouade Mail key with send.
Space: a verified space.
Changes nothing: no, it acts.
Safe to replay: use an idempotency_key where the tool offers one.

Parameters

Parameter	Type	Required	Description
`message_id`	string	yes	The draft (msg_…).

Call it

Terminal

curl -s https://api.subagent.fr/v1/attach_files \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"message_id": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/attach_files.