label and milestone endpoints on swagger-ui should be place at repository level, not at issue level #13321

Open
opened 2025-11-02 10:38:30 -06:00 by GiteaMirror · 3 comments
Owner

Originally created by @juanpablo-santos on GitHub (Jul 23, 2024).

Description

As per title, when upgrading to 1.22.1, we've noticed that /repos/{owner}/{repo}/labels isn't shown on swagger-ui anymore, although the endpoint still exists and works as expected.

Gitea Version

1.22.1

Can you reproduce the bug on the Gitea demo site?

Yes

Log Gist

No response

Screenshots

No response

Git Version

No response

Operating System

No response

How are you running Gitea?

we're using the docker image

Database

None

Originally created by @juanpablo-santos on GitHub (Jul 23, 2024). ### Description As per title, when upgrading to 1.22.1, we've noticed that [/repos/{owner}/{repo}/labels](https://demo.gitea.com/api/swagger#/repository/repoListLabels) isn't shown on swagger-ui anymore, although the endpoint still exists and works as expected. ### Gitea Version 1.22.1 ### Can you reproduce the bug on the Gitea demo site? Yes ### Log Gist _No response_ ### Screenshots _No response_ ### Git Version _No response_ ### Operating System _No response_ ### How are you running Gitea? we're using the docker image ### Database None
GiteaMirror added the type/bug label 2025-11-02 10:38:30 -06:00
Author
Owner

@Zettat123 commented on GitHub (Jul 24, 2024):

The /repos/{owner}/{repo}/labels API can be found in the swagger of gitea.com

It's in the "issue" section but I think maybe we can move it to the "repository" section?

@Zettat123 commented on GitHub (Jul 24, 2024): The `/repos/{owner}/{repo}/labels` API can be found in [the swagger of gitea.com](https://gitea.com/api/swagger#/issue/issueListLabels) It's in the "issue" section but I think maybe we can move it to the "repository" section?
Author
Owner

@juanpablo-santos commented on GitHub (Jul 24, 2024):

Hi @Zettat123,

oops should've checked better, my bad :_S We don't use gitea's issues as we've an external issue tracker and that's why I didn't look into that section (usually, never do).

IMO, in terms of consistency, either label endpoints (and milestones) should be moved to "repository" section (b/c they're defined at repo level, and can be also applied to PRs), or all the pull_request related endpoints should be moved into the "issue" section (as more or less issues and pull request are basically the same).

I'll edit this issue's title so it does not cause confusion (and feel free to close is you think it's not an issue and there's nothing to do here)

thanks for your time and looking into this :-)

@juanpablo-santos commented on GitHub (Jul 24, 2024): Hi @Zettat123, oops should've checked better, my bad :_S We don't use gitea's issues as we've an external issue tracker and that's why I didn't look into that section (usually, never do). IMO, in terms of consistency, either label endpoints (and milestones) should be moved to "repository" section (b/c they're defined at repo level, and can be also applied to PRs), or all the pull_request related endpoints should be moved into the "issue" section (as more or less issues and pull request are basically the same). I'll edit this issue's title so it does not cause confusion (and feel free to close is you think it's not an issue and there's nothing to do here) thanks for your time and looking into this :-)
Author
Owner

@yp05327 commented on GitHub (Jul 24, 2024):

It's in the "issue" section but I think maybe we can move it to the "repository" section?

I noticed this 'issue' for a long time. Not only this one, but some of them are confused.

@yp05327 commented on GitHub (Jul 24, 2024): > It's in the "issue" section but I think maybe we can move it to the "repository" section? I noticed this 'issue' for a long time. Not only this one, but some of them are confused.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/gitea#13321