---
title: Discovery | Adaptive Governance
description: Explore imported APIs, filters, issues, and tag management in Discovery.
documentId: adaptive-governance-discovery
locale: en-US
---

-

In **Discovery**, you have an overview of the main information about your APIs. This API catalog supports multiple gateways, allowing greater control and organization of your ecosystem.

<Callout type="NOTE" title="NOTE">
The **Discovery** catalog includes APIs originating from different providers and gateway types, including APIs imported from **AWS API Gateway** in both **REST (v1)** and **HTTP (v2)** versions.
</Callout>

<a id="_quick_links"></a>
## Quick Links

See how to:

- Perform a [search](#filter-api)
- [Add a tag](#add-tag) to an API
- [Remove a tag](#remove-tag) from an API
- Apply a [batch edit](#bulk-edit)
- View the [API maturity level](/docs/adaptive-governance/ag-maturity-report#score-level)
- Obtain [_Smart Recommendations_](/docs/adaptive-governance/ag-smart-recommendations) (download contracts with the recommended changes already applied)
- Check for [redundant APIs](/docs/adaptive-governance/ag-redundancy-detector).

<a id="_totals"></a>
## Totals

At the top of the **Discovery** screen, you will find a dashboard with metrics from your catalog, based on the applied [filters](#filter-api).

![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/discovery_totalizers_ed4155dbba.png)

- **Number of APIs**: Displays the total number of APIs in the catalog.
Click the card to see a graphical representation of the total APIs categorized by provider.

![pie chart](https://creative-ball-51b3fc85c0.media.strapiapp.com/discovery_number_apis_4d46c235a4.png)

- **Uncategorized APIs**: Total number of APIs without an associated tag.

- **APIs recently imported**: Total number of APIs imported into the catalog in the last 7 days.
See how to [change the period](#select-period).

- **APIs recently updated**: Total number of APIs in the catalog updated in the last 7 days. See how to change the period:

<a id="select-period"></a>

<Steps>
  <Step>
    ### Step 1

    To **change the period** for **APIs recently imported** or **APIs recently updated**:

    ![APIs recently imported](https://creative-ball-51b3fc85c0.media.strapiapp.com/discovery_time_setting_3d68d7efe7.png)
  </Step>
  <Step>
    ### Step 2

    Click the ![gear icon](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_settings_a6bae7ab0e.png) on the card.
  </Step>
  <Step>
    ### Step 3

    Select the desired period:  --

    - **Yesterday**: Previous day.
    - **Last 7 days**: Last 7 days.
    - **Last 15 days**: Last 15 days.
    - **Last 31 days**: Last 31 days.
    --
  </Step>
  <Step>
    ### Step 4

    Click **OK**.
  </Step>
</Steps>

<a id="apis-listing"></a>
<a id="_apis_listing"></a>
## APIs listing

Imported APIs are listed in a table with the following columns:

![API catalog](https://creative-ball-51b3fc85c0.media.strapiapp.com/discovery_catalog_36a1d2f167.png)

- **PROVIDER**: Icon identifying the gateway provider (examples: Sensedia, AWS, etc.)

- **NAME**: API name.

- **VERSION**: Current version.

- **OWNER**: Click ![three-dot menu](https://creative-ball-51b3fc85c0.media.strapiapp.com/menu_dots_58023479a1.png) and select one of the options:
  - **View owner**: View the API owner, which can be a team or user.
  - **View shared with**: View who the APIs are shared with.

- **MATURITY**: API maturity score, which can be:

| Icon | Level | Range |
| --- | --- | --- |
| ![icon representing basic maturity level](https://creative-ball-51b3fc85c0.media.strapiapp.com/maturity_level_basic_69ba13cc1c.png) | Basic | 0 to 29% |
| ![icon representing intermediate maturity level](https://creative-ball-51b3fc85c0.media.strapiapp.com/maturity_level_intermediate_1bcc95087f.png) | Intermediate | 30 to 79% |
| ![icon representing advanced maturity level](https://creative-ball-51b3fc85c0.media.strapiapp.com/maturity_level_advanced_f4c5a4ae80.png) | Advanced | 80 to 94% |
| ![icon representing excellent maturity level](https://creative-ball-51b3fc85c0.media.strapiapp.com/maturity_level_excellent_c40a603ca2.png) | Excellent | 95 to 100% |

<Callout type="TIP" title="TIP">
Get the full [maturity report](/docs/adaptive-governance/ag-maturity-report) and [AI-generated recommendations](/docs/adaptive-governance/ag-smart-recommendations), with the option to download the Swagger with the applied recommendations.
</Callout>

- **ISSUES**: Indicates the presence of issues that may impact API quality and the ecosystem. Identifies elements that can be modified to improve aspects such as organization and performance.
Common Issues types:

  - **Consistency**: Related to API consistency and organization. Indicates violations of best practices in OpenAPI contracts. Ensures that contracts are complete and consistent, aligning development and documentation with organizational rules.

  - **Efficiency**: Related to resource usage. Indicates redundancies and optimization opportunities but does not cover performance aspects.
<Callout type="IMPORTANT" title="IMPORTANT">
An empty field in the **ISSUES** column immediately after import does not necessarily indicate the absence of issues. After import, APIs need processing, and the time to generate **Issues** can vary from minutes to hours, depending on the number of APIs and the size of imported contracts.
</Callout>

- **TAGS**: Tags (labels). See how [tags](#tags-) work.

- **TYPE**: API category:
  - REST: Synchronous request-response based APIs.
  - Event: Event-driven APIs, such as webhooks, streams, or messages.

- **ACTIONS**:
  - ![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_visualize_e33140aed7.png): View [details](/docs/adaptive-governance/ag-discovery-details) about the corresponding item, such as general data, revisions, and associated environments.
  - ![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_tags_6d2a5a0ff5.png): Add [tags](#tags-) to the corresponding item or manage existing ones.

<a id="filter-api"></a>
<a id="_searching_for_an_api"></a>
### Searching for an API

To see all filtering options, click the ![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_expand_62b33f1187.png) icon.

You can search APIs by:

![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/search_bar_dbeb37f128.png)

- **Name**: API name.

- **Tag Mode**: define the tag search criteria:
  - **Any of selected**: APIs with **at least one of the selected tags** (default).
  - **All of selected**: APIs with **all selected tags**.
  - **None of selected**: APIs **without the selected tags**.
  - **No tag applied**: Displays APIs **without tags**.

- **Tags**: Select or type the tag name. See how [tags](#tags-) work.

- **Version**: API version.

- **Description**: API description field content.

- **Type**: API category:
  - REST: Synchronous request-response based APIs.
  - Event: Event-driven APIs, such as webhooks, streams, or messages.

- **Provider**: Gateway provider (examples: Sensedia, AWS, etc.).

- **Connections**: Name of the [connection](/docs/catalogs).

- **Owners**: API owner (team or user).

- **Shared with**: Team or user the API is shared with. You can use one or more teams or users for the search.

- **Imported At**: API import date.

- **Updated At**: Last API update date.

- **View only items with these issue types**:
  - Consistency: APIs with issues related to API maturity.
  - Efficiency: APIs with issues related to resource redundancy.

After entering values in the desired fields, click **SEARCH** to perform the search or **CLEAR** to clear the fields.

<a id="tags-"></a>
<a id="_categorization_by_tags"></a>
## Categorization by Tags

Tag categorization allows you to classify and group catalog APIs using customizable labels, making API management easier and faster. This feature lets you search for APIs in the same category using their tags.

<a id="add-tag"></a>
<a id="_associate_a_tag_with_an_api"></a>
### Associate a Tag with an API

There are two ways to associate a tag with a catalog API:

<Steps>
  <Step>
    ### Step 1

    - Tags icon ![image of a tag](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_tags_6d2a5a0ff5.png)
  </Step>
  <Step>
    ### Step 2

    In the [API listing](#apis-listing) on the **Discovery** screen, click the ![image of a tag](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_tags_6d2a5a0ff5.png) icon for the API you want to categorize (associate a tag with).
  </Step>
  <Step>
    ### Step 3

    If the selected API does not yet have an associated tag, click **ADD**.
  </Step>
  <Step>
    ### Step 4

    In the **Tag Name** field, enter the name of the tag you want to associate (new or previously registered).

    <Callout type="NOTE" title="NOTE">
    - A tag name must be between 2 and 30 characters long.
    - Only lowercase alphanumeric characters and "-" are allowed.
    - The tag name cannot start or end with "-".
    </Callout>
  </Step>
  <Step>
    ### Step 5

    Click **+** (or press <kbd>ENTER</kbd> on your keyboard) to associate the tag.

    ![tag screen with emphasis on the + button to add](https://creative-ball-51b3fc85c0.media.strapiapp.com/tags_add_e660214c4a.png)

    <Callout type="NOTE" title="NOTE">
    If you click **OK** without clicking **+** (or pressing enter), the tag will not be associated/created.
    </Callout>
  </Step>
  <Step>
    ### Step 6

    If you want to add another tag, repeat the last two steps. Each API can have up to 50 associated tags.
  </Step>
  <Step>
    ### Step 7

    Click **OK** to close the window.

    - View details icon ![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_visualize_e33140aed7.png)
  </Step>
  <Step>
    ### Step 8

    In the [API listing](#apis-listing) on the **Discovery** screen, click the ![image of a magnifying glass over a document](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_visualize_e33140aed7.png) icon in the **ACTIONS** column for the API you want to categorize (associate a tag with).
  </Step>
  <Step>
    ### Step 9

    Click the ![image of a tag](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_tags_6d2a5a0ff5.png) icon next to **Tags** in the **BASIC INFO** panel.
  </Step>
  <Step>
    ### Step 10

    Follow steps 3 to 6 described above.
  </Step>
</Steps>

<a id="remove-tag"></a>
<a id="_remove_tags_from_an_api"></a>
### Remove Tags from an API

There are two ways to disassociate one or more tags from a catalog API:

<Steps>
  <Step>
    ### Step 1

    - Tags icon ![image of a tag](../assets/icon_tags.png)
  </Step>
  <Step>
    ### Step 2

    In the [API listing](#apis-listing) on the **Discovery** screen, click the ![Image](../assets/icon_tags.png) button corresponding to the API from which you want to remove the tag(s).
  </Step>
  <Step>
    ### Step 3

    In the window that opens, locate the tag you want to disassociate from the API.
  </Step>
  <Step>
    ### Step 4

    Click the **X** button for that tag to remove it.

    ![tag screen with emphasis on the x button to remove](https://creative-ball-51b3fc85c0.media.strapiapp.com/tags_remove_ff8340f23f.png)
  </Step>
  <Step>
    ### Step 5

    If you want to remove another tag from this API, repeat the last two steps.
  </Step>
  <Step>
    ### Step 6

    Click **OK** to close the window.

    You can also disassociate tags from the [API details screen](/docs/adaptive-governance/ag-discovery-details):
  </Step>
  <Step>
    ### Step 7

    On the details screen of the desired API, click the ![Image](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_pencil_1cd9690a1b.png) button in the **Tags** field of the **BASIC INFO** panel.
  </Step>
  <Step>
    ### Step 8

    Follow steps 2 to 5 described above.
  </Step>
</Steps>

<a id="_editing_api_information"></a>
## Editing API Information

To edit API information, click the ![image of a magnifying glass over a document](../assets/icon_visualize.png) icon.

In the **BASIC INFO** panel, you can edit:

- **Owner**: To edit the API owner (user or team), click **Owner** ![image representing a person](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_owner_e773d7b91b.png) and select the desired option.

- **Shared with**: To edit who the API is shared with, click **Shared with** ![image representing two people](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_shared_d485494ffa.png) and select one or more users.

<a id="bulk-edit"></a>
<a id="_bulk_editing"></a>
## Bulk Editing

Use the **BULK EDIT** feature to apply the same information to multiple APIs in a single action.

To do this, follow these steps:

<Steps>
  <Step>
    ### Step 1

    In the [API listing](#apis-listing) on the **Discovery** screen, select the APIs to be edited. To select all, click the checkbox next to **PROVIDER** in the row displaying the column titles.
  </Step>
  <Step>
    ### Step 2

    Click the **BULK EDIT** button.

    ![screen showing the API list and the bulk edit option](https://creative-ball-51b3fc85c0.media.strapiapp.com/bulk_edit_button_348a955ae6.png)
  </Step>
  <Step>
    ### Step 3

    You can edit the _Owner_ and _Shared with_.

    ![bulk edit screen](https://creative-ball-51b3fc85c0.media.strapiapp.com/bulk_edit_modal_3cef7b3d04.png)
  </Step>
</Steps>