---
schema_version: "1"
id: 70094b1b8445bf106e6219771a8a5e99415e85cb22d14f05ce59cdec511a7bd6
title: Generating API Documentation with Generative AI
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/exchange/generating-documentation-with-ai.md
canonical_url: https://docs.mulesoft.com/exchange/generating-documentation-with-ai
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 89f4345572c5b98aee2e8c4ef255ca79fb44df6b8457eebd8a3770cd173120bb
description: MuleSoft Documentation Site
latest: true
---
---
product: Exchange
---

# Generating API Documentation with Generative AI

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Use generative AI to generate API documentation for REST, SOAP, AsyncAPI, GraphQL, gRPC APIs, MCP,
and Agents in Exchange, streamlining how your organization manages APIs. AI simplifies your
processes by creating consistent, accurate, and current content, which frees you to focus on
strategic tasks and enhances developer satisfaction.

You can create documentation for API assets that don’t have any documentation. From the asset
details page in Exchange, generate the documentation, then manually edit and improve the
documentation. After that, publish it to make it available to everyone in your organization.

This release supports:

- REST APIs (RAML, OAS 2.0/3.0/3.1)

- SOAP APIs

- AsyncAPI

- GraphQL API

- gRPC API

- MCP

- Agents

Generate documentation for these APIs whether they are created using a single specification file or
multiple specification files. Fragments aren’t supported.

## Documentation Structure

AI-generated documentation in Anypoint Exchange standardizes API documentation, addressing
inconsistency and incompleteness. AI standardizes the structure and format of the generated
documentation across each API including fonts, headers, and text size.

Generated documentation includes:

- Overview and purpose of the API

- Authentication requirements and security details

- Base URL and environments

- Detailed endpoint documentation including:

  - Request and response examples

  - Query parameters

  - Path parameters

  - Request body schemas

  - Response codes and examples

- Error handling and status codes

- Best practices for implementation

- Sample code snippets

## Before You Begin

Before generating API documentation with Generative AI, you must have these:

- Generate Asset Documentation with AI permission.

- Salesforce org account with Agentforce enabled in Anypoint Platform.

  To enable Agentforce in Anypoint Platform, see
  [Enable Agentforce for Your Anypoint Platform Organization](https://docs.mulesoft.com/access-management/enabling-generative-ai#enable-einstein-anypoint).

- When you upload a zip file, Anypoint Exchange extracts its content before processing. The
  extracted size of your API specification must not exceed 1.2 MB, and the zip file must not contain
  more than 50 files.

## Generate API Documentation with Generative AI

Generate documentation for API assets that don’t have any documentation. You can edit and save a
draft as many times as you like before publishing.

> [!IMPORTANT] Drafts aren’t visible to others until you publish them. You must publish the
> documentation for it to be available to your organization.

1.  Select the API from the catalog and click **Generate documentation** from the asset details
    page.

    ![Generate documentation button on asset details page](/mulesoft/current/en-us/exchange/_images/ex-generate-doc.png)

2.  Review the generated documentation in draft mode.

3.  To edit the AI-generated documentation, click **Edit** in draft mode, make your changes, and
    save the draft.

4.  Click **Publish** to make the documentation visible to everyone in your organization.

    ![AI-generated documentation in draft mode with Edit documentation option](/mulesoft/current/en-us/exchange/_images/ex-auto-generate-api-doc.png)

For more information about editing asset documentation, see
[to-describe-an-asset.adoc#edit-asset-documentation](https://docs.mulesoft.com/exchange/to-describe-an-asset#edit-asset-documentation).