Missing endpoints in OpenAPI documentation
Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.
There is a large deficit between the REST API documentation and the OpenAPI specification (https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/openapi/openapi.yaml). Mainly endpoints on the /projects, /groups and /issues nodes are required to be able to use the OpenAPI as basis for automated consumption.
I have made a list of all endpoints known to our software (which uses a quite old version of GitLab) and that are missing from the OpenAPI specification. I have checked most of them to be in the REST documentation.
Can these endpoints be added to the OpenAPI specification? This should be done in an automated way just as the REST documentation is generated to prevent manual labor and error.
- /application/settings
/deploy_keys- /groups
- /groups/{id}/members
- /issues
- /keys/{id}
- /license
- /namespaces
- /notification_settings
- /projects
- /projects/{id}
- /projects/{id}/builds
- /projects/{id}/deployments
- /projects/{id}/hooks
- /projects/{id}/issues/{issue_id}/award_emoji
- /projects/{id}/issues/{issue_id}/notes
- /projects/{id}/labels
- /projects/{id}/members
- /projects/{id}/merge_request/{merge_request_id}/changes
- /projects/{id}/merge_requests
- /projects/{id}/milestones
- /projects/{id}/pipelines
- /projects/{id}/repository/commits
- /projects/{id}/repository/compare
- /projects/{id}/repository/files
- /projects/{id}/repository/tags
- /projects/{id}/repository/tree
- /projects/{id}/runners
- /projects/{id}/integrations/asana
- /projects/{id}/integrations/assembla
- /projects/{id}/integrations/bamboo
- /projects/{id}/integrations/buildkite
- /projects/{id}/integrations/campfire
- /projects/{id}/integrations/custom-issue-tracker
- /projects/{id}/integrations/drone-ci
- /projects/{id}/integrations/emails-on-push
- /projects/{id}/integrations/external-wiki
- /projects/{id}/integrations/irker
- /projects/{id}/integrations/jira
- /projects/{id}/integrations/pivotaltracker
- /projects/{id}/integrations/pushover
- /projects/{id}/integrations/redmine
- /projects/{id}/integrations/slack
- /projects/{id}/integrations/teamcity
- /projects/{id}/snippets
- /projects/{id}/triggers
- /projects/{id}/variables
- /runners
- /session
- /sidekiq/compound_metrics
- /templates/licenses
- /todos
- /user
- /users