API references

Audiences

Use audiences to filter the endpoints, schemas, and properties that are displayed in your API Reference.
Pro and Enterprise feature

This feature is available only for the Pro and Enterprise plans. To get started, reach out to support@buildwithfern.com.

Audiences are a useful tool for segmenting your API for different consumers. Common examples of audiences include public and beta. You can configure audiences in both the OpenAPI Specification as well as the Fern Definition.

Once you’ve added audiences to your API Specification, you can filter to that audience by adding the audience property to the api object in your docs.yml navigation.

docs.yml
1navigation:
2  - api: API Reference
3    audiences:
4      - public

Here’s an example from Schematic in production.

Instance audiences

API Reference audiences work alongside instance audiences, which control which products and versions appear in each documentation instance. You can use both features together:

  • API Reference audiences - Control which endpoints and schemas appear within API References
  • Instance audiences - Control which products and versions appear in each instance

For example, you might have a public API Reference that shows only public endpoints. To ensure this API Reference only appears on your public documentation site, tag the containing product or version with the public audience.