Eliminar una secuencia

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ó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
sequenceIdstringObligatorio. 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 es member de la organización, no admin.
  • 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

CampoTipoDescripción
successbooleanIndica si la operación tuvo éxito
data.idstringEl 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.

Relacionado