Document /v1/node/new POST endpoint in OpenAPI specification

[Copilot]

The /v1/node/new endpoint was undocumented in openapi.yaml despite being implemented in script/rvd_front.

Changes

• Added POST /v1/node/new endpoint documentation with form parameters:
  • name: Node identifier
  • vm_type: Hypervisor type (KVM, LXC, Void)
  • hostname: FQDN or IP address
  • _submit: Form submission flag (must be 1)
• Documented admin-only access requirement and response codes (200, 401, 400)
• Used application/x-www-form-urlencoded content type matching the implementation

The endpoint creates a new hypervisor node by inserting parameters into the vms table via Ravada::Front->add_node().

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Document API /v1/node/new</issue_title>
<issue_description>
Document in openapi.yaml the function for create a new node found in script/rvd_front

/v1/node/new

The POST arguments should be:

• name : name of the new node
• vm_type: type ( usually KVM )
• hostname: fqdn or IP address
• _submit: true value 1</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Document API /v1/node/new #2278

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This pull request adds OpenAPI documentation for the /v1/node/new endpoint that creates new hypervisor nodes in Ravada. The endpoint was previously implemented in script/rvd_front but undocumented in the OpenAPI specification.

Changes:

• Added POST /v1/node/new endpoint documentation with request body schema
• Documented required form parameters: name, vm_type, hostname, and _submit
• Specified response codes and admin privilege requirements

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.