> For the complete documentation index, see [llms.txt](https://docs.flexsmart.io/flexsmart/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flexsmart.io/flexsmart/get-started/quick-start-guide/troubleshooting.md).

# Troubleshooting

Encountering an issue? No worries! Here are some quick fixes and tips to keep you building smoothly.

## ❗Error: “Preview” displays a code block

If the “Preview” displays a code block, simply copy the code and paste it into the prompt input field to proceed.

<figure><img src="/files/FBNjIHmsbGdKiHC2Ey9R" alt=""><figcaption><p>"Preview" Tab Displaying a Code Box Error</p></figcaption></figure>

🔁 If the issue keeps happening, try reverting to the latest version that worked. This can often restore functionality and help identify what might be causing the problem.

<figure><img src="/files/g4zIpHMuaOVR13hP6jI2" alt=""><figcaption><p>"Revert to this message" Button</p></figcaption></figure>

***

## ❗Error: “⚠️ Preview Error”

If you receive the following “⚠️ Preview Error” message, select “Ask Aurelia” so she can analyze and resolve the error.

<div data-full-width="false"><figure><img src="/files/SyPXCPQr3gtdN1adPZdp" alt=""><figcaption><p>Preview Error with No Preview</p></figcaption></figure></div>

<figure><img src="/files/e9xsUzI9L0veX5xDD6Zf" alt=""><figcaption><p>"Ask Aurelia" Button</p></figcaption></figure>

***

## ❗Error: “Enter FlexSmart API Key”

If you receive the following “Enter FlexSmart API Key”, you will need to locate the API key in FlexSmart to continue. We’ll show you how.

<div data-full-width="false"><figure><img src="/files/4tWT4FmLDysbAQHS43Qt" alt=""><figcaption><p>"Enter FlexSmart API Key" Prompt Field</p></figcaption></figure></div>

#### **How you obtain FlexSmart’s API key:**

1️⃣From your [**FlexSmart dashboard**](https://academy.flexsmart.io/) in a separate window, navigate to the top right corner, click on the three dots next to your name, and select “**Developer**”.

2️⃣If you already see an API key, skip to the next step. If not, click on the button “**Generate API Key**”

3️⃣ Once you see the API key, click on the **copy icon** next to it and then paste this key in the "Enter FlexSmart API Key" prompt field on Aurelia.

<div data-full-width="false"><figure><img src="/files/X62mjbOJe5388KYyjYXq" alt=""><figcaption></figcaption></figure></div>

🔥 **Pro Tip:** If you run into issues not listed here, let us know in #🛠-[support](https://discord.com/channels/939202745460723753/1344750233514545294) on Discord!


---

# 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.flexsmart.io/flexsmart/get-started/quick-start-guide/troubleshooting.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.