---
title: "Update an attachment"
method: PUT
path: "/v1/attachments/{attachment-id}"
tags: ["Attachments"]
---

# Update an attachment

`PUT /v1/attachments/{attachment-id}`

Use the Edit Attachment REST request to make changes to the descriptive fields of an attachment, such as the description and the file name. You cannot change the actual content of the attached file in Zuora. If you need to change the actual content, you need to delete the attachment and add the updated file as a new attachment.

You can only use this operation if you have a Billing role that includes the Manage Attachments permission.
For more information, see [Billing roles](https://docs.zuora.com?resourceId=platform-billing-roles).
To change your Billing role, contact your Zuora platform administrator.

## Path parameters

- `attachment-id` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Request body

- PUTAttachmentType
  - `description` string — Description of the attachment.
  - `fileName` string — File name of the attachment. The value should not contain the file extension. Only the file name without the extension can be edited.

## Response `200`

OK

- CommonResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)