From b02e64beda3b65384de3800940c2c5732733c111 Mon Sep 17 00:00:00 2001
From: peaklabs-dev <122374094+peaklabs-dev@users.noreply.github.com>
Date: Fri, 16 Jan 2026 18:24:12 +0100
Subject: [PATCH] docs(api): improve app endpoint deprecation description

---
 app/Http/Controllers/Api/ApplicationsController.php | 4 ++--
 openapi.json                                        | 4 ++--
 openapi.yaml                                        | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/app/Http/Controllers/Api/ApplicationsController.php b/app/Http/Controllers/Api/ApplicationsController.php
index 701c92d4d..799a622db 100644
--- a/app/Http/Controllers/Api/ApplicationsController.php
+++ b/app/Http/Controllers/Api/ApplicationsController.php
@@ -893,8 +893,8 @@ public function create_dockerimage_application(Request $request)
      * @deprecated Use POST /api/v1/services instead. This endpoint creates a Service, not an Application and is an unstable duplicate of POST /api/v1/services.
      */
     #[OA\Post(
-        summary: 'Create (Docker Compose) (Deprecated)',
-        description: 'Create new application based on a docker-compose file (without git).',
+        summary: 'Create (Docker Compose)',
+        description: 'Deprecated: Use POST /api/v1/services instead.',
         path: '/applications/dockercompose',
         operationId: 'create-dockercompose-application',
         deprecated: true,
diff --git a/openapi.json b/openapi.json
index 7bb1ff8f0..bd502865a 100644
--- a/openapi.json
+++ b/openapi.json
@@ -2082,8 +2082,8 @@
                 "tags": [
                     "Applications"
                 ],
-                "summary": "Create (Docker Compose) (Deprecated)",
-                "description": "Create new application based on a docker-compose file (without git).",
+                "summary": "Create (Docker Compose)",
+                "description": "Deprecated: Use POST \/api\/v1\/services instead.",
                 "operationId": "create-dockercompose-application",
                 "requestBody": {
                     "description": "Application object that needs to be created.",
diff --git a/openapi.yaml b/openapi.yaml
index 5d7adec32..11148f43b 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -1329,8 +1329,8 @@ paths:
     post:
       tags:
         - Applications
-      summary: 'Create (Docker Compose) (Deprecated)'
-      description: 'Create new application based on a docker-compose file (without git).'
+      summary: 'Create (Docker Compose)'
+      description: 'Deprecated: Use POST /api/v1/services instead.'
       operationId: create-dockercompose-application
       requestBody:
         description: 'Application object that needs to be created.'