Draft: OpenAPI proposal

What does this MR do and why?

Add an OpenAPI proposal for the REST endpoints to manage GitLab Agents for Kubernetes.

This is the proposal to be implemented as #345603 (closed)

See the rendered version of the API specs here.

Open questions

• A better understanding of the OpenAPI schema is required, especially around links instead of the meta built into the spec originally
• ... ?

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

• I have evaluated the MR acceptance checklist for this MR.

changed milestone to %Backlog

added GitLab Free [deprecated] Accepting merge requests candidate14.7 devopsconfigure [DEPRECATED] groupconfigure [DEPRECATED] sectionops typefeature labels

assigned to @nagyv-gitlab

restored source branch 345603-add-rest-api-to-manage-cluster-agents

added 1 commit

• 41018383 - Add first proposal

Compare with previous version

changed title from Draft: Resolve "Add REST API to manage Cluster Agents" to Draft: OpenAPI proposal

added 1 commit

• 273f4b26 - Trying to get auto-rendering work

Compare with previous version

mentioned in issue #345603 (closed)

changed the description

added 1 commit

• 0ba65b9f - Update doc/api/openapi/agent.openapi.yaml

Compare with previous version

changed the description

added 1 commit

• 99f19399 - Added "required" flags

Compare with previous version

removed [deprecated] Accepting merge requests label

mentioned in epic &7204

	1 Warning
	0ba65b9f: The commit subject must contain at least 3 words. For more information, take a look at our Commit message guidelines.

	1 Message
	CHANGELOG missing: If you want to create a changelog entry for GitLab FOSS, add the Changelog trailer to the commit message you want to add to the changelog. If you want to create a changelog entry for GitLab EE, also add the EE: true trailer to your commit message. If this merge request doesn't need a CHANGELOG entry, feel free to ignore this message.

Reviewer roulette

There are no reviewer and maintainer suggestions for the changes in this MR.

Uncategorized files

These files couldn't be categorized, so Danger was unable to suggest a reviewer. Please consider creating a merge request to add support for them.

• doc/api/openapi/agent.openapi.yaml

If needed, you can retry the danger-review job that generated this comment.

Generated by Danger

mentioned in merge request !82161 (closed)