> For the complete documentation index, see [llms.txt](https://docs.beefree.io/beefree-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.beefree.io/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/other-customizations/advanced-options/custom-headers.md).

# Custom Headers

{% hint style="info" %}
This feature is available on Beefree SDK [Superpowers plan](https://dam.beefree.io/pluginpricing) and above. If you're on the Core or Essentials plan, [upgrade a development application](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/getting-started/readme/development-applications.md) for free to try this and other Superpowers-level features.
{% endhint %}

## When to use it <a href="#when-to-use-it" id="when-to-use-it"></a>

This feature allows the host application to pass custom headers when it triggers a call to their services. The custom headers are added to [FSP calls](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/server-side-configurations/server-side-options/storage-options/connect-your-file-storage-system.md) and to [Custom Rows](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/rows/reusable-content/create/pre-build/implement-custom-rows.md) calls.

For example, this could be useful for the security teams of , which would like to pass a JWT (JSON Web Token) when the user, through the file manager, triggers a call to their [Custom File System Provider API](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/server-side-configurations/server-side-options/storage-options/connect-your-file-storage-system.md).

It may be also be used to protect application or customer-hosted content delivered to the editor, such as custom rows or other host app-specific content. The extra token helps the host application to apply an authentication layer to the contacted endpoints.

### How it works <a href="#how-it-works" id="how-it-works"></a>

To activate this feature, the host application must add a specific element to the [Configuration object](/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/getting-started/readme/installation/configuration-parameters.md):

```javascript

customHeaders: [
    {
        name: 'Authorization',
        value: 'Bearer ',
    },
    ...
],

```

Please note that **all custom headers will be prefixed with “X-BEE-“** identifier. For instance, in the example above, the header will be sent to the host app as `X-BEE-Authorization`.

{% hint style="info" %}
Please note that custom headers must be whitelisted by our team before using them. Please open a support ticket via the [Beefree SDK Console](https://dam.beefree.io/devportal) if you’re planning to use this feature.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.beefree.io/beefree-sdk/~/changes/s6kaGu3uaMgmVVo1sL8X/other-customizations/advanced-options/custom-headers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.