Update security finding triage specs (#3009)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com> 2b59847

Author: api-clients-generation-pipeline[bot]

_sources/datadog_api_client.v2.model.rst.txt

@@ -5289,13 +5289,6 @@ datadog\_api\_client.v2.model.create\_jira\_issue\_request\_array module
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.create\_jira\_issue\_request\_array\_included module
-----------------------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.create_jira_issue_request_array_included
-   :members:
-   :show-inheritance:
-
 datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data module
 -----------------------------------------------------------------------
 
@@ -5310,34 +5303,13 @@ datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data\_attributes mod
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data\_attributes\_fields module
--------------------------------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.create_jira_issue_request_data_attributes_fields
-   :members:
-   :show-inheritance:
-
 datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data\_relationships module
 --------------------------------------------------------------------------------------
 
 .. automodule:: datadog_api_client.v2.model.create_jira_issue_request_data_relationships
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data\_relationships\_case module
---------------------------------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case
-   :members:
-   :show-inheritance:
-
-datadog\_api\_client.v2.model.create\_jira\_issue\_request\_data\_relationships\_case\_data module
---------------------------------------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case_data
-   :members:
-   :show-inheritance:
-
 datadog\_api\_client.v2.model.create\_notification\_rule\_parameters module
 ---------------------------------------------------------------------------
 

datadog_api_client.html

@@ -3291,13 +3291,9 @@ <h2 id="subpackages">Subpackages<a class="headerlink" href="#subpackages" title=
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_incident_notification_rule_request">datadog_api_client.v2.model.create_incident_notification_rule_request module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_incident_notification_template_request">datadog_api_client.v2.model.create_incident_notification_template_request module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_array">datadog_api_client.v2.model.create_jira_issue_request_array module</a></li>
-<li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_array_included">datadog_api_client.v2.model.create_jira_issue_request_array_included module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data">datadog_api_client.v2.model.create_jira_issue_request_data module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data_attributes">datadog_api_client.v2.model.create_jira_issue_request_data_attributes module</a></li>
-<li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data_attributes_fields">datadog_api_client.v2.model.create_jira_issue_request_data_attributes_fields module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data_relationships">datadog_api_client.v2.model.create_jira_issue_request_data_relationships module</a></li>
-<li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case">datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case module</a></li>
-<li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case_data">datadog_api_client.v2.model.create_jira_issue_request_data_relationships_case_data module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_notification_rule_parameters">datadog_api_client.v2.model.create_notification_rule_parameters module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_notification_rule_parameters_data">datadog_api_client.v2.model.create_notification_rule_parameters_data module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="datadog_api_client.v2.model.html#module-datadog_api_client.v2.model.create_notification_rule_parameters_data_attributes">datadog_api_client.v2.model.create_notification_rule_parameters_data_attributes module</a></li>

datadog_api_client.v2.api.html

@@ -12196,10 +12196,11 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.attach_case">
 <span class="sig-name descname"><span class="pre">attach_case</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">case_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.attach_case_request.AttachCaseRequest" title="datadog_api_client.v2.model.attach_case_request.AttachCaseRequest"><span class="pre">AttachCaseRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response.FindingCaseResponse" title="datadog_api_client.v2.model.finding_case_response.FindingCaseResponse"><span class="pre">FindingCaseResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.attach_case" title="Link to this definition">¶</a></dt>
 <dd><p>Attach security findings to a case.</p>
-<p>Attach security findings to a case. You can attach up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the specified case.</p>
+<p>Attach security findings to a case.
+You can attach up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the specified case.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><p><strong>case_id</strong> (<em>str</em>) – The unique identifier of the case to attach security findings to</p>
+<dd class="field-odd"><p><strong>case_id</strong> (<em>str</em>) – Unique identifier of the case to attach security findings to</p>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
 <dd class="field-even"><p><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response.FindingCaseResponse" title="datadog_api_client.v2.model.finding_case_response.FindingCaseResponse">FindingCaseResponse</a></p>
@@ -12210,7 +12211,8 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.attach_jira_issue">
 <span class="sig-name descname"><span class="pre">attach_jira_issue</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.attach_jira_issue_request.AttachJiraIssueRequest" title="datadog_api_client.v2.model.attach_jira_issue_request.AttachJiraIssueRequest"><span class="pre">AttachJiraIssueRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response.FindingCaseResponse" title="datadog_api_client.v2.model.finding_case_response.FindingCaseResponse"><span class="pre">FindingCaseResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.attach_jira_issue" title="Link to this definition">¶</a></dt>
 <dd><p>Attach security findings to a Jira issue.</p>
-<p>Attach security findings to a Jira issue by providing the Jira issue URL. You can attach up to 50 security findings per Jira issue. If the Jira issue is not linked to any case, this operation will create a case for the security findings and link the Jira issue to the newly created case. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the specified Jira issue.</p>
+<p>Attach security findings to a Jira issue by providing the Jira issue URL.
+You can attach up to 50 security findings per Jira issue. If the Jira issue is not linked to any case, this operation will create a case for the security findings and link the Jira issue to the newly created case. To configure the Jira integration, see <a class="reference external" href="https://docs.datadoghq.com/security/ticketing_integrations/#bidirectional-ticket-syncing-with-jira">Bidirectional ticket syncing with Jira</a>. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the specified Jira issue.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response.FindingCaseResponse" title="datadog_api_client.v2.model.finding_case_response.FindingCaseResponse">FindingCaseResponse</a></p>
@@ -12285,7 +12287,8 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.create_cases">
 <span class="sig-name descname"><span class="pre">create_cases</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.create_case_request_array.CreateCaseRequestArray" title="datadog_api_client.v2.model.create_case_request_array.CreateCaseRequestArray"><span class="pre">CreateCaseRequestArray</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray" title="datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray"><span class="pre">FindingCaseResponseArray</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.create_cases" title="Link to this definition">¶</a></dt>
 <dd><p>Create cases for security findings.</p>
-<p>Create cases for security findings. You can create up to 50 cases per request and associate up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the newly created case.</p>
+<p>Create cases for security findings.
+You can create up to 50 cases per request and associate up to 50 security findings per case. Security findings that are already attached to another case will be detached from their previous case and attached to the newly created case.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray" title="datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray">FindingCaseResponseArray</a></p>
@@ -12307,7 +12310,8 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.create_jira_issues">
 <span class="sig-name descname"><span class="pre">create_jira_issues</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.create_jira_issue_request_array.CreateJiraIssueRequestArray" title="datadog_api_client.v2.model.create_jira_issue_request_array.CreateJiraIssueRequestArray"><span class="pre">CreateJiraIssueRequestArray</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray" title="datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray"><span class="pre">FindingCaseResponseArray</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.create_jira_issues" title="Link to this definition">¶</a></dt>
 <dd><p>Create Jira issues for security findings.</p>
-<p>Create Jira issues for security findings. This operation creates a case in Datadog and a Jira issue linked to that case for bidirectional sync between Datadog and Jira. You can create up to 50 Jira issues per request and associate up to 50 security findings per Jira issue. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the newly created Jira issue.</p>
+<p>Create Jira issues for security findings.
+This operation creates a case in Datadog and a Jira issue linked to that case for bidirectional sync between Datadog and Jira. To configure the Jira integration, see <a class="reference external" href="https://docs.datadoghq.com/security/ticketing_integrations/#bidirectional-ticket-syncing-with-jira">Bidirectional ticket syncing with Jira</a>. You can create up to 50 Jira issues per request and associate up to 50 security findings per Jira issue. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the newly created Jira issue.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray" title="datadog_api_client.v2.model.finding_case_response_array.FindingCaseResponseArray">FindingCaseResponseArray</a></p>
@@ -12490,7 +12494,8 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <dt class="sig sig-object py" id="datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.detach_case">
 <span class="sig-name descname"><span class="pre">detach_case</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.detach_case_request.DetachCaseRequest" title="datadog_api_client.v2.model.detach_case_request.DetachCaseRequest"><span class="pre">DetachCaseRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#datadog_api_client.v2.api.security_monitoring_api.SecurityMonitoringApi.detach_case" title="Link to this definition">¶</a></dt>
 <dd><p>Detach security findings from their case.</p>
-<p>Detach security findings from their case. This operation dissociates security findings from their associated cases without deleting the cases themselves. You can detach security findings from multiple different cases in a single request, with a limit of 50 security findings per request. Security findings that are not currently attached to any case will be ignored.</p>
+<p>Detach security findings from their case.
+This operation dissociates security findings from their associated cases without deleting the cases themselves. You can detach security findings from multiple different cases in a single request, with a limit of 50 security findings per request. Security findings that are not currently attached to any case will be ignored.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p>None</p>