---
title: "Add Documents to an API Proxy"
description: "Add supporting documentation, usage guides, and version history to an API proxy before publishing it to the Developer Portal."
canonical_url: https://wso2.com/api-platform/docs/cloud/develop-api-proxy/documents/
md_url: https://wso2.com/api-platform/docs/cloud/develop-api-proxy/documents.md
tags:
  - cloud
  - api-proxy
  - documentation
author: WSO2 API Platform Documentation Team
last_updated: 2026-06-18
content_type: "how-to"
---

# Documents

When an API consumer signs in to the API Platform Developer Portal to browse APIs, it is not sufficient to just have an API thumbnail along with the name and version of the API. An API consumer would expect to see more details about the API, such as the following:

- A brief description of the API.
- How to invoke the API.
- The limitations/restrictions of the API.
- Version history.

To provide such information that improves the overall visibility of the API, an API developer can add such documentation to an API before publishing it to the Developer Portal.

## Add Documents to an API

To add documentation for an API, follow the steps given below.

1. Sign in to the [API Platform Console](https://console.bijira.dev/).

2. Select the project and the API that you want to add documentation.

3. In the left navigation menu, click **Develop** and then click **Documents**.

4. Click **Create Document**.

5. Specify document name and document type for the document and provide the content in markdown syntax.

6. Click **Create** to save the document.

    ![Documents page showing Developer Documents tab with a document list and content preview panel](../../assets/img/develop-api-proxy/documents.png)

Depending on the information you need to add to the API, you can add one or more documents.

You can also edit existing documents and delete documents if necessary.