Conectar dos pasos

POST /api/v1/sequences/{sequenceId}/versions/{versionId}/edges Los dos extremos deben ser nodos de la versión de la URL: un extremo tomado de otra versión responde 404. Una conexión entre dos versiones ataría tu borrador al recorrido que los contactos están haciendo en este momento.

Autorización

Rol en la organizaciónEste endpoint
OWNERPermitido
ADMINPermitido
MEMBERRechazado — 403
Una clave lleva el rol que su creador tiene en esta organización, nunca un rol en AgentsMail en sí. Consulta Claves de API.

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
fromNodeIdstringsíPaso del que sale la conexión; debe pertenecer a esta versión
toNodeIdstringsíPaso al que llega; misma regla

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
fromNodeIdstringsíUn nodo de esta versión
toNodeIdstringsíUn nodo de esta versión
branchstringnodefault (por defecto), yes o no

Ejemplo

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"

Respuesta

  • 201 Created: el recurso creado.
  • 400 Bad Request: la validación falló; details lleva los problemas campo por campo.
  • 401 Unauthorized: clave ausente o no válida, o su propietario dejó la organización.
  • 403 Forbidden: el propietario de la clave es member de la organización, no admin.
  • 404 Not Found: no existe ese recurso, o pertenece a otra organización. La API nunca confirma que un id existe a quien no tiene derecho sobre él.
  • 429 Too Many Requests: más de 120 solicitudes en un minuto para esta clave.

Campos de la respuesta

201 con la conexión.
CampoTipoDescripción
successbooleanIndica si la operación tuvo éxito
data.idstringIdentificador de la conexión
data.fromNodeIdstringPaso del que sale
data.toNodeIdstringPaso al que llega

Ejemplo de respuesta

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

Relacionado