diff --git a/doc/apiv3-documentation.apib b/doc/apiv3-documentation.apib
index 2adba69c0c..7ad7eb0144 100644
--- a/doc/apiv3-documentation.apib
+++ b/doc/apiv3-documentation.apib
@@ -599,9 +599,18 @@ Updates an activity's comment and, on success, returns the updated activity.
                     "elements": [
                         {
                             "_links": {
-                                "self": { "href": "/api/v3/categories/10" },
-                                "project": { "href": "/api/v3/projects/11" },
-                                "defaultAssignee": { "href": "/api/v3/users/42" }
+                                "self": {
+                                    "href": "/api/v3/categories/10",
+                                    "title": "Category with assignee"
+                                },
+                                "project": {
+                                    "href": "/api/v3/projects/11",
+                                    "title": "Example project"
+                                },
+                                "defaultAssignee": {
+                                    "href": "/api/v3/users/42",
+                                    "title": "John Sheppard"
+                                }
                             },
                             "_type": "Category",
                             "id": 10,
@@ -654,9 +663,18 @@ Updates an activity's comment and, on success, returns the updated activity.
 
             {
                 "_links": {
-                    "self": { "href": "/api/v3/categories/10" },
-                    "project": { "href": "/api/v3/projects/11" },
-                    "defaultAssignee": { "href": "/api/v3/users/42" }
+                    "self": {
+                        "href": "/api/v3/categories/10",
+                        "title": "Category with assignee"
+                     },
+                    "project": {
+                        "href": "/api/v3/projects/11",
+                        "title": "Example project"
+                    },
+                    "defaultAssignee": {
+                        "href": "/api/v3/users/42",
+                        "title": "John Sheppard"
+                    }
                 },
                 "_type": "Category",
                 "id": 10,