diff --git a/openapi/components/schemas/CreateApplicationRequest.yaml b/openapi/components/schemas/CreateApplicationRequest.yaml
index 7da2f38..9e76bc3 100644
--- a/openapi/components/schemas/CreateApplicationRequest.yaml
+++ b/openapi/components/schemas/CreateApplicationRequest.yaml
@@ -1,5 +1,10 @@
 type: object
 properties:
+  link:
+    description: true for an application link, false for a legacy application
+    type: boolean
+    default: "false"
+    enum: [ true, false ]
   description:
     description: description of the application
     type: string
@@ -16,6 +21,7 @@ properties:
     description: version of the application
     type: string
 example:
+  link: "false"
   version: "1.0"
   profileId: "2"
   token: "myapp"
diff --git a/openapi/paths/API@living@application.yaml b/openapi/paths/API@living@application.yaml
index 0e585db..8fa06b4 100644
--- a/openapi/paths/API@living@application.yaml
+++ b/openapi/paths/API@living@application.yaml
@@ -79,7 +79,7 @@ post:
   summary: Create a living application
   deprecated: true
   description: |
-    Create a living applications
+    Create a living application (legacy application or application link).
 
     Warning: as of 9.0.0, creating a living application using this API is deprecated.
   operationId: createApplication
@@ -95,7 +95,7 @@ post:
       content:
         application/json:
           schema:
-            $ref: '../components/schemas/LegacyApplication.yaml'
+            $ref: '../components/schemas/Application.yaml'
       description: "Success "
     '401':
       $ref: '../components/responses/Unauthorized.yaml'
diff --git a/openapi/paths/API@living@application@{id}.yaml b/openapi/paths/API@living@application@{id}.yaml
index 5407576..d9a1ba2 100644
--- a/openapi/paths/API@living@application@{id}.yaml
+++ b/openapi/paths/API@living@application@{id}.yaml
@@ -66,7 +66,7 @@ put:
   summary: Update a living application by ID
   deprecated: true
   description: |
-    Update a single application for the given ID
+    Update a single application for the given ID (legacy application or application link).
 
     Warning: as of 9.0.0, updating a living application using this API is deprecated.
   operationId: updateApplicationById
@@ -91,7 +91,7 @@ put:
       content:
         application/json:
           schema:
-            $ref: '../components/schemas/LegacyApplication.yaml'
+            $ref: '../components/schemas/Application.yaml'
       description: "Success "
     '401':
       $ref: '../components/responses/Unauthorized.yaml'