From 784d767c5637f2a015c517325c72e46551146230 Mon Sep 17 00:00:00 2001
From: Sergey Skaridov <s.skaridov@gmail.com>
Date: Wed, 11 Oct 2023 17:53:21 +0300
Subject: [PATCH] add an integration filter to the cases list

---
 api.yaml                   | 48 ++++++++++++++++++++++++++++++++++++++
 paths/cases.yaml           | 32 +++++++++++++++++++++++++
 schemas/ExternalIssue.yaml | 13 +++++++++++
 schemas/TestCase.yaml      |  4 ++++
 4 files changed, 97 insertions(+)
 create mode 100644 schemas/ExternalIssue.yaml

diff --git a/api.yaml b/api.yaml
index b24e75a..db52e97 100644
--- a/api.yaml
+++ b/api.yaml
@@ -294,6 +294,38 @@ paths:
             A list of values separated by comma. Possible values: actual, draft deprecated
           schema:
             type: string
+        - in: query
+          name: 'external_issues[type]'
+          description: |
+            An integration type.
+          schema:
+            type: string
+            enum:
+              - asana
+              - azure-devops
+              - clickup-app
+              - github-app
+              - gitlab-app
+              - jira-cloud
+              - jira-server
+              - linear
+              - monday
+              - redmine-app
+              - trello-app
+              - youtrack-app
+        - in: query
+          name: 'external_issues[ids]'
+          description: A list of issue IDs.
+          schema:
+            type: array
+            items:
+              type: string
+        - in: query
+          name: include
+          description: |
+            A list of entities to include in response separated by comma. Possible values: external_issues.
+          schema:
+            type: string
         - $ref: '#/components/parameters/Code'
         - $ref: '#/components/parameters/Limit'
         - $ref: '#/components/parameters/Offset'
@@ -3728,6 +3760,22 @@ components:
           description: 'Deprecated, use the `updated_at` property instead.'
           type: string
           example: '2021-12-30T19:23:59.000000Z'
+        external_issues:
+          type: array
+          items:
+            type: object
+            properties:
+              type:
+                type: string
+              issues:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    id:
+                      type: string
+                    link:
+                      type: string
     TestCaseCreate:
       type: object
       properties:
diff --git a/paths/cases.yaml b/paths/cases.yaml
index d010f9f..c247b80 100644
--- a/paths/cases.yaml
+++ b/paths/cases.yaml
@@ -64,6 +64,38 @@ get:
         A list of values separated by comma. Possible values: actual, draft deprecated
       schema:
         type: string
+    - in: query
+      name: external_issues[type]
+      description: | 
+        An integration type.
+      schema:
+        type: string
+        enum:
+          - asana
+          - azure-devops
+          - clickup-app
+          - github-app
+          - gitlab-app
+          - jira-cloud
+          - jira-server
+          - linear
+          - monday
+          - redmine-app
+          - trello-app
+          - youtrack-app
+    - in: query
+      name: external_issues[ids]
+      description: A list of issue IDs.
+      schema:
+          type: array
+          items:
+            type: string
+    - in: query
+      name: include
+      description: |
+          A list of entities to include in response separated by comma. Possible values: external_issues.
+      schema:
+          type: string
     - $ref: '../parameters/Code.yaml'
     - $ref: '../parameters/pagination/Limit.yaml'
     - $ref: '../parameters/pagination/Offset.yaml'
diff --git a/schemas/ExternalIssue.yaml b/schemas/ExternalIssue.yaml
new file mode 100644
index 0000000..52874b8
--- /dev/null
+++ b/schemas/ExternalIssue.yaml
@@ -0,0 +1,13 @@
+type: object
+properties:
+  type:
+    type: string
+  issues:
+    type: array
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+        link:
+          type: string
diff --git a/schemas/TestCase.yaml b/schemas/TestCase.yaml
index 1fda09f..bb03876 100644
--- a/schemas/TestCase.yaml
+++ b/schemas/TestCase.yaml
@@ -95,3 +95,7 @@ properties:
     description: Deprecated, use the `updated_at` property instead.
     type: string
     example: "2021-12-30T19:23:59.000000Z"
+  external_issues:
+    type: array
+    items:
+      $ref: './ExternalIssue.yaml'