> ## Documentation Index
> Fetch the complete documentation index at: https://beta.docs.ideatura.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Check connections, recover interrupted tasks and report reproducible faults.

Start with the problem you can see: a missing application, an interrupted request or a result that does not match your instructions. If Ideatura has already changed your model, inspect those changes before running the task again.

## 1. Connection problems

Open your design application and the file you want to work on. In Ideatura, open **Connected Apps** and look for that file. Select it before sending your request. If it is missing, follow the setup guide for your application and check that its version is supported.

![Full Studio window with the open Garden Office Revit document selected in Connected Apps.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/portrait-integrations-revit-connected.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=314d05460791b4e393dffa900b83e574)

For help with setup or connections, ask in the [Community forum](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md). Include the application and version, connection status and steps you tried. Use [Report a problem](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md#problem-reports) to send the relevant diagnostics.

![Full Windows browser window showing Ideatura Community application and workflow categories.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/browser-community-categories.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=558248a8a07255f0d6d74199b4e60bab)

## 2. Interrupted tasks

If Studio shows **Waiting for Revit / Check Revit to continue**, switch to Revit and check for any dialog needing a response. The tooltip asks you to check and close open dialogs. If none is visible, do not assume a dialog caused the interruption. Read the latest task status and inspect what completed before retrying; request only the unfinished work. An unblocked status means execution can continue, not that the requested result is complete.

![Full Studio window showing Waiting for Revit and Check Revit to continue, with a tooltip asking to check and close open dialogs.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/portrait-revit-execution-blocked.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=29b9710a0960fab6bdb3ff3c81dafdc0)

For advice on the workflow or how to improve the request, ask in the [Community forum](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md). Describe the intended result, what completed and what you tried next. Use [Report a problem](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md#problem-reports) to send the error and diagnostics.

![Full Windows browser window with the Community search field and advanced-search control open.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/browser-community-search.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=98255c2f2a252f253d822cf108ad3976)

## 3. Report an issue

For how-to questions, start with the [Community forum](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md). To report a fault, open [Report a problem](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md#problem-reports). Include what you expected, what happened and the steps that led to the error. Add the Chat ID if available so the team can locate the task. You can report an issue even if you cannot reproduce it.

![Full Studio window with Report a problem open, diagnostics being collected, context and screenshot controls, and the privacy notice.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/portrait-report-problem.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=152c0993262198804339ac08643ee4c7)

Check the attachments and privacy notice before **Send**. The diagnostic bundle is private to Ideatura support; share only the project material needed to reproduce the problem.

## 4. Diagnose before retrying

Check the actual state before changing settings: account access, connection, required inputs, open dialogs or an unsupported operation can each need a different response. Here, the required view is empty and **Run** is disabled. If a task already ran, inspect completed changes before retrying; preserve the last accepted result and [report repeated faults](https://beta.docs.ideatura.ai/beta/troubleshooting/report-a-problem.md#problem-reports) with the error, versions and affected task.

![Full Studio window with the required Plans/RCPs selection empty and Run disabled.](https://mintcdn.com/ideatura-preview/TWzcvTaStOCEp2mF/beta/images/studio/windows/portrait-automations-required-empty.png?fit=max\&auto=format\&n=TWzcvTaStOCEp2mF\&q=85\&s=84cef02e5ec3f48c980c13bb8324dfa9)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.