Cambiar el disparador de un borrador

PATCH /api/v1/sequences/{sequenceId}/versions/{versionId} Cambia el disparador de un borrador: la lista o la etiqueta que inscribe contactos. Envía los dos campos: el disparador se reemplaza, nunca se fusiona.

Condición	Respuesta
un borrador, ambos campos válidos	`200`: la versión vuelve con su nuevo disparador
campo ausente, `triggerType` desconocido, id mal formado	`400`: `details` nombra el campo
objetivo del disparador de otra organización	`404`: como una etiqueta que no existe
`triggerType: "fixed_date"`	`400`: las series de fecha fija se configuran en la app, no aquí
la versión no es un borrador	`400`: las versiones publicadas son instantáneas; abre un borrador

Nada se inscribe con el nuevo disparador hasta que publicas el borrador. Los contactos que ya recorren la versión publicada siguen entrando por el antiguo, y terminan el recorrido en el que entraron.

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.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
`triggerType`	string	sí	`list_joined` o `tag_added`. `fixed_date` se rechaza aquí: una serie guiada por fecha también lleva su audiencia, su fecha de inicio y la programación de cada paso, y esta solicitud no puede expresarlos.
`triggerTargetId`	string	sí	El id de la lista para `list_joined`, el id de la etiqueta para `tag_added`

Ejemplo

bash

curl -X PATCH -H "x-api-key: $AGENTMAIL_API_KEY" -H "content-type: application/json" \
  -d '{"triggerType":"tag_added","triggerTargetId":"'$TAG_ID'"}' \
  "https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions/$VERSION_ID"

Respuesta

200 OK: la llamada tuvo éxito.
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 único de la versión
`data.sequenceId`	string	La secuencia a la que pertenece
`data.version`	number	Su número de orden, empezando por 1
`data.status`	string	`draft` o `published`
`data.publishedAt`	string	null
`data.triggerType`	string	`list_joined` o `tag_added`
`data.triggerTargetId`	string	La lista o etiqueta que inscribe contactos
`data.createdAt`	string	Fecha ISO de creación
`data.updatedAt`	string	Fecha ISO del último cambio

Ejemplo de respuesta

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": "2026-08-23T10:22:05.000Z",
    "updatedAt": "2026-08-23T10:22:05.000Z"
  }
}