diff --git a/src/Bundle/ChillPersonBundle/chill.api.specs.yaml b/src/Bundle/ChillPersonBundle/chill.api.specs.yaml
index edd4d0764..4755566a7 100644
--- a/src/Bundle/ChillPersonBundle/chill.api.specs.yaml
+++ b/src/Bundle/ChillPersonBundle/chill.api.specs.yaml
@@ -1672,6 +1672,38 @@ paths:
         422:
           description: "Invalid data: the data is a valid json, could be deserialized, but does not pass validation"
 
+  /1.0/relations/relationship/{id}.json:
+    patch:
+      tags:
+        - relationships
+      summary: "Alter a relationship"
+      parameters:
+        - name: id
+          in: path
+          required: true
+          description: The relationship's id
+          schema:
+            type: integer
+            format: integer
+            minimum: 1
+      requestBody:
+        description: "A relationship"
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/Relationship"
+      responses:
+        401:
+          description: "Unauthorized"
+        404:
+          description: "Not found"
+        200:
+          description: "OK"
+        422:
+          description: "Object with validation errors"
+
+
   /1.0/relations/relation.json:
     get:
       tags: