# \[GSoC 2025 PROPOSAL\] Ayan - Swagger / OpenAPI standardization for Jenkins REST API

**URL:** <https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071>\
**Category:** GSoC\
**Created:** [March 29, 2025, 10:54am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071 "2025-03-29T10:54:16Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![root9411](https://avatars.discourse-cdn.com/v4/letter/r/8baadc/32.png) [@root9411](https://community.jenkins.io/u/root9411)\
**Post date:** [March 29, 2025, 10:54am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/1 "2025-03-29T10:54:16Z")

</div>

Hello, Jenkins Community! I have submitted my GSoC draft proposal for the Swagger/OpenAPI standardization for Jenkins REST API project.

I would love to get some feedback on my proposal from the Jenkins community or GSoC mentors.

Thank you for reading and I’m looking forward to contributing.

Ayan Shah

---

<div class="post-metadata">

**Author:** ![YongGoose](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/yonggoose/32/13833_2.png) [@YongGoose](https://community.jenkins.io/u/YongGoose)\
**Post date:** [March 29, 2025, 11:18am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/2 "2025-03-29T11:18:54Z")

</div>

I think it would be best to remove the proposal.  
Here is a link to a similar case.

Have a great day 🙂  
yongjun

> [@\[GCoC 2025 PROPOSAL\] Backend code refactoring for Infra Statistics](https://community.jenkins.io/t/gcoc-2025-proposal-backend-code-refactoring-for-infra-statistics/29027):
>
> Greeting Jenkins Community I’m Joseph James, a final year BSc Computer Science student at Lancaster University in the UK. I am extremely excited at the potential to contribute to the Jenkins community by refactoring the backend of the Jenkins Infra Stats inspector. I have submitted my draft proposal through the google form. I would love to get some feedback on my proposal from the Jenkins community or GSoC mentors. Thank you for reading and I’m looking forward to contributing. Joseph James

---

<div class="post-metadata">

**Author:** ![root9411](https://avatars.discourse-cdn.com/v4/letter/r/8baadc/32.png) [@root9411](https://community.jenkins.io/u/root9411)\
**Post date:** [March 29, 2025, 11:28am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/3 "2025-03-29T11:28:22Z")

</div>

Thanks for your advice, Yongjun

---

<div class="post-metadata">

**Author:** ![poddingue](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/poddingue/32/985_2.png) [@poddingue](https://community.jenkins.io/u/poddingue)\
**Post date:** [March 29, 2025, 6:38pm UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/4 "2025-03-29T18:38:18Z")

</div>

Hello @root9411, and welcome to this community. 👋

The document was well received, thanks! 👍

---

<div class="post-metadata">

**Author:** ![root9411](https://avatars.discourse-cdn.com/v4/letter/r/8baadc/32.png) [@root9411](https://community.jenkins.io/u/root9411)\
**Post date:** [April 1, 2025, 5:53am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/5 "2025-04-01T05:53:34Z")

</div>

Thanks, @poddingue @Alyssat Sir, please suggest any updates to the document if I have made any mistakes or misunderstood anything

Short Introduction: - I am a software engineer who has worked on multiple systems from a young age while pursuing my graduation. I am currently preparing for admission to msc computer science. My primary responsibilities include designing system workflows, developing APIs, and documenting them using Swagger UI and Redoc. Before transitioning into tech, I was a computer teacher, instructing students in multiple programming languages, including HTML, CSS, JavaScript, Java, .NET, and Angular.

**Proposal Link** : [[Swagger / OpenAPI standardization for Jenkins REST API]](https://docs.google.com/document/d/1_AAPfmLy8BT1ihcZTMKhmqwZf_PRr9MudNa-HBl7JfI/edit?tab=t.0)

---

<div class="post-metadata">

**Author:** ![root9411](https://avatars.discourse-cdn.com/v4/letter/r/8baadc/32.png) [@root9411](https://community.jenkins.io/u/root9411)\
**Post date:** [April 2, 2025, 8:43am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/6 "2025-04-02T08:43:38Z")

</div>

Thank you, Jenkins Community! 🙌

Special thanks to @poddingue @alyssat @berviantoleo for your valuable suggestions. Based on your feedback, I’ve updated the approach and provided a more structured solution on how **existing plugins** can integrate with this mechanism, how we can **convert the metadata into the API Spec** and **mechanism for new jenkins plugins developers to register APIs in the central documentation system**

---

<div class="post-metadata">

**Author:** ![root9411](https://avatars.discourse-cdn.com/v4/letter/r/8baadc/32.png) [@root9411](https://community.jenkins.io/u/root9411)\
**Post date:** [April 6, 2025, 9:50am UTC](https://community.jenkins.io/t/gsoc-2025-proposal-ayan-swagger-openapi-standardization-for-jenkins-rest-api/29071/7 "2025-04-06T09:50:02Z")

</div>

Thank you, @krisstern I love to see feedbacks from Jenkins Community! And I truly appreciate - it means a lot. 🙂

I’ve made some improvements to the proposal document to make it clearer and more understandable based on your suggestions.

I understand that some of the points I mentioned might not be the perfect solutions, but I’ve done my best to provide thoughtful and practical ideas based on my current level of understanding and experience.

Thank you once again, Jenkins Community, for the support and encouragement!
