Eliminar empresa

Este endpoint permite eliminar una empresa previamente registrada en el sistema Guarani App, utilizando su identificador único (ID), es útil para remover registros obsoletos o erróneos y mantener la base de datos actualizada.

---

Entorno

URL Base: https://api.guarani.app

Endpoint

DELETE /empresas/{id}

Ejemplo de solicitud

curl -X DELETE "https://api.guarani.app/empresas/{id}" \
  -H "x-api-key: Bearer <access_token>" \
  -H "Accept: application/json" | jq

Nota: Reemplaza {id} por el identificador único de la empresa y <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	uuid	Sí	Identificador único de la empresa a eliminar. (ver empresas)

Encabezados de la Solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token de acceso válido proporcionado por el equipo Guarani.
Accept	application/json	Indica que la respuesta debe devolverse en formato JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "204",
  "message": "Recurso eliminado correctamente.",
  "data": {
    "id": "f57bdf3a-26d0-4a6e-9222-915dcc5c177e",
    "eliminado_en": "2025-09-12T09:27:20.133Z"
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único de la empresa eliminada.
eliminado_en	string	Fecha y hora en formato ISO 8601 de la eliminación.

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores