Editar un paso

Editar un paso

PATCH /api/v1/sequences/{sequenceId}/versions/{versionId}/nodes/{nodeId} Edita un nodo de un borrador: subject, content, templateId, waitHours, sendTimeMinutes, tagId o webhookUrl. Envía solo los campos de una familia: mezclar un asunto y un waitHours en la misma llamada responde 400, y lo mismo un cuerpo que no lleva nada.

Autorización

Rol en la organización	Este endpoint
`OWNER`	Permitido
`ADMIN`	Permitido
`MEMBER`	Rechazado — `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ámetro	Tipo	Descripción
`nodeId`	string	Obligatorio. El paso que se cambia

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
`subject` / `content`	string	no	En un paso `send_email`
`preheader`	string	no	En un paso `send_email`. Hasta 200 caracteres, el texto de vista previa que se muestra tras el asunto. Misma familia que `subject` y `content`, así que puede enviarse solo o con ellos
`waitHours`	number	no	En un paso `wait`
`sendTimeMinutes`	number \| null	no	En un paso de una serie: la hora local del día, en minutos desde medianoche (`540` = 09:00). `null` la elimina, y el paso sale entonces en cuanto ha transcurrido la espera anterior. Es su propia familia: envíalo solo, nunca junto a un asunto o un contenido
`tagId`	string	no	En un paso `add_tag` / `remove_tag`
`webhookUrl`	string	no	En un paso `webhook`

Ejemplo

bash

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

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

Campo	Tipo	Descripción
`success`	boolean	Indica si la operación tuvo éxito
`data.id`	string	Identificador del paso
`data.versionId`	string	La versión, en borrador o publicada, a la que pertenece
`data.type`	string	`send_email`, `wait`, `add_tag`, `remove_tag`, `end_sequence`, `webhook`
`data.subject` / `content`	string \	null
`data.preheader`	string	Texto de vista previa del paso; cadena vacía en un paso que no envía nada
`data.templateId`	string \	null
`data.waitHours`	number \	null
`data.tagId`	string \	null
`data.webhookUrl`	string \	null
`data.createdAt` / `updatedAt`	string	Fechas ISO

Ejemplo de respuesta

json

{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "versionId": "c41a7e55",
    "type": "send_email",
    "subject` / `content": "value",
    "templateId": "5a44b901",
    "waitHours": 24,
    "tagId": "7c2ef4b1",
    "webhookUrl": "https://example.com/hooks/agentsmail",
    "createdAt` / `updatedAt": "value"
  }
}