I am proposing the Discourse API documentation using RESTful API Modeling Language (RAML) . This would enable us to: programmatically interact with the API perform testing on various endpoints automatically generated interactive interfaces to read the documentation maintain the API docs along with …

Great idea :wink: The API Docs are currently being re-written in YAML which ReDoc uses to display the results.

Discourse API Documentation Using RAML

Tema		Respuestas	Vistas
Programmatic way to get all API endpoints for my instance? Development rest-api	11	711	24 Abril 2025
Why isn't the Discourse API fully documented? Development	9	2277	13 Enero 2020
Swagger, WADL or similar for the REST API? Development	10	14772	30 Agosto 2016
Discourse API Documentation Released! Blog	2	4130	8 Marzo 2017
Contributing to the Discourse API documentation Contributing rest-api , how-to	3	3280	16 Noviembre 2023