Supprimer un média

DELETE /api/v1/media Retire un média de la médiathèque. Un média n'a pas d'identifiant propre — son identité est le path renvoyé par Téléverser un média et Lister les médias, c'est pourquoi il voyage ici comme paramètre de requête plutôt que comme segment du chemin.

Autorisation

Rôle dans l'organisation	Cet endpoint
`OWNER`	Autorisé
`ADMIN`	Autorisé
`MEMBER`	Refusé — `403`

Une clé porte le rôle que son créateur détient dans cette organisation — jamais un rôle sur AgentsMail lui-même. Voir Clés d'API.

Paramètres de requête

Paramètre	Type	Description
`path`	string	Obligatoire. Le `path` du média, tel que renvoyé par le téléversement ou la liste

Exemple

bash

curl -X DELETE -H "x-api-key: $AGENTMAIL_API_KEY" \
  --data-urlencode "path=organizations/7c2e…/media/newsletter/logo-1703123456789.jpg" \
  -G "https://www.agentsmail.io/api/v1/media"

Réponse

200 OK — l'appel a réussi.
400 Bad Request — le paramètre de requête path est absent.
401 Unauthorized — clé absente ou invalide, ou son propriétaire a quitté l'organisation.
403 Forbidden — l'appelant est bien membre, mais son rôle est insuffisant.
404 Not Found — le chemin n'appartient pas à l'organisation de la clé. L'API ne confirme jamais qu'un chemin existe à un appelant qui n'y a pas droit.

Champs de la réponse

Champ	Type	Description
`success`	boolean	Indique si l'opération a réussi
`data.deleted`	boolean	`true` quand le média a disparu

Exemple de réponse

json

{"success": true, "data": {"deleted": true}}

Remarques

La suppression est définitive — il n'y a ni corbeille ni récupération.
Un média encore référencé dans le HTML d'un modèle ou d'une campagne est supprimé quand même : la référence n'est pas vérifiée, et la balise <img> sera simplement cassée lors des ouvertures suivantes.