chore: update state endpoint

openapi/MainResources-local-openapi-v3.yml

@@ -280,6 +280,29 @@ paths:
               schema:
                 $ref: '#/components/schemas/AdvancedError'
   '/userdefinedstates/{userDefinedStateId}/state':
+    get:
+      summary: Retrieve the state of a specific UserDefinedState
+      description: |-
+        Retrieves the state of a UserDefinedState on the controller identified by the `userDefinedStateId` path parameter.
+      tags:
+        - UserDefinedStates
+      parameters:
+      - $ref: '#/components/parameters/apiVersionHeaderParam'
+      - $ref: '#/components/parameters/userDefinedStateIdPathParam'
+      responses:
+        '200':
+          description: Accepted request.
+          content:
+            text/plain:
+              schema:
+                type: string
+                example: true
+        '404':
+          description: The entity could not be found.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AdvancedError'
     put:
       summary: Executes the state on the controller
       description: |-

postman/Bosch Smart Home Controller.postman_collection.json

@@ -632,6 +632,25 @@
 					},
 					"response": []
 				},
+				{
+					"name": "State of UserDefinedState by Id",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "{{shc_api}}/userdefinedstates/{{user_defined_state_id}}/state",
+							"host": [
+								"{{shc_api}}"
+							],
+							"path": [
+								"userdefinedstates",
+								"{{user_defined_state_id}}",
+								"state"
+							]
+						}
+					},
+					"response": []
+				},
 				{
 					"name": "UserDefinedState",
 					"request": {