Relier deux étapes

POST /api/v1/sequences/{sequenceId}/versions/{versionId}/edges Les deux extrémités doivent être des nœuds de la version indiquée dans l'URL : une extrémité prise dans une autre version répond 404. Une liaison entre deux versions attacherait votre brouillon au parcours que les contacts suivent en ce moment même.

Autorisation

Rôle dans l'organisationCet endpoint
OWNERAutorisé
ADMINAutorisé
MEMBERRefusé — 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.

Corps de la requête

ChampTypeObligatoireDescription
fromNodeIdstringouiÉtape que quitte la liaison — doit appartenir à cette version
toNodeIdstringouiÉtape qu'elle atteint — même règle

Corps de la requête

ChampTypeObligatoireDescription
fromNodeIdstringouiUn nœud de cette version
toNodeIdstringouiUn nœud de cette version
branchstringnondefault (par défaut), yes ou no

Exemple

bash
curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fromNodeId": "$FROM", "toNodeId": "$TO"}' \
  "https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions/$VERSION_ID/edges"

Réponse

  • 201 Created — la ressource créée.
  • 400 Bad Request — la validation a échoué ; details porte les problèmes champ par champ.
  • 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 la liaison.
ChampTypeDescription
successbooleanIndique si l'opération a réussi
data.idstringIdentifiant de la liaison
data.fromNodeIdstringÉtape qu'elle quitte
data.toNodeIdstringÉtape qu'elle atteint

Exemple de réponse

json
{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "fromNodeId": "d77b0913",
    "toNodeId": "e08c1a24"
  }
}

Voir aussi