Contact Free trial Login

Describe an Asset

  1. Click an asset.

  2. Click Edit to add a description. The editor lets you change the appearance of text, insert code samples, block quotes, and horizontal lines. You can also insert a link to an external resource and to an image. The image has to be served on the web.

    The Markdown editor also lets you add a link to a YouTube or Vimeo video to your asset description.

  3. After you create a page, you can add additional pages, tags, terms and conditions, and change versions for an asset or if describing an API, for versioning the API as well.

Change an Asset Title

  1. Position your mouse pointer in the asset’s title and add the text you want the title to be.

  2. Press the Enter (or Return) key on your keyboard.

    If you don’t press the Enter (Return) key, the title reverts to its former text.

    If you edit the title and click out of the edit field rather than press Enter (Return), the title does not display your changes. Click back in the title field to see your changes. If you publish the page without pressing Enter, you don’t see your changes. Your changes are only present in the field when you click in the title field again, but they are not made visible until you press Enter (Return).

Add an Image

You can copy and paste an image directly into the Exchange page:

  1. Click Edit

  2. Click Visual mode

  3. If your image is on your computer, drag the image to the Exchange page, or copy and paste to the Exchange page.

    If the image is on a web server, copy the image and paste it into the Exchange page.

Alternatively you can click the image icon in the editor and provide a URL to an illustration available on the web.

In Markdown, use this syntax to reference a web served image:

![some alt text](

Images uploaded before May 2019 can be accessed without authentication, and images uploaded after May 2019 require authentication. To disable unauthenticated access to an image uploaded before May 2019, download it, delete it, and upload it again.

Add Secondary Pages

  1. Click an asset and click Edit.

  2. In the left navigation area, click Add New Page and press the Return key on your keyboard to create the page. You can create as many pages as needed. In Exchange Portals, click Add Content Pages.

  3. Add a description to the page. Anything you can add on the main page can be added to the subordinate page.

  4. After creating a page, click Save As Draft so you don’t lose content if Exchange times out.

  5. When done creating pages, click Publish.

In Edit mode, you can reorder pages by clicking the page name and dragging the page up or down in the left nav bar.

All page names are validated:

  • Page name length must be from 1 to 128 characters.

  • A page name cannot be the reserved name home.

  • Page names cannot be the name of an existing page.

  • Page names cannot contain these characters: @ * + / _ \

  • Page names cannot start with .

Create Asset Tags

Tags help users find your asset. Users can search in Exchange for a tag name to locate your asset.

  1. Click an asset in your private Exchange.

  2. Click Add A Tag: Add a tag button

    Tags can only be lowercase. If you enter uppercase, Exchange converts the letters to lowercase. Special characters are permitted. You can have any number of tags.

  3. To verify, search for the asset using a tag you added.

Specify Terms and Conditions

  1. Click an asset and click Edit.

  2. Click Add Terms and Conditions: Terms and Conditions button

  3. Use the editor to specify the terms and conditions for this asset.

  4. Click Save As Draft.

  5. Publish.

Note: Only available for APIs. Users are then prompted to accept the terms and conditions when requesting API access.

Change the Version of an Asset

Exchange lets you version an API separately from an asset’s version.

  1. Click an asset to view details.

  2. Click the version indicator in the title: Version Indicator in title button.

  3. Change the version as needed and press the Return key on your keyboard.

To change the asset version, click Add New Version: Asset Version button.

Editor Notes

  • To use the link control, type text, select the text, and click the link control to specify the link URL.

  • If your Exchange session times out while you’re editing, select all the text on the page and copy it to your clipboard. Then after you log back in, you can paste the content back into the page and save your draft. When a timeout occurs, unsaved content is purged.

  • You can access international characters by pressing and holding a character.

  • If you are editing descriptions for many assets, instead of clicking an asset to open it from Exchange, instead right-click the asset and click Open Link in New Window to open the asset in a new browser window. Otherwise, after you publish an asset, control returns to the start of the filter/search list.

  • Keyboard shortcuts (work in Visual and Markdown): Bold: ctrl-b/cmd-b, Italics: ctrl-i/cmd-i, Heading: ctrl-d/cmd-d, Blockquote: ctrl-e/cmd-e, Code Block: ctrl-j/cmd-j, Numbered List: ctrl-o/cmd-o, Bullet List: ctrl-u/cmd-u, Insert Link: ctrl-k/cmd-k.

Markdown Notes

  • Anypoint Exchange uses GitHub Markdown. Everything works in GitHub Markdown except for syntax highlighting, which is not supported in Exchange.

  • Basic HTML 5 code elements are supported in Markdown, such as div, button, a, ul, ol, table, p, span, pre, and code.

  • Insert a link: []( or:

  • Insert a YouTube video: ![linkname](
    For example: ![](

  • Insert a Vimeo video: [linkname](VIMEO_URL)

  • Add the asset ID to a URL:
    To: ![](

See Also

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub