fix(openapi): remove /delete route; add POST action=delete tombstone for org team

Author: marblom007

schemas/constructs/v1beta1/organization/api.yml

@@ -29,20 +29,28 @@ paths:
           description: Internal server error
 
   /api/identity/orgs/{orgID}/teams/{teamId}:
-    delete:
-      summary: Remove team from organization
-      description: Removes (unassigns) a team from an organization.
-      operationId: RemoveTeamFromOrg
+    post:
+      summary: Add team to organization or soft delete team
+      description: Adds a team to an organization. If request body contains action=delete, tombstones a team by setting its deleted_at timestamp. The team's organization mapping remains intact.
+      operationId: AddTeamToOrg
       parameters:
         - $ref: "#/components/parameters/orgID"
         - $ref: "#/components/parameters/teamId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/OrgTeamActionPayload"
       responses:
         "200":
-          description: Team removed from organization
+          description: Team added to organization or team tombstoned
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TeamsOrganizationsMappingPage"
+                oneOf:
+                  - $ref: "#/components/schemas/TeamsOrganizationsMappingPage"
+                  - $ref: "#/components/schemas/TeamsPage"
         "400":
           description: Bad request
         "401":
@@ -52,21 +60,20 @@ paths:
         "500":
           description: Internal server error
 
-  /api/identity/orgs/{orgID}/teams/{teamId}/delete:
-    post:
-      summary: Soft delete team
-      description: Tombstones a team by setting its deleted_at timestamp. The team's organization mapping remains intact.
-      operationId: DeleteTeam
+    delete:
+      summary: Remove team from organization
+      description: Removes (unassigns) a team from an organization.
+      operationId: RemoveTeamFromOrg
       parameters:
         - $ref: "#/components/parameters/orgID"
         - $ref: "#/components/parameters/teamId"
       responses:
         "200":
-          description: Team tombstoned
+          description: Team removed from organization
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TeamsPage"
+                $ref: "#/components/schemas/TeamsOrganizationsMappingPage"
         "400":
           description: Bad request
         "401":
@@ -108,6 +115,16 @@ components:
     MapObject:
       $ref: "../../v1alpha1/core/api.yml#/components/schemas/MapObject"
 
+    OrgTeamActionPayload:
+      type: object
+      description: Optional action payload for POST on /api/identity/orgs/{orgID}/teams/{teamId}.
+      properties:
+        action:
+          type: string
+          description: Internal action to perform on the team resource.
+          enum:
+            - delete
+
     Location:
       type: object
       required:
@@ -260,7 +277,7 @@ components:
         updated_at:
           $ref: "#/components/schemas/Time"
         deleted_at:
-          $ref: "#/components/schemas/Time"
+          $ref: "#/components/schemas/NullableTime"
 
     TeamsPage:
       type: object
@@ -290,7 +307,7 @@ components:
         updated_at:
           $ref: "#/components/schemas/Time"
         deleted_at:
-          $ref: "#/components/schemas/Time"
+          $ref: "#/components/schemas/NullableTime"
 
     TeamsOrganizationsMappingPage:
       type: object