From 9188800dc74bcecb2109f5974672ef56630b2346 Mon Sep 17 00:00:00 2001
From: Joe Rogers <1337joe@users.noreply.github.com>
Date: Fri, 2 Oct 2026 15:35:50 -0400
Subject: [PATCH] Fix transitions query schema to indicate it returns a list
 (#12967)

* Fix transitions query schema to indicate it returns a list

* Update api version

* Update api_version.py

---------

Co-authored-by: Matthias Mair <code@mjmair.com>
---
 src/backend/InvenTree/InvenTree/api_version.py      | 5 ++++-
 src/backend/InvenTree/generic/states/api_helpers.py | 3 +++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index f9e82c49a1..1839b2cd09 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 551
+INVENTREE_API_VERSION = 552
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v552 -> 2026-10-02 : https://github.com/inventree/InvenTree/pull/12967
+    - Fix transitions endpoint schema to indicate that it returns a list
+
 v551 -> 2026-09-21 : https://github.com/inventree/InvenTree/pull/12693
     - Docstring updates for automated transition API documentation generation
     - New transitions insights endpoints
diff --git a/src/backend/InvenTree/generic/states/api_helpers.py b/src/backend/InvenTree/generic/states/api_helpers.py
index 158d64ce88..132caeb15c 100644
--- a/src/backend/InvenTree/generic/states/api_helpers.py
+++ b/src/backend/InvenTree/generic/states/api_helpers.py
@@ -355,12 +355,15 @@ class FSMTransitionMixin:
             if getattr(handler, 'transition_name', None)
         }
 
+    @extend_schema(responses={200: AvailableTransitionSerializer(many=True)})
     @action(
         detail=True,
         methods=['get'],
         url_path=TRANSITION_URL_PREFIX,
         url_name='transitions',
         serializer_class=AvailableTransitionSerializer,
+        pagination_class=None,
+        filter_backends=[],
     )
     def transitions(self, request: Request, pk: str | None = None, *kwargs) -> Response:
         """List the FSM transitions reachable from this object's current state.