Merge pull request #36 from ma-hill/HYPERFLEET-978

openshift-merge-bot[bot] · web-flow · commit 2807639a8a85 · 2026-05-04T14:00:46.000Z
HYPERFLEET-978 - feat: (1/2) Add PUT command for internal status endpoints …
diff --git a/README.md b/README.md
@@ -110,7 +110,7 @@ Contains service definitions that generate the OpenAPI specifications:
 
 - **`services/clusters.tsp`** - Cluster resource endpoints
 - **`services/statuses.tsp`** - Status resource endpoints (GET only - public API)
-- **`services/statuses-internal.tsp`** - Status write endpoints (POST - internal API, see below)
+- **`services/statuses-internal.tsp`** - Status write endpoints (POST/PUT - internal API, see below)
 - **`services/nodepools.tsp`** - NodePool resource endpoints
 
 #### Public vs Internal API Split
@@ -121,6 +121,7 @@ The status endpoints are split into two files to support different API consumers
 |------|------------|----------|-------------------|
 | `statuses.tsp` | GET (read) | External clients | ✅ Yes (default) |
 | `statuses-internal.tsp` | POST (write) | Internal adapters | ❌ No (opt-in) |
+| `statuses-internal.tsp` | PUT (write) | Internal adapters | ❌ No (opt-in) |
 
 **Why the split?**
 
diff --git a/main.tsp b/main.tsp
@@ -20,7 +20,7 @@ using OpenAPI;
  *
  */
 @service(#{ title: "HyperFleet API" })
-@info(#{ version: "1.0.8", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })
+@info(#{ version: "1.0.9", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })
 @server("https://hyperfleet.redhat.com", "Production")
 @route("/api/hyperfleet/v1")
 namespace HyperFleet;
diff --git a/schemas/core/openapi.yaml b/schemas/core/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: HyperFleet API
-  version: 1.0.8
+  version: 1.0.9
   contact:
     name: HyperFleet Team
   license:
@@ -494,6 +494,7 @@ paths:
         - name: nodepool_id
           in: path
           required: true
+          description: Nodepool ID
           schema:
             type: string
       responses:
@@ -515,6 +516,45 @@ paths:
           application/json:
             schema:
               $ref: '#/components/schemas/AdapterStatusCreateRequest'
+      security:
+        - BearerAuth: []
+    put:
+      operationId: putNodePoolStatuses
+      summary: Adapter creates or updates resource nodepool status
+      parameters:
+        - name: cluster_id
+          in: path
+          required: true
+          description: Cluster ID
+          schema:
+            type: string
+        - name: nodepool_id
+          in: path
+          required: true
+          description: Nodepool ID
+          schema:
+            type: string
+      responses:
+        '201':
+          description: The request has succeeded and a new resource has been created as a result.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AdapterStatus'
+        '400':
+          description: The server could not understand the request due to invalid syntax.
+        '404':
+          description: The server cannot find the requested resource.
+        '409':
+          description: The request conflicts with the current state of the server.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AdapterStatusCreateRequest'
+      security:
+        - BearerAuth: []
     get:
       operationId: getNodePoolsStatuses
       summary: List all adapter statuses for nodepools
@@ -589,6 +629,37 @@ paths:
               $ref: '#/components/schemas/AdapterStatusCreateRequest'
       security:
         - BearerAuth: []
+    put:
+      operationId: putClusterStatuses
+      summary: Adapter creates or updates resource cluster status
+      parameters:
+        - name: cluster_id
+          in: path
+          required: true
+          description: Cluster ID
+          schema:
+            type: string
+      responses:
+        '201':
+          description: The request has succeeded and a new resource has been created as a result.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AdapterStatus'
+        '400':
+          description: The server could not understand the request due to invalid syntax.
+        '404':
+          description: The server cannot find the requested resource.
+        '409':
+          description: The request conflicts with the current state of the server.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AdapterStatusCreateRequest'
+      security:
+        - BearerAuth: []
     get:
       operationId: getClusterStatuses
       summary: List all adapter statuses for cluster
diff --git a/schemas/core/swagger.yaml b/schemas/core/swagger.yaml
@@ -16,7 +16,7 @@ info:
     name: Apache 2.0
     url: 'https://www.apache.org/licenses/LICENSE-2.0'
   title: HyperFleet API
-  version: 1.0.8
+  version: 1.0.9
 host: hyperfleet.redhat.com
 basePath: /
 schemes:
@@ -648,7 +648,8 @@ paths:
           name: cluster_id
           required: true
           type: string
-        - in: path
+        - description: Nodepool ID
+          in: path
           name: nodepool_id
           required: true
           type: string
@@ -670,6 +671,8 @@ paths:
           description: The server cannot find the requested resource.
         '409':
           description: The request conflicts with the current state of the server.
+      security:
+        - BearerAuth: []
       description: >-
         Adapter creates or updates its status report for this nodepool.
 
@@ -682,6 +685,44 @@ paths:
         Adapter should call this endpoint every time it evaluates the nodepool.
       operationId: postNodePoolStatuses
       summary: Create or update adapter status
+    put:
+      consumes:
+        - application/json
+      produces:
+        - application/json
+      parameters:
+        - description: Cluster ID
+          in: path
+          name: cluster_id
+          required: true
+          type: string
+        - description: Nodepool ID
+          in: path
+          name: nodepool_id
+          required: true
+          type: string
+        - in: body
+          name: body
+          required: true
+          schema:
+            $ref: '#/definitions/AdapterStatusCreateRequest'
+      responses:
+        '201':
+          description: >-
+            The request has succeeded and a new resource has been created as a
+            result.
+          schema:
+            $ref: '#/definitions/AdapterStatus'
+        '400':
+          description: The server could not understand the request due to invalid syntax.
+        '404':
+          description: The server cannot find the requested resource.
+        '409':
+          description: The request conflicts with the current state of the server.
+      security:
+        - BearerAuth: []
+      operationId: putNodePoolStatuses
+      summary: Adapter creates or updates resource nodepool status
   '/api/hyperfleet/v1/clusters/{cluster_id}/statuses':
     get:
       produces:
@@ -782,6 +823,39 @@ paths:
         Adapter should call this endpoint every time it evaluates the cluster.
       operationId: postClusterStatuses
       summary: Create or update adapter status
+    put:
+      consumes:
+        - application/json
+      produces:
+        - application/json
+      parameters:
+        - description: Cluster ID
+          in: path
+          name: cluster_id
+          required: true
+          type: string
+        - in: body
+          name: body
+          required: true
+          schema:
+            $ref: '#/definitions/AdapterStatusCreateRequest'
+      responses:
+        '201':
+          description: >-
+            The request has succeeded and a new resource has been created as a
+            result.
+          schema:
+            $ref: '#/definitions/AdapterStatus'
+        '400':
+          description: The server could not understand the request due to invalid syntax.
+        '404':
+          description: The server cannot find the requested resource.
+        '409':
+          description: The request conflicts with the current state of the server.
+      security:
+        - BearerAuth: []
+      operationId: putClusterStatuses
+      summary: Adapter creates or updates resource cluster status
   /api/hyperfleet/v1/nodepools:
     get:
       produces:
diff --git a/schemas/gcp/openapi.yaml b/schemas/gcp/openapi.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: HyperFleet API
-  version: 1.0.8
+  version: 1.0.9
   contact:
     name: HyperFleet Team
   license:
diff --git a/schemas/gcp/swagger.yaml b/schemas/gcp/swagger.yaml
@@ -16,7 +16,7 @@ info:
     name: Apache 2.0
     url: 'https://www.apache.org/licenses/LICENSE-2.0'
   title: HyperFleet API
-  version: 1.0.8
+  version: 1.0.9
 host: hyperfleet.redhat.com
 basePath: /
 schemes:
diff --git a/services/statuses-internal.tsp b/services/statuses-internal.tsp
@@ -10,18 +10,17 @@ using Http;
 using OpenAPI;
 
 namespace HyperFleet;
+
 @route("/clusters/{cluster_id}/statuses")
 @useAuth(HyperFleet.BearerAuth)
 //@tag("Cluster statuses")
-interface ClusterStatusesInternal{
-
+interface ClusterStatusesInternal {
   /**
    * Adapter creates or updates its status report for this cluster.
    * If adapter already has a status, it will be updated (upsert by adapter name).
    *
    * Response includes the full adapter status with all conditions.
    * Adapter should call this endpoint every time it evaluates the cluster.
-   *
    */
   @route("")
   @post
@@ -31,29 +30,43 @@ interface ClusterStatusesInternal{
     /**
      * Cluster ID
      */
-     @path cluster_id: string,
+    @path cluster_id: string,
 
     @body body: AdapterStatusCreateRequest,
   ):
     | (CreatedResponse & AdapterStatus)
-      | BadRequestResponse
-      | NotFoundResponse
-      | ConflictResponse
-      | BadRequestResponse;
+    | BadRequestResponse
+    | NotFoundResponse
+    | ConflictResponse;
+
+  @route("")
+  @put
+  @summary("Adapter creates or updates resource cluster status")
+  @operationId("putClusterStatuses")
+  putClusterStatuses(
+    /**
+     * Cluster ID
+     */
+    @path cluster_id: string,
 
+    @body body: AdapterStatusCreateRequest,
+  ):
+    | (CreatedResponse & AdapterStatus)
+    | BadRequestResponse
+    | NotFoundResponse
+    | ConflictResponse;
 }
 
 //@tag("NodePool statuses")
 @route("/clusters/{cluster_id}/nodepools/{nodepool_id}/statuses")
-interface NodePoolStatusesInternal{
-
+@useAuth(HyperFleet.BearerAuth)
+interface NodePoolStatusesInternal {
   /**
    * Adapter creates or updates its status report for this nodepool.
    * If adapter already has a status, it will be updated (upsert by adapter name).
    *
    * Response includes the full adapter status with all conditions.
    * Adapter should call this endpoint every time it evaluates the nodepool.
-   *
    */
   @route("")
   @post
@@ -63,15 +76,39 @@ interface NodePoolStatusesInternal{
     /**
      * Cluster ID
      */
-     @path cluster_id: string,
-     @path nodepool_id: string,
+    @path cluster_id: string,
+
+    /**
+     * Nodepool ID
+     */
+    @path nodepool_id: string,
 
     @body body: AdapterStatusCreateRequest,
   ):
     | (CreatedResponse & AdapterStatus)
-      | BadRequestResponse
-      | NotFoundResponse
-      | ConflictResponse
-      | BadRequestResponse;
+    | BadRequestResponse
+    | NotFoundResponse
+    | ConflictResponse;
+
+  @route("")
+  @put
+  @summary("Adapter creates or updates resource nodepool status")
+  @operationId("putNodePoolStatuses")
+  putNodePoolStatuses(
+    /**
+     * Cluster ID
+     */
+    @path cluster_id: string,
+
+    /**
+     * Nodepool ID
+     */
+    @path nodepool_id: string,
 
+    @body body: AdapterStatusCreateRequest,
+  ):
+    | (CreatedResponse & AdapterStatus)
+    | BadRequestResponse
+    | NotFoundResponse
+    | ConflictResponse;
 }

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@ using OpenAPI;`
`20`	`20`	`*`
`21`	`21`	`*/`
`22`	`22`	`@service(#{ title: "HyperFleet API" })`
`23`		`-@info(#{ version: "1.0.8", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })`
	`23`	`+@info(#{ version: "1.0.9", contact: #{ name: "HyperFleet Team" }, license: #{ name: "Apache 2.0" ,url: "https://www.apache.org/licenses/LICENSE-2.0"} })`
`24`	`24`	`@server("https://hyperfleet.redhat.com", "Production")`
`25`	`25`	`@route("/api/hyperfleet/v1")`
`26`	`26`	`namespace HyperFleet;`