From b2aefd4cf98da9b810d104bb5ac82e587f2a8a5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Rod=C3=A1k?= <hony.com@seznam.cz>
Date: Fri, 10 Oct 2025 11:55:07 +0200
Subject: [PATCH] docs: add missing manifest parameter to build API endpoints
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add manifest parameter documentation to /libpod/build, and /libpod/local/build endpoints in OpenAPI spec.

Fixes: https://github.com/containers/podman/issues/27261

Signed-off-by: Jan Rodák <hony.com@seznam.cz>
---
 pkg/api/server/register_images.go | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/pkg/api/server/register_images.go b/pkg/api/server/register_images.go
index c39371052a..1f2c927c2d 100644
--- a/pkg/api/server/register_images.go
+++ b/pkg/api/server/register_images.go
@@ -492,7 +492,7 @@ func (s *APIServer) registerImagesHandlers(r *mux.Router) error {
 	// ---
 	// tags:
 	//  - images (compat)
-	// summary: Create image
+	// summary: Build image
 	// description: Build an image from the given Dockerfile(s)
 	// parameters:
 	//  - in: header
@@ -1494,7 +1494,7 @@ func (s *APIServer) registerImagesHandlers(r *mux.Router) error {
 	// ---
 	// tags:
 	//  - images
-	// summary: Create image
+	// summary: Build image
 	// description: Build an image from the given Dockerfile(s)
 	// parameters:
 	//  - in: header
@@ -1818,6 +1818,12 @@ func (s *APIServer) registerImagesHandlers(r *mux.Router) error {
 	//    type: array
 	//    items:
 	//      type: string
+	//  - in: query
+	//    name: manifest
+	//    type: string
+	//    default:
+	//    description: |
+	//      Add the image to the specified manifest list. Creates a manifest list if it does not exist.
 	// produces:
 	// - application/json
 	// responses:
@@ -2166,6 +2172,12 @@ func (s *APIServer) registerImagesHandlers(r *mux.Router) error {
 	//    type: array
 	//    items:
 	//      type: string
+	//  - in: query
+	//    name: manifest
+	//    type: string
+	//    default:
+	//    description: |
+	//      Add the image to the specified manifest list. Creates a manifest list if it does not exist.
 	// produces:
 	// - application/json
 	// responses: