[Docs] Update REST API Documentation

Signed-off-by: meshery <ci@meshery.io>

Author: leecalcote

data/openapi.yml

@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   title: Meshery Cloud
   description: Documentation for Meshery Cloud REST APIs.
-  version: v1.2.6
+  version: v1.2.7
   contact:
     name: Meshery Maintainers
     email: maintainers@meshery.io
@@ -3880,74 +3880,6 @@ paths:
                             x-oapi-codegen-extra-tags:
                               db: deleted_at
                               json: deleted_at
-              example:
-                id: "923458-3490394-934893"
-                type: "learning-path"
-                org_id: "layer5"
-                visibility: "public"
-                status: "ready"
-                slug: "intro-kubernetes-course"
-                level: "beginner"
-                badge_id: "00000000-0000-0000-0000-000000000000"
-                invite_id: "00000000-0000-0000-0000-000000000000"
-                workspace_id: "00000000-0000-0000-0000-000000000000"
-                created_at: "2026-04-24T00:00:00Z"
-                updated_at: "2026-04-24T00:00:00Z"
-                deleted_at: null
-                metadata:
-                  title: "Mastering Kubernetes for Engineers"
-                  description: "Learn how to configure your Kubernetes clusters and manage the lifecycle of your\nworkloads"
-                  detailedDescription: "This learning path covers everything from Kubernetes architecture to advanced\ndeployment strategies, including hands-on labs and real-world scenarios."
-                  banner: "kubernetes-icon.svg"
-                  permalink: "http://localhost:9876/academy/learning-paths/layer5/mastering-kubernetes-for-engineers/"
-                  certificate:
-                    id: "550e8400-e29b-41d4-a716-446655440000"
-                    orgId: "00000000-0000-0000-0000-000000000000"
-                    recipientId: "550e8400-e29b-41d4-a716-446655440001"
-                    recipientName: "John Doe"
-                    title: "Kubernetes Expert Certification"
-                    description: "Awarded for successfully completing the Kubernetes Expert course"
-                    issuingAuthorities:
-                      -
-                        name: "Cloud Native Foundation"
-                        role: "COO"
-                        signatureUrl: "http://localhost:9876/signatures/cloud-native-foundation.png"
-                    issuedDate: "2023-10-01 12:00:00+00:00"
-                    expirationDate: "2025-10-01 12:00:00+00:00"
-                    expiresIn: 24
-                  children:
-                    -
-                      id: "550e8400-e29b-41d4-a716-446655440002"
-                      title: "Kubernetes Basics"
-                      permalink: "http://localhost:9876/academy/learning-paths/layer5/intro-kubernetes-course/kubernetes/"
-                      description: "Learn the basics of Kubernetes"
-                      weight: "eg 1 , 2"
-                      banner: "kubernetes-icon.svg"
-                      type: "learning-path"
-                      children:
-                        -
-                registration_count: 0
-                invitation:
-                  id: "00000000-0000-0000-0000-000000000000"
-                  owner_id: "00000000-0000-0000-0000-000000000000"
-                  is_default: false
-                  name: "string"
-                  description: "string"
-                  emails:
-                    - "string"
-                  org_id: "00000000-0000-0000-0000-000000000000"
-                  expires_at: "2026-04-24T00:00:00Z"
-                  quota: 0
-                  accepted_by:
-                    - "string"
-                  roles:
-                    - "string"
-                  teams:
-                    - "string"
-                  status: "enabled"
-                  created_at: "2026-04-24T00:00:00Z"
-                  updated_at: "2026-04-24T00:00:00Z"
-                  deleted_at: null
         '400':
           description: Invalid request parameters
         '401':
@@ -4565,74 +4497,6 @@ paths:
                             x-oapi-codegen-extra-tags:
                               db: deleted_at
                               json: deleted_at
-              example:
-                id: "923458-3490394-934893"
-                type: "learning-path"
-                org_id: "layer5"
-                visibility: "public"
-                status: "ready"
-                slug: "intro-kubernetes-course"
-                level: "beginner"
-                badge_id: "00000000-0000-0000-0000-000000000000"
-                invite_id: "00000000-0000-0000-0000-000000000000"
-                workspace_id: "00000000-0000-0000-0000-000000000000"
-                created_at: "2026-04-24T00:00:00Z"
-                updated_at: "2026-04-24T00:00:00Z"
-                deleted_at: null
-                metadata:
-                  title: "Mastering Kubernetes for Engineers"
-                  description: "Learn how to configure your Kubernetes clusters and manage the lifecycle of your\nworkloads"
-                  detailedDescription: "This learning path covers everything from Kubernetes architecture to advanced\ndeployment strategies, including hands-on labs and real-world scenarios."
-                  banner: "kubernetes-icon.svg"
-                  permalink: "http://localhost:9876/academy/learning-paths/layer5/mastering-kubernetes-for-engineers/"
-                  certificate:
-                    id: "550e8400-e29b-41d4-a716-446655440000"
-                    orgId: "00000000-0000-0000-0000-000000000000"
-                    recipientId: "550e8400-e29b-41d4-a716-446655440001"
-                    recipientName: "John Doe"
-                    title: "Kubernetes Expert Certification"
-                    description: "Awarded for successfully completing the Kubernetes Expert course"
-                    issuingAuthorities:
-                      -
-                        name: "Cloud Native Foundation"
-                        role: "COO"
-                        signatureUrl: "http://localhost:9876/signatures/cloud-native-foundation.png"
-                    issuedDate: "2023-10-01 12:00:00+00:00"
-                    expirationDate: "2025-10-01 12:00:00+00:00"
-                    expiresIn: 24
-                  children:
-                    -
-                      id: "550e8400-e29b-41d4-a716-446655440002"
-                      title: "Kubernetes Basics"
-                      permalink: "http://localhost:9876/academy/learning-paths/layer5/intro-kubernetes-course/kubernetes/"
-                      description: "Learn the basics of Kubernetes"
-                      weight: "eg 1 , 2"
-                      banner: "kubernetes-icon.svg"
-                      type: "learning-path"
-                      children:
-                        -
-                registration_count: 0
-                invitation:
-                  id: "00000000-0000-0000-0000-000000000000"
-                  owner_id: "00000000-0000-0000-0000-000000000000"
-                  is_default: false
-                  name: "string"
-                  description: "string"
-                  emails:
-                    - "string"
-                  org_id: "00000000-0000-0000-0000-000000000000"
-                  expires_at: "2026-04-24T00:00:00Z"
-                  quota: 0
-                  accepted_by:
-                    - "string"
-                  roles:
-                    - "string"
-                  teams:
-                    - "string"
-                  status: "enabled"
-                  created_at: "2026-04-24T00:00:00Z"
-                  updated_at: "2026-04-24T00:00:00Z"
-                  deleted_at: null
         '400':
           description: Invalid request parameters
         '401':
@@ -12325,18 +12189,6 @@ paths:
                               x-go-type-import:
                                 path: database/sql
                               x-go-type-skip-optional-pointer: true
-              example:
-                page: 0
-                pageSize: 0
-                totalCount: 0
-                teamsOrganizationsMapping:
-                  -
-                    id: "00000000-0000-0000-0000-000000000000"
-                    orgId: "00000000-0000-0000-0000-000000000000"
-                    teamId: "00000000-0000-0000-0000-000000000000"
-                    createdAt: "2026-04-24T00:00:00Z"
-                    updatedAt: "2026-04-24T00:00:00Z"
-                    deletedAt: "2026-04-24T00:00:00Z"
         '400':
           description: Bad request
         '401':