From 56d38ab1ddd7c027c8a5c7266607b601ad0f4de1 Mon Sep 17 00:00:00 2001
From: Patrick Kuijvenhoven <patrick.kuijvenhoven@gmail.com>
Date: Fri, 9 Jan 2026 10:19:07 +0100
Subject: [PATCH] fix(openapi): phpdoc operation response as array<int|string,
 OpenApi\Response>

---
 src/OpenApi/Model/Operation.php | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/src/OpenApi/Model/Operation.php b/src/OpenApi/Model/Operation.php
index 5ee455d70ac..20c5557bdda 100644
--- a/src/OpenApi/Model/Operation.php
+++ b/src/OpenApi/Model/Operation.php
@@ -17,15 +17,16 @@ final class Operation
 {
     use ExtensionTrait;
 
+    /**
+     * @param ?string[]   $tags
+     * @param ?Response[] $responses
+     */
     public function __construct(private ?string $operationId = null, private ?array $tags = null, private ?array $responses = null, private ?string $summary = null, private ?string $description = null, private ?ExternalDocumentation $externalDocs = null, private ?array $parameters = null, private ?RequestBody $requestBody = null, private ?\ArrayObject $callbacks = null, private ?bool $deprecated = null, private ?array $security = null, private ?array $servers = null, array $extensionProperties = [])
     {
         $this->extensionProperties = $extensionProperties;
     }
 
-    /**
-     * @param string $status
-     */
-    public function addResponse(Response $response, $status = 'default'): self
+    public function addResponse(Response $response, int|string $status = 'default'): self
     {
         $this->responses[$status] = $response;
 
@@ -62,6 +63,9 @@ public function getExternalDocs(): ?ExternalDocumentation
         return $this->externalDocs;
     }
 
+    /**
+     * @return ?Parameter[]
+     */
     public function getParameters(): ?array
     {
         return $this->parameters;
@@ -151,6 +155,9 @@ public function withExternalDocs(ExternalDocumentation $externalDocs): self
         return $clone;
     }
 
+    /**
+     * @param Parameter[] $parameters
+     */
     public function withParameters(array $parameters): self
     {
         $clone = clone $this;