DELETE /api/v1/sequences/{sequenceId}/versions/{versionId}
Abandonne un brouillon — la porte de sortie de la règle du brouillon unique.
| Condition | Réponse |
|---|---|
| un brouillon, qui n'est pas la seule version | 200 |
| pas un brouillon | 400 — les versions publiées et archivées sont conservées pour toujours |
| la seule version de la séquence | 400 — elle porte le déclencheur ; supprimez plutôt la séquence |
Autorisation
| Rôle dans l'organisation | Cet endpoint |
|---|---|
OWNER | Autorisé |
ADMIN | Autorisé |
MEMBER | Refusé — 403 |
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
sequenceId | string | Obligatoire. La séquence |
versionId | string | Obligatoire. Le brouillon à abandonner — une version publiée est refusée |
Exemple
bash
curl -X DELETE -H "x-api-key: $AGENTMAIL_API_KEY" \
"https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions/$VERSION_ID"Réponse
200 OK— l'appel a réussi.401 Unauthorized— clé absente ou invalide, ou son propriétaire a quitté l'organisation.403 Forbidden— le propriétaire de la clé estmemberde l'organisation, pasadmin.404 Not Found— aucune ressource de ce type, ou elle appartient à une autre organisation. L'API ne confirme jamais l'existence d'un id à un appelant qui n'y a pas droit.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
success | boolean | Indique si l'opération a réussi |
data.id | string | Identifiant de ce qui a été supprimé |
Exemple de réponse
json
{
"success": true,
"data": {
"id": "4d19c0a2"
}
}