Removes an attachment from a case.
Namespace
goss.CaseManagement.v1.api.case.caseAttachment.caseAttachmentRemove
Worker
serverlibrary
Parameters
| Required Properties | Type | Description |
|---|---|---|
| caseBusinessKey | String <businessKey> | The business key of the case |
| caseAttachmentToDelete | Object | Details of the file |
| caseAttachmentToDelete.id | String | The file reference |
| user | Object | Details of the user |
| user.siteUserName | String | The username of the person who raised the case, or a valid case manager |
| Optional Properties | Type | Description |
| n/a | n/a | n/a |
{
"caseBusinessKey": "0123-4567-8901-2345",
"user": {
"siteUserName": "Abc"
},
"caseAttachmentToDelete": {
"id": "Abc"
}
}
Rules
| Rule | Validation error |
|---|---|
| User must exist | Could not retrieve siteUser details |
| Case must exist | Could not retrieve case Case 1234-5678-9012-3456 |
| Case must be active | User aUser does not have permissions to remove an attachment |
| User must be the case owner, a member of the case managers group or the case manager if one is assigned | User aUser does not have permissions to remove an attachment |
Behaviour
If the validation rules pass
- Removes the attachment from the case
- A system note will be recorded to case history documenting the removal
Last modified on 11 September 2026
