DELETE /api/v1/sequences/{sequenceId}/versions/{versionId}
Descarta un borrador: la salida de la regla de un solo borrador.
| Condición | Respuesta |
|---|---|
| un borrador, y no la única versión | 200 |
| no es un borrador | 400: las versiones publicadas y archivadas se conservan para siempre |
| la única versión de la secuencia | 400: lleva el disparador; elimina la secuencia en su lugar |
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 |
versionId | string | Obligatorio. El borrador que se descarta; una versión publicada se rechaza |
Ejemplo
bash
curl -X DELETE -H "x-api-key: $AGENTMAIL_API_KEY" \
"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 esmemberde la organización, noadmin.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 de lo que se eliminó |
Ejemplo de respuesta
json
{
"success": true,
"data": {
"id": "4d19c0a2"
}
}