---
title: "Update Attachment for Malware"
method: PUT
path: "/api/v2/attachments/{attachment_id}"
tags: ["Attachments"]
---

# Update Attachment for Malware

`PUT /api/v2/attachments/{attachment_id}`

Toggles enabling or restricting agent access to attachments with detected malware.

#### Allowed For

* Admins

## Path parameters

- `attachment_id` integer, required

## Request body

- AttachmentUpdateRequest
  - `attachment` AttachmentUpdateInput
    - `malware_access_override` boolean — If true, allows access to attachments with detected malware.

## Response `200`

Success response

- AttachmentResponse
  - `attachment` AttachmentObject — A file represented as an [Attachment](/api-reference/ticketing/tickets/ticket-attachments/) object
    - `content_type` string — The content type of the image. Example value: "image/png"
    - `content_url` string — A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See [Working with url properties](/documentation/ticketing/managing-tickets/working-with-url-properties)
    - `deleted` boolean — If true, the attachment has been deleted
    - `file_name` string — The name of the image file
    - `height` integer — The height of the image file in pixels. If height is unknown, returns null
    - `id` integer — Automatically assigned when created
    - `inline` boolean — If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false
    - `malware_access_override` boolean — If true, you can download an attachment flagged as malware. If false, you can't download such an attachment.
    - `malware_scan_result` string — The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned"
    - `mapped_content_url` string — The URL the attachment image file has been mapped to
    - `size` integer — The size of the image file in bytes
    - `url` string — A URL to access the attachment details
    - `width` integer — The width of the image file in pixels. If width is unknown, returns null
    - `thumbnails` AttachmentBaseObject[] — An array of attachment objects. Note that photo thumbnails do not have thumbnails
      - `content_type` string — The content type of the image. Example value: "image/png"
      - `content_url` string — A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See [Working with url properties](/documentation/ticketing/managing-tickets/working-with-url-properties)
      - `deleted` boolean — If true, the attachment has been deleted
      - `file_name` string — The name of the image file
      - `height` integer — The height of the image file in pixels. If height is unknown, returns null
      - `id` integer — Automatically assigned when created
      - `inline` boolean — If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false
      - `malware_access_override` boolean — If true, you can download an attachment flagged as malware. If false, you can't download such an attachment.
      - `malware_scan_result` string — The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned"
      - `mapped_content_url` string — The URL the attachment image file has been mapped to
      - `size` integer — The size of the image file in bytes
      - `url` string — A URL to access the attachment details
      - `width` integer — The width of the image file in pixels. If width is unknown, returns null

---

[API](https://skmtc.net/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.net/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/botbrains-io/support-api/versions/d53eac07ba68/schema)