# Attachments

## 1. Create an Upload Slot

 - [GET /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/get-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 1. Create an Upload Slot

 - [POST /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/post-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint. Same behavior and response as GET /uploadmanager.newuploadslot.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 3. Delete an Upload Slot

 - [GET /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/get-delete-an-upload-slot.md): Deletes the upload slot that has been created using the /uploadmanager.newuploadslot (Create an Upload Slot) method and retrieves the file upload status, file version and other details.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 3. Delete an Upload Slot

 - [POST /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/post-delete-an-upload-slot.md): Deletes an upload slot and returns upload status information. Same behavior and response shape as GET /uploadmanager.deleteslot/{slot_id}.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 1. Create an Upload Slot

 - [GET /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/get-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 1. Create an Upload Slot

 - [POST /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint. Same behavior and response as GET /uploadmanager.newuploadslot.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 2. Upload a File

 - [POST /bdmanager.upload/{typedId}/{slotId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.upload-typedid-slotid.md): Uploads a file.

To upload a file you need to retrieve the slot ID using the /uploadmanager.newuploadslot (Create an Upload Slot) endpoint.

## 3. Delete an Upload Slot

 - [GET /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/get-delete-an-upload-slot.md): Deletes the upload slot that has been created using the /uploadmanager.newuploadslot (Create an Upload Slot) method and retrieves the file upload status, file version and other details.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 3. Delete an Upload Slot

 - [POST /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-delete-an-upload-slot.md): Deletes an upload slot and returns upload status information. Same behavior and response shape as GET /uploadmanager.deleteslot/{slot_id}.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## List Files

 - [POST /bdmanager.list/{typedId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.list-typedid.md): Retrieves details of the file(s) attached to the document (specified by typedId).

## Download a File

 - [POST /bdmanager.download/{typedId}/{binaryDataId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.download-typedid-id.md): Retrieves details of the file(s) attached to the document (specified by typedId).

## Download a File

 - [GET /bdmanager.download/{typedId}/{binaryDataId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/get-bdmanager.download-typedid-id.md): Retrieves details of the file(s) attached to the document (specified by typedId). Same behavior as POST /bdmanager.download/{typedId}/{binaryDataId}. If output=file is used, returns the binary file.

## Check a File

 - [POST /bdmanager.checkifexists/{binaryDataId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.checkifexists-binarydataid.md): Checks whether the file with the specified id exists. Returns true within the data property if the file exists.

## Update a File

 - [POST /bdmanager.update/{typedId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.update-typedid.md): Updates file's metadata (e.g., a file name).

## Delete a File

 - [POST /bdmanager.delete/{typedId}/{binaryDataId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager.delete-typedid.md): Deletes a file attached to the specified document.

## Download an Attachment

 - [GET /bdmanager.downloaddata/{binaryDataId}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/get-bdmanager.downloaddata-binarydataid.md): Downloads the binary data of the attachment.

## Get Upload Progress

 - [POST /uploadmanager.progress/{uploadslot}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-uploadmanager-progress.md): Returns current progress and status for a given upload slot.

## 2. Upload a File

 - [POST /bdmanager.edit/{ownerTypedId}/{binaryDataId}/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/attachments/post-bdmanager-edit.md): Replaces an existing attachment on a document with the file uploaded to the given upload slot. Mirrors /bdmanager.upload response shape.

## 1. Create an Upload Slot

 - [GET /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/get-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 1. Create an Upload Slot

 - [POST /uploadmanager.newuploadslot](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/post-uploadmanager.newuploadslot-ownertypedid.md): Returns a slot ID that is needed for the /bdmanager.upload/{typedId}/{slot_id}, or /productimages.upload/{slot_id}/{sku} (Upload a File) endpoint. Same behavior and response as GET /uploadmanager.newuploadslot.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 3. Delete an Upload Slot

 - [GET /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/get-delete-an-upload-slot.md): Deletes the upload slot that has been created using the /uploadmanager.newuploadslot (Create an Upload Slot) method and retrieves the file upload status, file version and other details.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot

## 3. Delete an Upload Slot

 - [POST /uploadmanager.deleteslot/{slot_id}](https://api.pricefx.com/openapi/reference/pricefx-server_openapi/product-image/post-delete-an-upload-slot.md): Deletes an upload slot and returns upload status information. Same behavior and response shape as GET /uploadmanager.deleteslot/{slot_id}.


>Information
>
>To upload a file you need to perform the following actions:
>1. Create an Upload Slot
>2. Upload a File
>3. Delete an Upload Slot