Attaching a documentation file to APIs

You can attach a file to APIs in the Developer Portal, and display them as documentation attachments. You can attach multiple files to APIs.

Before you begin

You must have administrator or content author access to complete this task.

About this task

You can attach only one file at a time. The default file upload size limit applies to the files that you want to attach, and you can attach up to 10 files to an API by default.
Note: You can change the default limit for the number of files that you want to attach.

An administrator can configure the types of file that are uploaded, and the number of files that a user can upload.

The following file types can be uploaded:
  • txt doc pdf
  • xls ppt pptx
  • docx xlsx rtf
  • odt ods odp md json
  • yaml tgz tar zip


  1. If the administrator dashboard is not displayed, click Manage to display it.
  2. Click Content in the administrator dashboard.
  3. Click Edit next to the API you want to attach the file to.
  4. In the Documentation section, click Browse and identify the file that you want to upload, then click Open.
  5. Click Upload, then click Save.
  6. Optional: Clear the Display checkbox for the file if you want to upload and attach the file to the API, but not show it in the Developer Portal.
  7. Optional: Enter a description for your file in the Description field. This description can be used as the label of the link to the file.
  8. Optional: If you uploaded multiple files, you can use the drag handle next to the file name to rearrange them.


You successfully attached a documentation file to your API.