Eliminar un curso

Este endpoint permite eliminar un curso del catálogo del negocio gracias a su identificador.

DELETE /api/v2/businesses/{businessId}/courses/{courseId}

Si los datos incluidos en la petición son correctos, se eliminará el curso indicado y la respuesta será un 204 No Content.

Consideraciones

Si el curso es requisito de otros cursos, la petición falla salvo que se indique el parámetro opcional force=true. En ese caso, el curso se elimina también de los requisitos de los cursos que dependían de él.

El parámetro (opcional) force determina si el curso se elimina aunque sea requisito de otros cursos ?force=true. Por defecto, es false.

DELETE /api/v2/businesses/{businessId}/courses/{courseId}?force=true

Al ejecutarse, el curso se elimina de todas las trayectorias formativas que lo incluyen. Si una trayectoria formativa se queda sin cursos tras la eliminación, la trayectoria también se elimina.

Las asignaciones existentes del curso no se eliminan. Sin embargo, a efectos de la API el curso deja de existir: no se puede consultar, modificar ni asignar.

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

404 Not Found

Course not found: […​]

El courseId indicado no existe en el negocio.

400 Bad Request

error.course_is_requirement_of_others

El curso es requisito de otros cursos y no se ha indicado force=true. El mensaje incluye los nombres de los cursos que dependen de él.

Enlaces de interés

¿Qué es un curso?

¿Qué es una trayectoria formativa?