remove-x-internal

Removes nodes that have a specific flag property. Nodes that don't have the flag property defined are not impacted.

API design principles

Sometimes partner or public APIs use the same schemas and endpoints as internal APIs with some minor differences. This is a mechanism that can be used to maintain them together but generate two sets of API docs from a single-source-of-truth.

Configuration

Option Type Description
internalFlagProperty string The property name used for evaluation. Default value: x-internal

Example of a configuration that uses x-internal as the flag property:

Copy
Copied
decorators:
  remove-x-internal: on

Example of another configuration that changes the flag property:

Copy
Copied
decorators:
  remove-x-internal:
    internalFlagProperty: 'x-private'

Examples

Read the guide on hiding internal APIs to see examples.

Related decorators

Resources

  • Decorator source
  • Remove additional remnants from components by also using the --remove-unused-components CLI argument.