Add missing 400 response documentation to REST API endpoints (#5144)

* Add missing 400 API response documentation to REST endpoints

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: kaikreuzer <3244965+kaikreuzer@users.noreply.github.com>
This commit is contained in:
Copilot
2025-12-13 16:52:19 +01:00
committed by GitHub
co-authored by copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> kaikreuzer
parent 839581898b
commit ed1a094a40
2 changed files with 2 additions and 0 deletions
@@ -273,6 +273,7 @@ public class ItemChannelLinkResource implements RESTResource {
@Operation(operationId = "unlinkItemFromChannel", summary = "Unlinks an item from a channel.", security = {
@SecurityRequirement(name = "oauth2", scopes = { "admin" }) }, responses = {
@ApiResponse(responseCode = "200", description = "OK"),
@ApiResponse(responseCode = "400", description = "Invalid channel UID."),
@ApiResponse(responseCode = "404", description = "Link not found."),
@ApiResponse(responseCode = "405", description = "Link not editable.") })
public Response unlink(@PathParam("itemName") @Parameter(description = "itemName") String itemName,
@@ -334,6 +334,7 @@ public class PersistenceResource implements RESTResource {
@Operation(operationId = "storeItemDataInPersistenceService", summary = "Stores item persistence data into the persistence service.", security = {
@SecurityRequirement(name = "oauth2", scopes = { "admin" }) }, responses = {
@ApiResponse(responseCode = "200", description = "OK"),
@ApiResponse(responseCode = "400", description = "Item not found, invalid state, invalid time format, or persistence service not found or not modifiable."),
@ApiResponse(responseCode = "404", description = "Unknown Item or persistence service") })
public Response httpPutPersistenceItemData(@Context HttpHeaders headers,
@Parameter(description = "Id of the persistence service. If not provided the default service will be used") @QueryParam("serviceId") @Nullable String serviceId,