Saltar al contenido principal

Eliminar una lista

DELETE/v1/lists/{id}

Para desarrolladores

Descripción​

Elimina una lista. Deja de aparecer en el listado y su nombre queda libre para una lista nueva.

Autenticación​

Authorizationbearer tokenheaderobligatorio
API key con scope list:write. Formato: Bearer <API_KEY>.
X-Instance-Slugstringheaderobligatorio
Identificador de su instancia. Ver Autenticación.

Request​

Path params:

idintegerobligatorio
Identificador de la lista.

Response​

204 No ContentLa lista queda eliminada; la respuesta no trae body.

Errores​

CódigoCuándo
404La lista no existe o ya fue eliminada (list_not_found).
Request
curl -X DELETE "https://$API_HOST/v1/lists/4" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"
Response

Sin cuerpo: la respuesta no trae contenido.