Ouvrir une version brouillon

POST /api/v1/sequences/{sequenceId}/versions Ouvre un brouillon, copie de la version publiée — nœuds, contenus, liaisons et déclencheur compris. Répond 201. Le déclencheur est copié tel quel : un brouillon ouvert ainsi fonctionne sur le déclencheur de la version qu'il copie, jusqu'à ce que vous le changiez avec Changer le déclencheur d'un brouillon.

Condition	Réponse
aucun brouillon ouvert	`201` — vous obtenez un nouveau brouillon à modifier
un brouillon est déjà ouvert	`400` — un brouillon à la fois ; publiez-le ou abandonnez-le

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 chemin

Paramètre	Type	Description
`sequenceId`	string	Obligatoire. La séquence sur laquelle ouvrir un brouillon

Exemple

bash

curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions"

Réponse

201 Created — la ressource créée.
401 Unauthorized — clé absente ou invalide, ou son propriétaire a quitté l'organisation.
403 Forbidden — le propriétaire de la clé est member de l'organisation, pas admin.
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

201 avec le nouveau brouillon — une copie de la version publiée, déclencheur compris.

Champ	Type	Description
`success`	boolean	Indique si l'opération a réussi
`data.id`	string	Identifiant de la version
`data.sequenceId`	string	La séquence à laquelle elle appartient
`data.version`	number	Son rang, à partir de 1
`data.status`	string	`draft` ou `published`
`data.publishedAt`	string \	null
`data.triggerType`	string	`list_joined` ou `tag_added`
`data.triggerTargetId`	string	La liste ou le tag qui inscrit les contacts
`data.createdAt` / `updatedAt`	string	Dates ISO

Exemple de réponse

json

{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "sequenceId": "9b3f2d10",
    "version": 1,
    "status": "subscribed",
    "publishedAt": "2026-08-23T10:22:05.000Z",
    "triggerType": "list_joined",
    "triggerTargetId": "0b7c51e8",
    "createdAt` / `updatedAt": "value"
  }
}