Mover un paso

POST /api/v1/sequences/{sequenceId}/versions/{versionId}/nodes/{nodeId}/move Mueve el nodo un puesto hacia arriba (up) o hacia abajo (down). Reordenar un grafo es reconectarlo: se reescriben tres conexiones en una sola transacción, así que el recorrido nunca queda cortado por la mitad.

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.

Parámetros de ruta

ParámetroTipoDescripción
nodeIdstringObligatorio. El paso que se mueve

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
directionstringsíup o down: un puesto cada vez

Cuerpo de la solicitud

CampoTipoObligatorioDescripción
directionstringsíup o down

Ejemplo

bash
curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction": "up"}' \
  "https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions/$VERSION_ID/nodes/$NODE_ID/move"

Respuesta

  • 200 OK: la llamada tuvo éxito.
  • 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

CampoTipoDescripción
successbooleanIndica si la operación tuvo éxito
data.idstringIdentificador de lo que se eliminó

Ejemplo de respuesta

json
{
  "success": true,
  "data": {
    "id": "4d19c0a2"
  }
}

Relacionado