DELETE /api/v1/sequences/{sequenceId}
Elimina una secuencia con todas las versiones y todas las inscripciones asociadas. Los contactos que están recorriendo el recorrido se detienen donde están; los pasos a los que no habían llegado nunca se envían.
Autorización
| Rol en la organización | Este endpoint |
|---|---|
OWNER | Permitido |
ADMIN | Permitido |
MEMBER | Rechazado — 403 |
Parámetros de ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
sequenceId | string | Obligatorio. La secuencia que se elimina |
Ejemplo
bash
curl -X DELETE -H "x-api-key: $AGENTMAIL_API_KEY" \
"https://www.agentsmail.io/api/v1/sequences/$SEQUENCE_ID"Respuesta
200 OK: la secuencia ya no existe.401 Unauthorized: clave ausente o no válida.403 Forbidden: el propietario de la clave esmemberde la organización, noadmin.404 Not Found: no existe esa secuencia, o pertenece a otra organización. La API nunca confirma que un id existe a quien no tiene derecho sobre él.
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la operación tuvo éxito |
data.id | string | El ID de la secuencia eliminada |
Ejemplo de respuesta
json
{"success": true, "data": {"id": "9b3f…"}}Notas
- Esta acción es definitiva. Las versiones, los pasos, las conexiones y el historial de inscripciones se van con la secuencia.
- Pausar no es eliminar. Una secuencia en pausa sigue contando para el tope de tu plan: esa es la razón para eliminar una, y la razón para estar seguro.
- Las etiquetas con las que la secuencia se disparaba o que asignaba no se tocan: una secuencia nunca fue su propietaria.