diff --git a/api.planx.uk/modules/misc/docs.yaml b/api.planx.uk/modules/misc/docs.yaml
index 8c1100be38..f13ec0e26f 100644
--- a/api.planx.uk/modules/misc/docs.yaml
+++ b/api.planx.uk/modules/misc/docs.yaml
@@ -60,10 +60,21 @@ paths:
                     items:
                       type: object
                       properties:
-                        teamId:
-                          type: integer
-                          format: int32
-                          example: 123
+                        team:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: integer
+                                format: int32
+                                example: 123
+                              slug:
+                                type: string
+                                example: opensystemslab
+                              name:
+                                type: string
+                                example: Open Systems Lab
                         role:
                           type: string
                           enum: ["teamEditor", "teamViewer"]