Skip to content

Commit b7813de

Browse files
This release adds DeleteCase and DeleteRelatedItem APIs, which enable deleting cases and comments, undoing contact association, and removing service level agreements (SLAs) from cases. Contact center admins can use these APIs to delete cases when requested by customers and correct agent errors.
1 parent dd8d615 commit b7813de

18 files changed

+1594
-18
lines changed

generator/ServiceModels/connectcases/connectcases-2022-10-03.api.json

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -204,6 +204,24 @@
204204
],
205205
"idempotent":true
206206
},
207+
"DeleteCase":{
208+
"name":"DeleteCase",
209+
"http":{
210+
"method":"DELETE",
211+
"requestUri":"/domains/{domainId}/cases/{caseId}",
212+
"responseCode":200
213+
},
214+
"input":{"shape":"DeleteCaseRequest"},
215+
"output":{"shape":"DeleteCaseResponse"},
216+
"errors":[
217+
{"shape":"InternalServerException"},
218+
{"shape":"ResourceNotFoundException"},
219+
{"shape":"ValidationException"},
220+
{"shape":"ThrottlingException"},
221+
{"shape":"AccessDeniedException"}
222+
],
223+
"idempotent":true
224+
},
207225
"DeleteCaseRule":{
208226
"name":"DeleteCaseRule",
209227
"http":{
@@ -280,6 +298,24 @@
280298
],
281299
"idempotent":true
282300
},
301+
"DeleteRelatedItem":{
302+
"name":"DeleteRelatedItem",
303+
"http":{
304+
"method":"DELETE",
305+
"requestUri":"/domains/{domainId}/cases/{caseId}/related-items/{relatedItemId}",
306+
"responseCode":200
307+
},
308+
"input":{"shape":"DeleteRelatedItemRequest"},
309+
"output":{"shape":"DeleteRelatedItemResponse"},
310+
"errors":[
311+
{"shape":"InternalServerException"},
312+
{"shape":"ResourceNotFoundException"},
313+
{"shape":"ValidationException"},
314+
{"shape":"ThrottlingException"},
315+
{"shape":"AccessDeniedException"}
316+
],
317+
"idempotent":true
318+
},
283319
"DeleteTemplate":{
284320
"name":"DeleteTemplate",
285321
"http":{
@@ -1414,6 +1450,30 @@
14141450
"pattern":"^[a-zA-Z0-9_\\-\\.@:/ ]*[a-zA-Z0-9_\\-\\.@:/]$",
14151451
"sensitive":true
14161452
},
1453+
"DeleteCaseRequest":{
1454+
"type":"structure",
1455+
"required":[
1456+
"caseId",
1457+
"domainId"
1458+
],
1459+
"members":{
1460+
"caseId":{
1461+
"shape":"CaseId",
1462+
"location":"uri",
1463+
"locationName":"caseId"
1464+
},
1465+
"domainId":{
1466+
"shape":"DomainId",
1467+
"location":"uri",
1468+
"locationName":"domainId"
1469+
}
1470+
}
1471+
},
1472+
"DeleteCaseResponse":{
1473+
"type":"structure",
1474+
"members":{
1475+
}
1476+
},
14171477
"DeleteCaseRuleRequest":{
14181478
"type":"structure",
14191479
"required":[
@@ -1502,6 +1562,36 @@
15021562
"members":{
15031563
}
15041564
},
1565+
"DeleteRelatedItemRequest":{
1566+
"type":"structure",
1567+
"required":[
1568+
"caseId",
1569+
"domainId",
1570+
"relatedItemId"
1571+
],
1572+
"members":{
1573+
"caseId":{
1574+
"shape":"CaseId",
1575+
"location":"uri",
1576+
"locationName":"caseId"
1577+
},
1578+
"domainId":{
1579+
"shape":"DomainId",
1580+
"location":"uri",
1581+
"locationName":"domainId"
1582+
},
1583+
"relatedItemId":{
1584+
"shape":"RelatedItemId",
1585+
"location":"uri",
1586+
"locationName":"relatedItemId"
1587+
}
1588+
}
1589+
},
1590+
"DeleteRelatedItemResponse":{
1591+
"type":"structure",
1592+
"members":{
1593+
}
1594+
},
15051595
"DeleteTemplateRequest":{
15061596
"type":"structure",
15071597
"required":[

generator/ServiceModels/connectcases/connectcases-2022-10-03.docs.json

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,19 @@
55
"BatchGetCaseRule": "<p>Gets a batch of case rules. In the Amazon Connect admin website, case rules are known as <i>case field conditions</i>. For more information about case field conditions, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/case-field-conditions.html\">Add case field conditions to a case template</a>.</p>",
66
"BatchGetField": "<p>Returns the description for the list of fields in the request parameters. </p>",
77
"BatchPutFieldOptions": "<p>Creates and updates a set of field options for a single select field in a Cases domain.</p>",
8-
"CreateCase": "<note> <p>If you provide a value for <code>PerformedBy.UserArn</code> you must also have <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html\">connect:DescribeUser</a> permission on the User ARN resource that you provide</p> </note> <p>Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types.</p> <p>The following fields are required when creating a case:</p> <ul> <li> <p> <code>customer_id</code> - You must provide the full customer profile ARN in this format: <code>arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID</code> </p> </li> <li> <p> <code>title</code> </p> </li> </ul>",
8+
"CreateCase": "<p><note> <p>If you provide a value for <code>PerformedBy.UserArn</code> you must also have <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html\">connect:DescribeUser</a> permission on the User ARN resource that you provide</p> </note> <p>Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types.</p> <p>The following fields are required when creating a case:</p> <ul> <li> <p> <code>customer_id</code> - You must provide the full customer profile ARN in this format: <code>arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID</code> </p> </li> <li> <p> <code>title</code> </p> </li> </ul></p>",
99
"CreateCaseRule": "<p>Creates a new case rule. In the Amazon Connect admin website, case rules are known as <i>case field conditions</i>. For more information about case field conditions, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/case-field-conditions.html\">Add case field conditions to a case template</a>.</p>",
1010
"CreateDomain": "<p>Creates a domain, which is a container for all case data, such as cases, fields, templates and layouts. Each Amazon Connect instance can be associated with only one Cases domain.</p> <important> <p>This will not associate your connect instance to Cases domain. Instead, use the Amazon Connect <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html\">CreateIntegrationAssociation</a> API. You need specific IAM permissions to successfully associate the Cases domain. For more information, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/required-permissions-iam-cases.html#onboard-cases-iam\">Onboard to Cases</a>.</p> </important>",
1111
"CreateField": "<p>Creates a field in the Cases domain. This field is used to define the case object model (that is, defines what data can be captured on cases) in a Cases domain. </p>",
1212
"CreateLayout": "<p>Creates a layout in the Cases domain. Layouts define the following configuration in the top section and More Info tab of the Cases user interface:</p> <ul> <li> <p>Fields to display to the users</p> </li> <li> <p>Field ordering</p> </li> </ul> <note> <p>Title and Status fields cannot be part of layouts since they are not configurable.</p> </note>",
1313
"CreateRelatedItem": "<p>Creates a related item (comments, tasks, and contacts) and associates it with a case.</p> <note> <ul> <li> <p>A Related Item is a resource that is associated with a case. It may or may not have an external identifier linking it to an external resource (for example, a <code>contactArn</code>). All Related Items have their own internal identifier, the <code>relatedItemArn</code>. Examples of related items include <code>comments</code> and <code>contacts</code>.</p> </li> <li> <p>If you provide a value for <code>performedBy.userArn</code> you must also have <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html\">DescribeUser</a> permission on the ARN of the user that you provide.</p> </li> <li> <p>The <code>type</code> field is reserved for internal use only.</p> </li> </ul> </note>",
1414
"CreateTemplate": "<p>Creates a template in the Cases domain. This template is used to define the case object model (that is, to define what data can be captured on cases) in a Cases domain. A template must have a unique name within a domain, and it must reference existing field IDs and layout IDs. Additionally, multiple fields with same IDs are not allowed within the same Template. A template can be either Active or Inactive, as indicated by its status. Inactive templates cannot be used to create cases.</p> <p> Other template APIs are: </p> <ul> <li> <p> <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_DeleteTemplate.html\">DeleteTemplate</a> </p> </li> <li> <p> <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_GetTemplate.html\">GetTemplate</a> </p> </li> <li> <p> <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_ListTemplates.html\">ListTemplates</a> </p> </li> <li> <p> <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_UpdateTemplate.html\">UpdateTemplate</a> </p> </li> </ul>",
15+
"DeleteCase": "<p> The DeleteCase API permanently deletes a case and all its associated resources from the cases data store. After a successful deletion, you cannot:</p> <ul> <li> <p>Retrieve related items</p> </li> <li> <p>Access audit history</p> </li> <li> <p>Perform any operations that require the CaseID</p> </li> </ul> <important> <p>This action is irreversible. Once you delete a case, you cannot recover its data.</p> </important>",
1516
"DeleteCaseRule": "<p>Deletes a case rule. In the Amazon Connect admin website, case rules are known as <i>case field conditions</i>. For more information about case field conditions, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/case-field-conditions.html\">Add case field conditions to a case template</a>.</p>",
1617
"DeleteDomain": "<p>Deletes a Cases domain.</p> <note> <p>After deleting your domain you must disassociate the deleted domain from your Amazon Connect instance with another API call before being able to use Cases again with this Amazon Connect instance. See <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html\">DeleteIntegrationAssociation</a>.</p> </note>",
1718
"DeleteField": "<p>Deletes a field from a cases template. You can delete up to 100 fields per domain.</p> <p>After a field is deleted:</p> <ul> <li> <p>You can still retrieve the field by calling <code>BatchGetField</code>.</p> </li> <li> <p>You cannot update a deleted field by calling <code>UpdateField</code>; it throws a <code>ValidationException</code>.</p> </li> <li> <p>Deleted fields are not included in the <code>ListFields</code> response.</p> </li> <li> <p>Calling <code>CreateCase</code> with a deleted field throws a <code>ValidationException</code> denoting which field IDs in the request have been deleted.</p> </li> <li> <p>Calling <code>GetCase</code> with a deleted field ID returns the deleted field's value if one exists.</p> </li> <li> <p>Calling <code>UpdateCase</code> with a deleted field ID throws a <code>ValidationException</code> if the case does not already contain a value for the deleted field. Otherwise it succeeds, allowing you to update or remove (using <code>emptyValue: {}</code>) the field's value from the case.</p> </li> <li> <p> <code>GetTemplate</code> does not return field IDs for deleted fields.</p> </li> <li> <p> <code>GetLayout</code> does not return field IDs for deleted fields.</p> </li> <li> <p>Calling <code>SearchCases</code> with the deleted field ID as a filter returns any cases that have a value for the deleted field that matches the filter criteria.</p> </li> <li> <p>Calling <code>SearchCases</code> with a <code>searchTerm</code> value that matches a deleted field's value on a case returns the case in the response.</p> </li> <li> <p>Calling <code>BatchPutFieldOptions</code> with a deleted field ID throw a <code>ValidationException</code>.</p> </li> <li> <p>Calling <code>GetCaseEventConfiguration</code> does not return field IDs for deleted fields.</p> </li> </ul>",
1819
"DeleteLayout": "<p>Deletes a layout from a cases template. You can delete up to 100 layouts per domain.</p> <p>After a layout is deleted:</p> <ul> <li> <p>You can still retrieve the layout by calling <code>GetLayout</code>.</p> </li> <li> <p>You cannot update a deleted layout by calling <code>UpdateLayout</code>; it throws a <code>ValidationException</code>.</p> </li> <li> <p>Deleted layouts are not included in the <code>ListLayouts</code> response.</p> </li> </ul>",
20+
"DeleteRelatedItem": "<p>Deletes the related item resource under a case.</p> <note> <p>This API cannot be used on a FILE type related attachment. To delete this type of file, use the <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteAttachedFile.html\">DeleteAttachedFile</a> API</p> </note>",
1921
"DeleteTemplate": "<p>Deletes a cases template. You can delete up to 100 templates per domain.</p> <p>After a cases template is deleted:</p> <ul> <li> <p>You can still retrieve the template by calling <code>GetTemplate</code>.</p> </li> <li> <p>You cannot update the template. </p> </li> <li> <p>You cannot create a case by using the deleted template.</p> </li> <li> <p>Deleted templates are not included in the <code>ListTemplates</code> response.</p> </li> </ul>",
2022
"GetCase": "<p>Returns information about a specific case if it exists. </p>",
2123
"GetCaseAuditEvents": "<p>Returns the audit history about a specific case if it exists.</p>",
@@ -36,7 +38,7 @@
3638
"SearchRelatedItems": "<p>Searches for related items that are associated with a case.</p> <note> <p>If no filters are provided, this returns all related items associated with a case.</p> </note>",
3739
"TagResource": "<p>Adds tags to a resource.</p>",
3840
"UntagResource": "<p>Untags a resource.</p>",
39-
"UpdateCase": "<note> <p>If you provide a value for <code>PerformedBy.UserArn</code> you must also have <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html\">connect:DescribeUser</a> permission on the User ARN resource that you provide</p> </note> <p>Updates the values of fields on a case. Fields to be updated are received as an array of id/value pairs identical to the <code>CreateCase</code> input .</p> <p>If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.</p>",
41+
"UpdateCase": "<p><note> <p>If you provide a value for <code>PerformedBy.UserArn</code> you must also have <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html\">connect:DescribeUser</a> permission on the User ARN resource that you provide</p> </note> <p>Updates the values of fields on a case. Fields to be updated are received as an array of id/value pairs identical to the <code>CreateCase</code> input .</p> <p>If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.</p></p>",
4042
"UpdateCaseRule": "<p>Updates a case rule. In the Amazon Connect admin website, case rules are known as <i>case field conditions</i>. For more information about case field conditions, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/case-field-conditions.html\">Add case field conditions to a case template</a>.</p>",
4143
"UpdateField": "<p>Updates the properties of an existing field. </p>",
4244
"UpdateLayout": "<p>Updates the attributes of an existing layout.</p> <p>If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.</p> <p>A <code>ValidationException</code> is returned when you add non-existent <code>fieldIds</code> to a layout.</p> <note> <p>Title and Status fields cannot be part of layouts because they are not configurable.</p> </note>",
@@ -278,6 +280,8 @@
278280
"CaseSummary$caseId": "<p>A unique identifier of the case.</p>",
279281
"CreateCaseResponse$caseId": "<p>A unique identifier of the case.</p>",
280282
"CreateRelatedItemRequest$caseId": "<p>A unique identifier of the case.</p>",
283+
"DeleteCaseRequest$caseId": "<p>A unique identifier of the case.</p>",
284+
"DeleteRelatedItemRequest$caseId": "<p>A unique identifier of the case.</p>",
281285
"GetCaseAuditEventsRequest$caseId": "<p>A unique identifier of the case.</p>",
282286
"GetCaseRequest$caseId": "<p>A unique identifier of the case.</p>",
283287
"SearchCasesResponseItem$caseId": "<p>A unique identifier of the case.</p>",
@@ -536,6 +540,16 @@
536540
"UserUnion$customEntity": "<p>Any provided entity.</p>"
537541
}
538542
},
543+
"DeleteCaseRequest": {
544+
"base": null,
545+
"refs": {
546+
}
547+
},
548+
"DeleteCaseResponse": {
549+
"base": null,
550+
"refs": {
551+
}
552+
},
539553
"DeleteCaseRuleRequest": {
540554
"base": null,
541555
"refs": {
@@ -576,6 +590,16 @@
576590
"refs": {
577591
}
578592
},
593+
"DeleteRelatedItemRequest": {
594+
"base": null,
595+
"refs": {
596+
}
597+
},
598+
"DeleteRelatedItemResponse": {
599+
"base": null,
600+
"refs": {
601+
}
602+
},
579603
"DeleteTemplateRequest": {
580604
"base": null,
581605
"refs": {
@@ -616,10 +640,12 @@
616640
"CreateLayoutRequest$domainId": "<p>The unique identifier of the Cases domain. </p>",
617641
"CreateRelatedItemRequest$domainId": "<p>The unique identifier of the Cases domain. </p>",
618642
"CreateTemplateRequest$domainId": "<p>The unique identifier of the Cases domain. </p>",
643+
"DeleteCaseRequest$domainId": "<p>A unique identifier of the Cases domain.</p>",
619644
"DeleteCaseRuleRequest$domainId": "<p>Unique identifier of a Cases domain.</p>",
620645
"DeleteDomainRequest$domainId": "<p>The unique identifier of the Cases domain. </p>",
621646
"DeleteFieldRequest$domainId": "<p>The unique identifier of the Cases domain.</p>",
622647
"DeleteLayoutRequest$domainId": "<p>The unique identifier of the Cases domain.</p>",
648+
"DeleteRelatedItemRequest$domainId": "<p>A unique identifier of the Cases domain.</p>",
623649
"DeleteTemplateRequest$domainId": "<p>The unique identifier of the Cases domain.</p>",
624650
"DomainSummary$domainId": "<p>The unique identifier of the domain.</p>",
625651
"GetCaseAuditEventsRequest$domainId": "<p>The unique identifier of the Cases domain.</p>",
@@ -1294,6 +1320,7 @@
12941320
"base": null,
12951321
"refs": {
12961322
"CreateRelatedItemResponse$relatedItemId": "<p>The unique identifier of the related item.</p>",
1323+
"DeleteRelatedItemRequest$relatedItemId": "<p>A unique identifier of a related item.</p>",
12971324
"SearchRelatedItemsResponseItem$relatedItemId": "<p>Unique identifier of a related item.</p>"
12981325
}
12991326
},

0 commit comments

Comments
 (0)