The asset details page provides comprehensive information about an asset. You can view version-agnostic information, share the asset with others, publish it on the public portal, and download a copy of the asset. You can also view code, manage versions and lifecycle states, add categories and tags, generate and edit asset documentation, and test API endpoints.
See Workflow: Publish Assets for more information about performing these functions.
Select an asset in Exchange to view the asset details page:
The navigation bar lists:
-
Additional pages
-
Saved search terms
-
Application names
-
Instances
-
The HTTP functions in the REST specification (for a REST API)
-
Conformance Status
-
Agents show card details
-
Brokers show access list and card details
-
MCP servers show details and tools
-
Terms and conditions and APIs using this policy (for a policy)
-
Settings
The asset detail page provides this information:
-
Asset name
-
Description
-
Asset type
-
Broker show as asset subtype
-
Agents show protocol
-
Organization
-
Contact name
-
Contact email
-
Asset creation date
-
Last updated date
-
Version
-
Categories and tags of the asset
-
Lifecycle state
-
Managed and unmanaged instances and includes whether agent instances are verified via GoDaddy Agent Naming Service (ANS)
-
Share by inviting users to have access
-
Conformance state
-
APIs show download specifications and view code
-
Add a new version
For REST APIs, use the API console to create example calls and mock data to test the API. For more information, see ex2-to-simulate-api-data.adoc.
For GraphQL APIs, use the GraphQL console to view GraphQL schemas and write and run queries. For more information, see view-graphql-api-schemas-and-run-queries.adoc.
From the asset details page, you can collapse and expand metadata such as version, last published, and categories and tags. See version information by clicking View versions. Administrators can use Manage versions to add a new version of the asset, view version details, and delete a version. See Manage Versions for more information.
The documentation page displays the asset documentation. An administrator or asset owner can edit documentation by clicking Edit documentation from the asset details page. You can generate documentation for REST APIs without documentation by clicking Generate documentation. For more information, see generating-documentation-with-ai.adoc.
View RAML, OAS, or AsyncAPI API specification information, including resources and the methods in each resource, in the left navigation bar.
-
Click a method button:
-
Experiment with the API in the right side of a method view.
This is similar to using a program such as Postman to specify custom HTTP headers and test each API’s method using the API’s endpoint.
-
To connect the API to one of your applications and use the API to send and receive data, click Request access.
The assets details page enables you to find specific information within the pages and API specification of an asset using the CTRL+F or the command+F keyboard shortcut. In Exchange, this enhanced shortcut overrides the native browser shortcut, which only searches for words and phrases on the current page. To quickly find the information you need, use this enhanced shortcut to search the content of every page and the API specification of an asset.
To search pages and the API specification using the enhanced find shortcut:
-
In the asset details page, press CTRL+F or Command+F.
-
In the Search content box, enter a search term or phrase.
-
Click a search result from the list.
-
Use the arrows to move through all the occurrences of the search term within the search results.
-
Click the X to close the Search content box.
The enhanced keyboard shortcut looks for terms or phrases in:
-
Pages
-
Home
-
Additional pages
-
-
Specification
-
Summary
-
Endpoints
-
Documentation
-
Types
-
Security
-
When you enter a search term or phrase in the search box, the search results box displays the sections within Pages and Specification that contain the search terms entered. Click the search result to open the page with the search term or phrase highlighted. The search result shows the number of search-term matches in each page. Use the arrows to move up or down in the list of search results and to the next page.
For example, enter the term ruleset in the Search content box. From Pages, there are three search results for ruleset in the Home page. Click Home to open the page. Use the arrows to find all of the highlighted instances of ruleset in the Home page.
View the instances of APIs and other assets in the Instances list on the asset details page. Instances are managed or unmanaged (non-managed). Managed instances are managed in API Manager. For example, when you register an API in API Manager, it creates a managed instance. This instance is linked to a specific runtime (like Mule Gateway or Anypoint Omni Gateway). Its environments (sandbox and production) appear automatically in the Instances list. The list includes the instance name, version, environment, URL, visibility, and whether an agent instance is verified via GoDaddy Agent Naming Service (ANS).
Unmanaged (external) instances run outside Anypoint Platform. These instances are primarily for discovery—helping your team find all APIs in one catalog even if they aren’t governed in API Manager.
Instances for brokers are created in YAML in Anypoint Code Builder. After the agent network project is published to Exchange, the instances appear in the Instances list.
To view instances:
-
Select an asset in Exchange.
-
In the navigation bar, select Instances.
-
The Instances list displays the instances of the asset.
-
Permissions Available in Anypoint Platform for Exchange