API settings

The top-level api field controls how the “Try it” modal on OpenAPI-powered pages sends requests — separate from a navigation group’s own openapi: { src, path } (which spec to use, and where it’s mounted; see API Reference (OpenAPI)).

{
  "api": {
    "proxy": false
  }
}

api.proxy

When true (the default), the “Try it” modal’s Send button routes requests through Writedocs’ own CORS proxy rather than calling the API directly from the browser. Almost no real-world API sends back Access-Control-Allow-Origin headers permitting an arbitrary docs site’s origin, so a direct browser request from the Try-it modal fails for most APIs without this.

Set it to false if your API is already CORS-permissive, same-origin with your docs deployment, or if you don’t want requests routed through a third party at all.