diff --git a/src/lib/features/segment/segment-controller.ts b/src/lib/features/segment/segment-controller.ts
index e5c1b9573519..5ee69b8f59b3 100644
--- a/src/lib/features/segment/segment-controller.ts
+++ b/src/lib/features/segment/segment-controller.ts
@@ -195,9 +195,10 @@ export class SegmentsController extends Controller {
                 openApiService.validPath({
                     summary: 'Update segment by id',
                     description:
-                        'Updates the content of the segment with the provided payload. Any fields not specified will be left untouched.',
+                        'Updates the content of the segment with the provided payload. Requires `name` and `constraints` to be present. If `project` is not present, it will be set to `null`. Any other fields not specified will be left untouched.',
                     tags: ['Segments'],
                     operationId: 'updateSegment',
+                    requestBody: createRequestSchema('upsertSegmentSchema'),
                     responses: {
                         204: emptyResponse,
                         ...getStandardResponses(400, 401, 403, 409, 415),