---
title: API Catalog
description: Understand how to view, manage, and maintain API documentation in the API Catalog, including uploading, editing, deleting, and access permissions.
documentId: developer-portal-api-docs
locale: en-US
---

The documentation concerning your APIs that is exhibited in [**Products**](/docs/developer-portal/products) is also listed here in **API Catalog**.

Documentation is automatically loaded when your API is imported, but it is also possible to add it manually.

You may also edit and delete (only documentation that has been added manually) and visualize it.

<a id="_list_of_api_catalog"></a>
## List of API Catalog

Under the list of API Catalog you will find the following columns:

- **Vendor**: indicated by the icons: ![Sensedia's icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_sensedia_2756eef9a7.png) (Sensedia) and ![AWS' icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_aws_c7a28476ef.png) (AWS);
- **API Name**: the same name as [registered on your API Platform](/docs/api-platform/apis);
- **Version**: API version;
- **Last revision**: "rev" number;
- **Availability**: informs whether the API is available for display and to be used by an APP;
- **Actions**: you can edit, delete and view the documentation by clicking on the respective icon.

![screenshot from API Catalog](https://creative-ball-51b3fc85c0.media.strapiapp.com/api_docs_226efe5d30.png)

<Callout type="NOTE" title="NOTE">
The action icons for editing (![icon with the image of a pencil](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_edit_d513d970d7.png)) and deleting (![icon with the image of a trash can](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_delete_9f52a6a3b9.png)) are not available when the documentation has been automatically loaded with the API.
</Callout>

<a id="_search"></a>
### Search

The search field is located just above the list of API Catalog.

You can search the documentation by API name and sort the result in ascending or descending order.

<a id="_manual_upload"></a>
## Manual upload

To add documentation manually, follow the steps below:

<Steps>
  <Step>
    ### Step 1

    Under **API Catalog**, click the **+ NEW API Catalog** button.
  </Step>
  <Step>
    ### Step 2

    On the next screen, click **UPLOAD YOUR FILE**, located towards the bottom left part of the screen.
  </Step>
  <Step>
    ### Step 3

    Browse your files using the file manager from your operational system and select the desired .yaml or .json file. You may upload one file at a time.
  </Step>
  <Step>
    ### Step 4

    The selected file will be displayed on the screen. Click **SAVE** or **REPLACE FILE** to choose a different file.

    ![steps to add new documentation manually](https://creative-ball-51b3fc85c0.media.strapiapp.com/api_docs_add_new_c4dd732ae0.gif)
  </Step>
</Steps>

<a id="_viewing"></a>
## Viewing

To check your documentation, follow the steps below:

<Steps>
  <Step>
    ### Step 1

    Under **API Catalog**, click ![eye-shaped icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_view_22a42708ec.png).
  </Step>
  <Step>
    ### Step 2

    The next screen will display the latest version of that Swagger or OpenAPI. If more than one version is available, they will be listed at the top of the screen. Select the version you want to view.
  </Step>
</Steps>

As a result of these steps, the documentation will be loaded and displayed on the screen.

<a id="_editing_a_documentation"></a>
## Editing a documentation

To change the documentation, follow the steps below:

<Steps>
  <Step>
    ### Step 1

    Under **API Catalog**, click ![pencil-shaped icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_edit_d513d970d7.png).
  </Step>
  <Step>
    ### Step 2

    On the next screen, click the **REPLACE FILE** button.
  </Step>
  <Step>
    ### Step 3

    Browse your file manager and select the desired .yaml or .json file. You may upload one file at a time.
  </Step>
  <Step>
    ### Step 4

    Click **SAVE** or **SAVE AS NEW VERSION**.
  </Step>
</Steps>