> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# Pièces jointes

> Téléchargez des fichiers pour les messages Connect360 et lisez les pièces jointes privées.

Utilisez des pièces jointes lorsqu'un message de discussion nécessite une image, un PDF, un reçu ou un autre fichier.

## Télécharger des pièces jointes

```text theme={null}
POST /api/v1/connect/attachments
```

La demande doit être `multipart/form-data`.

## Exemple

```bash theme={null}
curl "https://api.plato.ae/api/v1/connect/attachments" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -F "files=@receipt.pdf"
```

Téléchargez jusqu'à 5 fichiers par demande.

Chaque fichier peut atteindre 25 Mo.

## Réponse

```json theme={null}
{
  "files": [
    {
      "id": "file_123",
      "name": "receipt.pdf",
      "s3Key": "workspace/path/receipt.pdf",
      "type": "application/pdf",
      "url": "https://app.plato.ae/api/assets/workspace%2Fpath%2Freceipt.pdf"
    }
  ]
}
```

Conservez les valeurs `id` et `s3Key` renvoyées afin d'associer la ressource téléchargée au flux Connect360 concerné.

## Télécharger une pièce jointe privée

```text theme={null}
GET /api/v1/connect/assets/[...key]
```

Utilisez le `s3Key` renvoyé par la réponse de téléchargement.

```bash theme={null}
curl "https://api.plato.ae/api/v1/connect/assets/workspace/path/receipt.pdf" \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  --output receipt.pdf
```

La clé API doit appartenir au même espace de travail que le fichier.

## Autorisations

Le téléchargement nécessite :

```text theme={null}
connect360:conversation:engage
```

Le téléchargement nécessite soit :

```text theme={null}
connect360:conversation:read
```

ou:

```text theme={null}
connect360:conversation:engage
```

## Remarques

* Les noms de fichiers sont normalisés avant le téléchargement.
* Les fichiers téléchargés sont stockés dans un dossier Connect360 dans Drive.
* Le URL renvoyé peut pointer vers une route d’actifs privés. Conservez la clé API sur le serveur lors de la récupération de fichiers privés.