Authentication

You can set authentication parameters to let users use their real API keys.

Enabling Authentication

You can add an authentication method to your docs.json to enable it on every page or you can set it on a per-page basis.

The page’s authentication method will override docs.json if both are set.

Bearer Token

docs.json

"api": {
    "mdx": {
      "auth": {
        "method": "bearer"
      }
    }
}

Basic Authentication

docs.json

"api": {
    "mdx": {
      "auth": {
        "method": "basic"
      }
    }
}

API Key

docs.json

"api": {
    "mdx": {
      "auth": {
        "method": "key",
        "name": "x-api-key"
      }
    }
}

None

The “none” authentication method is useful to disable authentication on a specific endpoint after setting a default in docs.json.

Page Metadata

---
title: "Your page title"
authMethod: "none"
---