Volver a una versión anterior

POST /api/v1/sequences/{sequenceId}/versions/{versionId}/rollback Vuelve a una versión anterior copiándola hacia delante: se crea una versión nueva, publicada de inmediato. Responde 201, y el número de versión que obtienes es uno nuevo, nunca el antiguo. Nunca se reescribe nada en el sitio, así que un contacto fijado a una versión antigua la sigue encontrando sin cambios cuando se reactiva. Un borrador abierto bloquea la reversión: 400, descártalo primero.

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
`sequenceId`	string	Obligatorio. La secuencia
`versionId`	string	Obligatorio. La versión cuyo contenido se vuelve a publicar

Ejemplo

bash

curl -X POST -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID/versions/$VERSION_ID/rollback"

Respuesta

201 Created: el recurso creado.
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 versión nueva: revertir nunca resucita la antigua, vuelve a publicar su contenido con un nuevo número de orden.

Campo	Tipo	Descripción
`success`	boolean	Indica si la operación tuvo éxito
`data.id`	string	Identificador 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` / `updatedAt`	string	Fechas ISO

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` / `updatedAt": "value"
  }
}