diff --git a/mv-openapi.yaml b/mv-openapi.yaml
index 353427e..197a81b 100644
--- a/mv-openapi.yaml
+++ b/mv-openapi.yaml
@@ -1,4 +1,5 @@
-# This file has been automatically generated. All manual modifications may be lost. See README.md for details.
+# Warning: this file has been automatically generated. All manual modifications will be lost, see README.md for details.
+openapi: 3.0.0
 info:
   title: Mieux Voter
   description: A poll application based on Majority Judgment (MJ).
@@ -361,42 +362,42 @@ components:
             format: int16
   links:
     get-poll:
-      operationRef: get-poll
+      operationId: get-poll
       parameters:
         pollId: $response.body#/id
       description: >
         The `id` value returned in the response can be used as the `poll-id`
         parameter in GET /polls/{poll-id}.
     update-poll:
-      operationRef: update-poll
+      operationId: update-poll
       parameters:
         pollId: $response.body#/id
       description: >
         The `id` value returned in the response can be used as the `poll-id`
         parameter in PATCH /polls/{poll-id}.
     delete-poll:
-      operationRef: delete-poll
+      operationId: delete-poll
       parameters:
         pollId: $response.body#/id
       description: >
         The `id` value returned in the response can be used as the `poll-id`
         parameter in DELETE /polls/{poll-id}.
     create-judgment:
-      operationRef: create-judgment
+      operationId: create-judgment
       parameters:
         userId: $response.body#/id
       description: >
         The `id` value returned in the response can be used as the `poll-id`
         parameter in POST /polls/{poll-id}/judgments.
     list-poll-results:
-      operationRef: list-poll-results
+      operationId: list-poll-results
       parameters:
         pollId: $response.body#/id
       description: >
         The `id` value returned in the response can be used as the `poll-id`
         parameter in GET /polls/{poll-id}/results.
     get-judgment:
-      operationRef: get-judgment
+      operationId: get-judgment
       parameters:
         judgmentId: $response.body#/id
       description: >
diff --git a/openapi/components/links/add-judge-to-poll.yaml b/openapi/components/links/add-judge-to-poll.yaml
index 38ec137..e872411 100644
--- a/openapi/components/links/add-judge-to-poll.yaml
+++ b/openapi/components/links/add-judge-to-poll.yaml
@@ -1,4 +1,4 @@
-operationRef: 'add-judge-to-poll'
+operationId: 'add-judge-to-poll'
 parameters:
   userId: $response.body#/id
 description: >
diff --git a/openapi/components/links/create-judgment.yaml b/openapi/components/links/create-judgment.yaml
index f98a6b9..6ccc161 100644
--- a/openapi/components/links/create-judgment.yaml
+++ b/openapi/components/links/create-judgment.yaml
@@ -1,4 +1,4 @@
-operationRef: 'create-judgment'
+operationId: 'create-judgment'
 parameters:
   userId: $response.body#/id
 description: >
diff --git a/openapi/components/links/delete-poll.yaml b/openapi/components/links/delete-poll.yaml
index 3e4f44b..b074a18 100644
--- a/openapi/components/links/delete-poll.yaml
+++ b/openapi/components/links/delete-poll.yaml
@@ -1,4 +1,4 @@
-operationRef: 'delete-poll'
+operationId: 'delete-poll'
 parameters:
   pollId: $response.body#/id
 description: >
diff --git a/openapi/components/links/get-judgment.yaml b/openapi/components/links/get-judgment.yaml
index 5de0bf6..b52f5d4 100644
--- a/openapi/components/links/get-judgment.yaml
+++ b/openapi/components/links/get-judgment.yaml
@@ -1,4 +1,4 @@
-operationRef: 'get-judgment'
+operationId: 'get-judgment'
 parameters:
   judgmentId: $response.body#/id
 description: >
diff --git a/openapi/components/links/get-poll.yaml b/openapi/components/links/get-poll.yaml
index 3fc6fa2..cdb764e 100644
--- a/openapi/components/links/get-poll.yaml
+++ b/openapi/components/links/get-poll.yaml
@@ -1,4 +1,4 @@
-operationRef: 'get-poll'
+operationId: 'get-poll'
 parameters:
   pollId: $response.body#/id
 description: >
diff --git a/openapi/components/links/list-poll-results.yaml b/openapi/components/links/list-poll-results.yaml
index 53f6b63..1564324 100644
--- a/openapi/components/links/list-poll-results.yaml
+++ b/openapi/components/links/list-poll-results.yaml
@@ -1,4 +1,4 @@
-operationRef: 'list-poll-results'
+operationId: 'list-poll-results'
 parameters:
   pollId: $response.body#/id
 description: >
diff --git a/openapi/components/links/update-poll.yaml b/openapi/components/links/update-poll.yaml
index 5fa4781..373e1c9 100644
--- a/openapi/components/links/update-poll.yaml
+++ b/openapi/components/links/update-poll.yaml
@@ -1,4 +1,4 @@
-operationRef: 'update-poll'
+operationId: 'update-poll'
 parameters:
   pollId: $response.body#/id
 description: >