For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Book a demoLog inStart for free
  • Getting started
    • Overview
    • How it works
    • Quickstart
    • Project structure
    • Customer showcase
    • Changelog
  • Configuration
    • Overview
    • Site-level settings
    • Page-level settings
  • Writing content
    • Markdown basics
    • Rich media in Markdown
      • Overview
      • Accordion
      • Anchor
      • Aside
      • Badge
      • Button
      • Callout
      • Card
      • Code block
      • Copy
      • Download
      • Endpoint request snippet
      • Endpoint response snippet
      • Endpoint schema snippet
      • Webhook payload snippet
      • Files
      • Frame
      • Icon
      • If
      • Indent
      • Parameter field
      • Prompt
      • Runnable endpoint
      • Schema
      • Step
      • Table
      • Tab
      • Tooltip
      • Versions
    • Fern Editor
    • Reusable snippets
  • AI features
    • Overview
    • Fern Writer
    • AI-generated examples
    • Markdown access
      • Overview
      • Customize LLM output
      • Agent directives
      • Analytics and integration
    • MCP server
    • API catalog discovery
  • Public API
    • GETJWT from Fern API key
    • GETAlgolia search credentials
    • GETCurrent user information
  • Fern Writer API
    • GETGet Fern Writer Install Link
Checking status...
SOC2Soc 2 Type II
© 2026 Fern • Birch Solutions, Inc., a Postman company

Documentation

SDKsDocsAsk FernCLI Reference

API Definitions

OpenAPIAsyncAPIOpenRPCgRPC

Resources

BlogSupportPricing

Company

Brand KitPrivacy PolicyTerms of Service
LogoLogo
Book a demoLog inStart for free
On this page
  • Usage
  • Variants
  • Collapse by default
  • Properties
Writing contentComponents

Runnable endpoint

||View as Markdown|
Was this page helpful?
Edit this page
Previous

Prompt

Next

Schema

The <RunnableEndpoint> component lets users make real HTTP requests to your APIs directly from your documentation. It auto-detects the endpoint definition from your API specification, renders a request builder for headers, path parameters, query parameters, and request bodies, and displays the response status, headers, body, and timing inline. Form inputs persist in local storage across page reloads. When AI agents fetch the Markdown version of a page, Fern renders the endpoint definition — method, path, parameters, and request body schema — as structured content, so agents receive the full specification without the interactive form.

Usage

Markdown
1<RunnableEndpoint endpoint="POST /chat/{domain}" />

Variants

Collapse by default

Use collapsed to render the component with the form section hidden. Users can expand it by clicking the component.

Markdown
1<RunnableEndpoint endpoint="POST /chat/{domain}" collapsed />

Properties

endpoint
string

The endpoint locator in the format “METHOD /path”. For example: "POST /api/users" or "GET /api/users/{id}". If your API uses namespaces, prefix with the namespace and :: (e.g., "payments::POST /api/users").

example
string

Pre-fill the form with a specific example by name. If not specified, the first example is used by default.

defaultEnvironment
string

Set the default environment for the endpoint. The value must correspond to the x-fern-server-name of a server URL defined in your API specification. If not specified, the first environment is used by default.

readonly
list of strings

Fields to lock by hiding their dropdown selectors. Accepts "environment" to lock the server URL and prevent users from switching environments. When set to readonly={["environment"]}, the environment selector is hidden and the endpoint uses the environment specified by defaultEnvironment (or the first environment if not specified).

collapsed
booleanDefaults to false

Controls whether the component renders collapsed by default with the form section hidden. Set as collapsed={true} or use the shorthand collapsed. Users can expand it by clicking the component.

className
string

CSS class name for custom styling of the component container.