---
title: Managing inventoried APIs
summary: null
url: >-
https://www.fastly.com/documentation/guides/security/api-security/api-inventory/managing-inventoried-apis
---
API Inventory provides a curated view of your organization's APIs, allowing you to document, classify, and maintain a living catalog of your API landscape. You can add APIs to your inventory in two ways: by saving APIs that are automatically observed, monitored, and cataloged by API Discovery, or by uploading OpenAPI schemas through API Enforcement. Once you've [saved APIs to your inventory](https://www.fastly.com/documentation/guides/security/api-security/api-discovery/using-api-discovery#saving-discovered-apis-to-inventory) from the Discovery tab or [uploaded schemas](https://www.fastly.com/documentation/guides/security/api-security/api-enforcement/about-api-enforcement#schema-uploads-and-api-inventory) through API Enforcement, you can manage and organize them from the Inventory tab.
## Before you begin
API Inventory is available when you have either API Discovery or API Enforcement enabled on your service:
- **With API Discovery:** You should have APIs appearing in the Discovery view before you begin building your inventory. Our guide to [using API discovery](https://www.fastly.com/documentation/guides/security/api-security/api-discovery/using-api-discovery) provides more information on how to do this.
- **With API Enforcement:** You can add APIs to your inventory by uploading OpenAPI schemas. Our guide to [API Enforcement](https://www.fastly.com/documentation/guides/security/api-security/api-enforcement/about-api-enforcement#schema-uploads-and-api-inventory) provides more information on how to do this.
## About the API Inventory tab
The API Inventory tab displays your curated list of API operations, along with their associated attributes. Operations can come from API Discovery (automatically observed from traffic) or from OpenAPI schemas uploaded through API Enforcement. Collected API attributes include the domain, the URL path, the HTTP method, the tags you've applied to that API, and (for discovered APIs) the timestamp of the last time a request matching this particular API operation's attributes was discovered.
## Viewing inventoried APIs
The API Inventory tab allows you to view inventoried APIs in two ways: table view and tree view. You can switch between these views at any time without affecting the underlying data.
### About the views
**Table view** displays APIs as a flat, searchable table with one row per unique combination of domain, URL path, and HTTP method. This view is useful when you want to quickly scan all APIs at once, see recent activity with chronological sorting, or search for specific keywords.
**Tree view** organizes APIs hierarchically by domain, URL path segments, and HTTP method. This searchable view groups related endpoints together based on your API resource structure, making it easier to:
- navigate through large collections of APIs by their logical organization.
- identify all endpoints and operations associated with a specific resource or domain.
- understand the relationship between different API endpoints.
- surface older APIs that may not appear at the top of the chronologically-sorted list view.
For example, if your API Inventory has captured endpoints from both production (`api.example.com`) and staging (`staging-api.example.com`) environments, tree view groups them by domain and path structure:
```text
api.example.com/
└─ v1/
├─ inventory/
| └─ GET
│ └─ item/
│ └─ info/
│ ├─ GET
│ └─ DELETE
└─ system/
└─ health/
└─ GET
staging-api.example.com/
└─ v1/
└─ inventory/
└─ item/
└─ POST
```
This hierarchical organization reflects your own API architecture, making it easier to locate specific endpoints when working with large collections of inventoried APIs.
> **HINT:** Click branches in tree view to expand or collapse them.
### Switching between table view and tree view
To switch between table view and tree view:
1. Navigate to **Security** > **API Security** > **Inventory** in the Fastly control panel.
2. Click the table view (
) or tree view (
) icons at the top of the API Inventory tab.
The view preference is saved for your session. All search, filter, and export functionality works in both views.
## Viewing inventoried API details
To view details about an API that's been inventoried:
1. Navigate to **Security** > **API Security** > **Inventory** in the Fastly control panel.
2. From the services menu, select the appropriate service.
3. (Optional) Use the **Filter** menu to narrow the list of inventoried APIs by selecting one or more tags, a status, or other criteria.
4. Click **View** 
to the right of the relevant inventoried API. The Operation details page appears.
## Editing and tagging inventoried API details
To edit the details of an inventoried API, including adding tags it:
1. Navigate to **Security** > **API Security** > **Inventory** in the Fastly control panel.
2. Find the API you want to edit in the list that appears.
3. Click **View** to the right of the relevant inventoried API. The Operation details page appears.
4. Click **Edit operation**.
5. In the **Description** field, update the description of this API.
6. From the **Tag** field, select or enter the appropriate tags to apply to this API. You can also [create new tags](https://www.fastly.com/documentation/guides/security/api-security/api-inventory/managing-inventory-tags) if a tag you need doesn't exist yet.
7. Click **Save**. Your changes are saved and reflected in the API list.
## Removing APIs from the Inventory
To remove an API from the inventory:
1. Navigate to **Security** > **API Security** > **Inventory** in the Fastly control panel.
2. Find the API you want to remove in the list that appears.
3. Click **View** to the right of the relevant inventoried API. The Operation details page appears.
4. Click **Remove operation**.
5. Click **Confirm and remove**. The API is removed from your inventory.
> **HINT:** Removed APIs can be rediscovered. The next time API Discovery detects the API, it will once again appear in the list of discovered APIs. However, you'll need to re-inventory it to get it to appear in the list of inventoried APIs.
## Exporting inventoried APIs
To export your API reference:
1. Navigate to **Security** > **API Security** > **Inventory** in the Fastly control panel.
2. Click **Export** to download your inventoried APIs as a CSV file.
The exported CSV includes all APIs in your inventory along with all the context you've added: domains, paths, methods, descriptions, tags, and notes.
## Related content
- [API Discovery API documentation](https://www.fastly.com/documentation/reference/api/products/api_discovery/)