Swagger Docs Error: GET /api/lists requires request body

knadh / listmonk

High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.

https://listmonk.app

GNU Affero General Public License v3.0

14.86k stars 1.36k forks source link

Swagger Docs Error: GET /api/lists requires request body #2077

Open TadeSF opened 1 week ago

TadeSF commented 1 week ago

Version:

listmonk: v3.0.0
OS: N/A – Listmonk docs

Description of the bug and steps to reproduce: In the swagger docs of the official listmonk documentation, the /api/lists endpoint requires a request body to be present, which is not allowed in get requests.

Screenshots: CleanShot 2024-10-08 at 13 30 08@2x

TadeSF commented 1 week ago

And I just noticed another problem with the swagger docs: The examples of the attribs do make it clear, what could be put in there, if you are viewing the swagger documentation. But when you try to generate a typesafe API with the openapi tooling from the collections.yaml, these fields city, projects and stack get strongly typed into what the endpoint expects as a body...