---
title: "API: Attachments and Print Copies"
description: The following article will cover how to use the API to configure Content Attachments and Print Copies Analysts.
---

[Skip to content](https://guide.contentcatalyst.com/api-attachments-and-print-copies#main-content)

![CC logo blue-1 (1)](https://guide.contentcatalyst.com/hs-fs/hubfs/CC%20logo%20blue-1%20(1).png?width=200&height=89&name=CC%20logo%20blue-1%20(1).png)

- [Guide & Help](https://guide.contentcatalyst.com/)
- [Main Website](https://contentcatalyst.com/)
- [Go to Customer Portal](https://guide.contentcatalyst.com/tickets-view)

Open main navigation

Close main navigation

- [Guide & Help](https://guide.contentcatalyst.com/)
- [Main Website](https://contentcatalyst.com/)
- [Go to Customer Portal](https://guide.contentcatalyst.com/tickets-view)
- [Main Website](https://contentcatalyst.com/)

[Main Website](https://contentcatalyst.com/)

 Learn all about the platform

- There are no suggestions because the search field is empty.

1. [Guide & Help](https://guide.contentcatalyst.com/?hsLang=en)
2. [Operations & Administration support](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en)
3. [API](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#api)

# API: Attachments and Print Copies

## The following article will cover how to use the API to configure Content Attachments and Print Copies Analysts.

 

**🔔Note:** Please note that the most efficient way to retrieve a list of products is by providing the `UpdatedSince` parameter when calling `GET` **~/api/v1/products** .

### Reading files

To read attachments, you can `GET` **~/api/v1/libraries/reports/products/{productCode}/attachments/{fileCode}**.

To read a print copy, you can download the default for each supported filetype (doc, pdf, xls or ppt) by calling `GET` **~/api/v1/libraries/reports/products/{productCode}/printcopies/{extension}**. If a print copy has been uploaded with that filetype, it will be returned, otherwise it will fall back to generating the default print copy (if any).

If a more recent version of the Office document has been uploaded (docx, pptx, xlsx), then it will be returned when requesting the traditional extensions (doc, ppt, xls). This follows the same behaviour as the UI.

If you don’t want a generated print copy, or if there is ambiguity, you can specify a specific file to download by providing the `fileCode` query parameter.

**🔔Note: ** The `fileCode` parameter can be retrieved by calling `GET` **~/api/v1/libraries/reports/products/{productCode}** with `includeToc` set to true.

### Uploading files

To upload attachments and print copies, use `POST` **~/api/v1/libraries/reports/products/{productCode}/imports**.

The request should contain two parts, one with Content-Disposition: form-data; name=”upload”; filename=”{filename}” and one with Content-Disposition: form-data; name=”upload\_data”.

The “upload” part should also have a Content-Type header to match the file you want to import.

The contents of the part should be the raw contents of the file you want to import.

The “upload\_data” part should contain a JSON object with one property “importType”. The “importType” property can take values “MainDeliverable”, “Attachment” or “PrintCopy”.

🚨**Warning**: **This endpoint does not accept Content-Type: application/json.** Your request must be Content-Type: multipart/form-data.

🚨**Warning: ** This operation only stores the uploaded file and validates that it could be processed.

It does not process it immediately.

You must call: **~/api/v1/libraries/reports/products/{productCode}/imports/{id}** until it returns “stage”: “Complete” for the file to be processed.

### Removing files<https://demo.contentcatalyst.com/_static/documentation/Integrations/use-cases/AttachmentsPrintCopies.html#removing-files>

To remove an attachment, you can call `DELETE` **~/api/v1/libraries/reports/products/{productCode}/attachments/{fileCode}**.

To remove a print copy, you can call `DELETE` **~/api/v1/libraries/reports/products/{productCode}/print-copy-files/{fileCode}**.

 

**🔔Note: ** The `fileCode` parameter can be retrieved by calling `GET` **~/api/v1/libraries/reports/products/{productCode}** with `includeToc` set to true.

- [Setting Up Your Content Catalyst Subscriber Portal](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#main-content)
  
  
  
  
  
    - [Onboarding](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#onboarding)
    - [Site Options](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#site-options)
    - [Showcase Page](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#showcase-page)
    - [Export Template Customisation & Branding](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#export-template-customisation-branding)
    - [Site Design & Branding](https://guide.contentcatalyst.com/setting-up-your-content-catalyst-subscriber-portal?hsLang=en#site-design-branding)
- [Site Authentication & User Registration](https://guide.contentcatalyst.com/site-authentication-user-registration?hsLang=en#main-content)
  
  
  
  
  
    - [Site Access](https://guide.contentcatalyst.com/site-authentication-user-registration?hsLang=en#site-access)
    - [User Registration](https://guide.contentcatalyst.com/site-authentication-user-registration?hsLang=en#user-registration)
    - [SSO](https://guide.contentcatalyst.com/site-authentication-user-registration?hsLang=en#sso)
- [Account & User Management](https://guide.contentcatalyst.com/account-user-management?hsLang=en#main-content)
  
  
  
  
  
    - [Account Creation & Management](https://guide.contentcatalyst.com/account-user-management?hsLang=en#account-creation-management)
    - [User Creation & Management](https://guide.contentcatalyst.com/account-user-management?hsLang=en#user-creation-management)
    - [Security](https://guide.contentcatalyst.com/account-user-management?hsLang=en#security)
    - [Account Manager Creation & Management](https://guide.contentcatalyst.com/account-user-management?hsLang=en#account-manager-creation-management)
    - [Guest Access](https://guide.contentcatalyst.com/account-user-management?hsLang=en#guest-access)
- [Licensing & Access Management](https://guide.contentcatalyst.com/licensing-access-management?hsLang=en#main-content)
  
  
  
  
  
    - [Creating & Managing Licenses](https://guide.contentcatalyst.com/licensing-access-management?hsLang=en#creating-managing-licenses)
    - [Prevent Full Downloads](https://guide.contentcatalyst.com/licensing-access-management?hsLang=en#prevent-full-downloads)
    - [Remote Access](https://guide.contentcatalyst.com/licensing-access-management?hsLang=en#remote-access)
    - [Restrict Export Formats](https://guide.contentcatalyst.com/licensing-access-management?hsLang=en#restrict-export-formats)
- [Organise, Categorise, and Link Content](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#main-content)
  
  
  
  
  
    - [Creating & Managing Category Trees](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#creating-managing-category-trees)
    - [Configuring Category Landing Pages](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#configuring-category-landing-pages)
    - [Category & Report Covers](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#category-report-covers)
    - [Chapters & Sections](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#chapters-sections)
    - [Analysts](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#analysts)
    - [Tags](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#tags)
    - [Report Series & Linked Reports](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#report-series-linked-reports)
    - [Promote Categories](https://guide.contentcatalyst.com/organise-categorise-and-link-content?hsLang=en#promote-categories)
- [Create & Deliver Content and Data](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#main-content)
  
  
  
  
  
    - [Report Metadata](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#report-metadata)
    - [Importing Content](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#importing-content)
    - [Instant Insights/Briefings](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#instant-insights-briefings)
    - [Interactive Docs](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#interactive-docs)
    - [DocuViewer](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#docuviewer)
    - [PDF/SlideViewer](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#pdf-slideviewer)
    - [Power BI](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#power-bi)
    - [Video Content](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#video-content)
    - [External Reports](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#external-reports)
    - [Publishing Workflow](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#publishing-workflow)
    - [DataViewer](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#dataviewer)
    - [RSS Feeds](https://guide.contentcatalyst.com/create-deliver-content-and-data?hsLang=en#rss-feeds)
- [Operations & Administration support](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#main-content)
  
  
  
  
  
    - [Domain Configuration](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#domain-configuration)
    - [Email Deliverability](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#email-deliverability)
    - [Search Configuration](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#search-configuration)
    - [Chargeback Codes](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#chargeback-codes)
    - [Policies & Notices](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#policies-notices)
    - [API](https://guide.contentcatalyst.com/operations-administration-support?hsLang=en#api)
- [Site Extensions & Integrations](https://guide.contentcatalyst.com/site-extensions-integrations?hsLang=en#main-content)
  
  
  
  
  
    - [CRM Integrations](https://guide.contentcatalyst.com/site-extensions-integrations?hsLang=en#crm-integrations)
    - [Integrations](https://guide.contentcatalyst.com/site-extensions-integrations?hsLang=en#integrations)
- [Tracking & Analytics of Subscriber Use](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#main-content)
  
  
  
  
  
    - [General](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#general)
    - [Report Access](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#report-access)
    - [Popular Searches](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#popular-searches)
    - [Tracking Snippets](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#tracking-snippets)
    - [Account Statistics](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#account-statistics)
    - [Analytics Sales Leads](https://guide.contentcatalyst.com/tracking-analytics-of-subscriber-use?hsLang=en#analytics-sales-leads)
- [Sales & Marketing](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#main-content)
  
  
  
  
  
    - [Email Customisation & Branding](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#email-customisation-branding)
    - [Buy It Now](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#buy-it-now)
    - [Instant Access Links](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#instant-access-links)
    - [Search Engine Verification](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#search-engine-verification)
    - [Trials](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#trials)
    - [Personalised Content Notifications](https://guide.contentcatalyst.com/sales-marketing?hsLang=en#personalised-content-notifications)
- [Content Discovery](https://guide.contentcatalyst.com/content-discovery?hsLang=en#main-content)
  
  
  
  
  
    - [Site Navigation](https://guide.contentcatalyst.com/content-discovery?hsLang=en#site-navigation)
    - [End-User Search](https://guide.contentcatalyst.com/content-discovery?hsLang=en#end-user-search)
    - [Categories & Tags](https://guide.contentcatalyst.com/content-discovery?hsLang=en#categories-tags)
    - [MyCatalyst](https://guide.contentcatalyst.com/content-discovery?hsLang=en#mycatalyst)
- [End-User Actions](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#main-content)
  
  
  
  
  
    - [Share Briefing](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#share-briefing)
    - [Ask The Analyst](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#ask-the-analyst)
    - [Collate & Export Content](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#collate-export-content)
    - [Share](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#share)
    - [Notes](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#notes)
    - [Translation](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#translation)
    - [User Profile](https://guide.contentcatalyst.com/end-user-actions?hsLang=en#user-profile)
- [RabbitMQ](https://guide.contentcatalyst.com/rabbitmq?hsLang=en#main-content)
  
  
  
  
  
    - [How to Use Rabbit MQ](https://guide.contentcatalyst.com/rabbitmq?hsLang=en#how-to-use-rabbit-mq)
    - [RabbitMQ: Events](https://guide.contentcatalyst.com/rabbitmq?hsLang=en#rabbitmq-events)

- [Main Website](https://contentcatalyst.com/)
- [Go to Customer Portal](https://guide.contentcatalyst.com/tickets-view)
- [Release Notes](https://guide.contentcatalyst.com/release-notes)
- [Raise a Ticket](https://guide.contentcatalyst.com/tickets-view/new?)

[![CC logo blue-1 (1)](https://guide.contentcatalyst.com/hs-fs/hubfs/CC%20logo%20blue-1%20(1).png?width=100&height=44&name=CC%20logo%20blue-1%20(1).png "CC logo blue-1 (1)")](http://contentcatalyst.com)

Energise your insights

<https://www.linkedin.com/company/content-catalyst>

Copyright © 2025, Content Catalyst Ltd.