Sign in

v2

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-07-21130282381.6 KB
API Documentation

Create API documentation page

Create API documentation page

Create API documentation. The result will be the created page or folder. Only MARKDOWN and FOLDER types are supported.

Low-value for routine assistant workflows; prefer higher-level API inspection tools first.

post/environments/{envId}/apis/{apiId}/pages

Request body

namestring required

Page's name.

type'MARKDOWN' | 'FOLDER' | 'SWAGGER' | 'ASYNCAPI' | 'ASCIIDOC' required

The type of the page.

visibility'PUBLIC' | 'PRIVATE'

The visibility of the resource regarding the portal.

parentIdstring

Page's parent id.

excludedAccessControlsboolean

Flag to restrict access to user matching the restrictions.

configurationobject

Configuration of a page

Example request

{
  "name": "My Page",
  "type": "MARKDOWN",
  "visibility": "PUBLIC",
  "parentId": "00f8c9e7-78fc-4907-b8c9-e778fc790750",
  "accessControls": [
    {
      "referenceId": "00f8c9e7-78fc-4907-b8c9-e778fc790750"
    }
  ]
}

Response

Created API Documentation

idstring

Page's uuid.

crossIdstring

Page's cross uuid.

namestring

Page's name.

type'ASCIIDOC' | 'ASYNCAPI' | 'MARKDOWN' | 'MARKDOWN_TEMPLATE' | 'SWAGGER' | 'FOLDER' | 'LINK' | 'ROOT' | 'SYSTEM_FOLDER' | 'TRANSLATION'

The type of the page.

contentstring

Page's content.

orderinteger

Page's order.

lastContributorstring

Page's last contributor. Id of a user.

publishedboolean

Page's published status.

visibility'PUBLIC' | 'PRIVATE'

The visibility of the resource regarding the portal.

updatedAtstring date-time

Page's last update date.

contentTypestring

Page's content type.

configurationobject

Page's configuration.

homepageboolean

Page's homepage status.

parentIdstring

Page's parent id.

parentPathstring

Page's parent path.

excludedAccessControlsboolean

Flag to restrict access to user matching the restrictions.

metadataobject

Page's metadata.

hiddenboolean

If folder is published but not shown in Portal.

generalConditionsboolean

If page is used as General Conditions of an active plan.