diff --git a/api.planx.uk/modules/misc/docs.yaml b/api.planx.uk/modules/misc/docs.yaml
index 8c1100be38..3d28bd523d 100644
--- a/api.planx.uk/modules/misc/docs.yaml
+++ b/api.planx.uk/modules/misc/docs.yaml
@@ -60,10 +60,19 @@ paths:
                     items:
                       type: object
                       properties:
-                        teamId:
-                          type: integer
-                          format: int32
-                          example: 123
+                        team:
+                          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"]