---
title: "Update portal page content OpenAPI viewer configuration"
method: PATCH
path: "/portal-page-contents/{portalPageContentId}/configuration"
tags: ["Portal Pages"]
---

# Update portal page content OpenAPI viewer configuration

`PATCH /portal-page-contents/{portalPageContentId}/configuration`

User must have the ENVIRONMENT_DOCUMENTATION[update] permission.

## Path parameters

- `portalPageContentId` string, required

## Request body

- union
  - PortalPageSwaggerConfiguration — OpenAPI viewer configuration for a portal page content
    - `viewer` 'SWAGGER' | 'REDOC', required — The type of viewer for OpenAPI specification. Default is 'SWAGGER'
    - `displayOperationId` boolean — Display the operationId in the operations list.
    - `docExpansion` 'list' | 'full' | 'none' — Default expansion setting for the operations and tags. Possible values are: - list: Expands only the tags - full: Expands the tags and operations - none: Expands nothing. Default.
    - `enableFiltering` boolean — Add a top bar to filter content.
    - `maxDisplayedTags` integer — Number of max tagged operations displayed. Limits the number of tagged operations displayed to at most this many (negative means show all operations). No limit by default.
    - `showCommonExtensions` boolean — Display common extension fields and values for parameters.
    - `showExtensions` boolean — Display vendor extension (X-) fields and values for operations, parameters, and schema.
    - `showURL` boolean — Show the URL to download the content.
    - `tryIt` boolean — Enable "Try It!" mode in documentation page.
    - `disableSyntaxHighlight` boolean — Disable response body styling for large JSON payloads.
    - `tryItAnonymous` boolean — Enable "Try It!" mode in documentation page for anonymous users.
    - `tryItURL` string — Base URL used to try the API.
    - `usePkce` boolean — Enable use of PKCE with authorization code flows in documentation page.
    - `entrypointsAsServers` boolean — Use API entrypoints as OpenAPI servers.
    - `contextPathAsServerPath` boolean — Use API context-path as OpenAPI server URL path.
  - PortalPageRedocConfiguration — OpenAPI viewer configuration for a portal page content
    - `viewer` 'SWAGGER' | 'REDOC', required — The type of viewer for OpenAPI specification. Default is 'SWAGGER'
    - `tryItURL` string — Base URL used as OpenAPI server URL for Redoc.

## Response `200`

Portal page content

- PortalPageContent — Portal page content
  - `id` string, required — The unique ID of the portal page content
  - `type` 'GRAVITEE_MARKDOWN' | 'OPENAPI' | 'ASYNCAPI', required — Type of portal page content
  - `content` string, required — The content of the page
  - `configuration` union
    - PortalPageSwaggerConfiguration — OpenAPI viewer configuration for a portal page content
      - `viewer` 'SWAGGER' | 'REDOC', required — The type of viewer for OpenAPI specification. Default is 'SWAGGER'
      - `displayOperationId` boolean — Display the operationId in the operations list.
      - `docExpansion` 'list' | 'full' | 'none' — Default expansion setting for the operations and tags. Possible values are: - list: Expands only the tags - full: Expands the tags and operations - none: Expands nothing. Default.
      - `enableFiltering` boolean — Add a top bar to filter content.
      - `maxDisplayedTags` integer — Number of max tagged operations displayed. Limits the number of tagged operations displayed to at most this many (negative means show all operations). No limit by default.
      - `showCommonExtensions` boolean — Display common extension fields and values for parameters.
      - `showExtensions` boolean — Display vendor extension (X-) fields and values for operations, parameters, and schema.
      - `showURL` boolean — Show the URL to download the content.
      - `tryIt` boolean — Enable "Try It!" mode in documentation page.
      - `disableSyntaxHighlight` boolean — Disable response body styling for large JSON payloads.
      - `tryItAnonymous` boolean — Enable "Try It!" mode in documentation page for anonymous users.
      - `tryItURL` string — Base URL used to try the API.
      - `usePkce` boolean — Enable use of PKCE with authorization code flows in documentation page.
      - `entrypointsAsServers` boolean — Use API entrypoints as OpenAPI servers.
      - `contextPathAsServerPath` boolean — Use API context-path as OpenAPI server URL path.
    - PortalPageRedocConfiguration — OpenAPI viewer configuration for a portal page content
      - `viewer` 'SWAGGER' | 'REDOC', required — The type of viewer for OpenAPI specification. Default is 'SWAGGER'
      - `tryItURL` string — Base URL used as OpenAPI server URL for Redoc.

## Other responses

- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/revisions/b736a7e375df/schema)