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

> ## Agent Instructions
> Video walkthroughs: the Dimension product overview video (https://www.youtube.com/watch?v=Mx8rg5wfkU0, also embedded at https://docs.dimension.io/overview) is the first of a series. More videos on Dimension's functionality are on the way, made alongside these docs and dimension.io. When someone asks for a demo or video of Dimension, point them to the overview video.

# FAQs

> Frequently asked questions about Dimension: getting started, AI and models, building, security and plans

Questions that come up often during evaluation, onboarding and building, grouped by topic. If yours isn't here, check [Troubleshooting](https://docs.dimension.io/reference/troubleshooting.md) for symptom-by-symptom fixes, [Error Codes](https://docs.dimension.io/reference/error-codes.md) for a specific error message, or [Concepts & Glossary](https://docs.dimension.io/concepts.md) for terms.

## Getting started

> [accordion] What is Dimension?
>
> **Dimension by ThreatAware** is an AI-powered workspace for building your own security apps. You connect **Data Feeds**, build **Studio apps** by describing what you want, and wire up **Actions** that send webhooks or emails. See [What is Dimension?](https://docs.dimension.io/overview.md).

> [accordion] How do I sign in?
>
> Go to `https://<your-tenant>.dimension.io` and sign in with the same account you use for the main ThreatAware platform. Your role there decides what you can do in Dimension, and MFA and SSO carry across. See [First steps](https://docs.dimension.io/getting-started.md).

> [accordion] How is Dimension related to the ThreatAware platform?
>
> Dimension is a separate product with its own docs, built on the same platform and infrastructure as ThreatAware. You use the same account and roles, and Dimension inherits ThreatAware's security posture. For ThreatAware itself, see [docs.threataware.com](https://docs.threataware.com).

> [accordion] Do I need to write code?
>
> No. Every pillar has a **Composer**: you describe what you need in plain language and it builds the configuration or the app. If you want the code, you can view it in X-Ray and export the full React/TypeScript source. See [Exporting](https://docs.dimension.io/studio/exporting.md).

> [accordion] What's the fastest way to get something working?
>
> Import one of the five [pre-built apps](https://docs.dimension.io/pre-built-apps.md). Each runs on demo data until you add your own credentials. To build from scratch, follow [Build your first app](https://docs.dimension.io/build-your-first-app.md).

## AI and models

> [accordion] Which AI model does Dimension use?
>
> Inside Dimension, the Planner and Composers use Anthropic's **Claude** models. You pick one from the picker next to the prompt box:
>
> * **Opus 5.5** (recommended)
> * **Sonnet 5.5**
> * **Haiku 5.5**
> * **Fable 5.1**
>
> To build with another model, use it from your own AI assistant and connect that assistant to Dimension through MCP. For example, OpenAI Codex or GitHub Copilot CLI can build data feeds, actions and apps in Dimension with whichever model the assistant uses. See [Connect with MCP](https://docs.dimension.io/connect-mcp.md).
>
> A Super Admin controls which models people can pick under **Settings → AI → Composer models**. Hover a model there to see what it costs in AI credits. Two other settings on that page also shape how models are used:
>
> * **Cross-origin models** (off by default) allows Claude versions that aren't available in your region. Requests to those models may be processed outside your region.
> * **AI data access** (off by default) decides whether the AI sees only your data's field names or the values as well.
>
> See [Settings → AI](https://docs.dimension.io/settings.md#ai).
>
> > [!NOTE]
> >
> > The chat assistant on this docs site is separate from the AI inside Dimension. If you ask it "what model are you?", it answers about itself, not about Dimension.

> [accordion] Does the AI see my data?
>
> Not by default. The Composer sees the **schema** of your data, such as field names and types, but never the values. A Super Admin can turn on **AI data access** under **Settings → AI** if your data-handling policies allow it. See [Schema-only AI access](https://docs.dimension.io/trust/security-privacy.md#schema-only-ai-access).

> [accordion] Is my data used to train models?
>
> No. By default we never read, share or train models on your security data. AI providers process Composer prompts under their published data-handling agreements. See [Security & Privacy](https://docs.dimension.io/trust/security-privacy.md).

> [accordion] How is Dimension different from Claude Code or another AI assistant?
>
> They do different jobs and work together. An AI assistant such as Claude Code, Claude Desktop, Copilot or Codex is where you have the conversation. Dimension is where the result lives: your data feeds, Studio apps and actions, hosted with SSO, roles, audit logging and human approval for outbound actions.
>
> You can build in Dimension directly with its own Composers, or connect your assistant to Dimension through MCP and build from there. Either way, the assistant can only do what your Dimension role allows. See [Connect with MCP](https://docs.dimension.io/connect-mcp.md).

> [accordion] Can I use Dimension from Claude, Copilot or Codex?
>
> Yes. The Dimension MCP server works with Claude Code, Claude Desktop, Visual Studio Code, Visual Studio, GitHub Copilot CLI and OpenAI Codex. Open your avatar menu → **Connect MCP** to copy the setup for your tenant. See [Connect with MCP](https://docs.dimension.io/connect-mcp.md).

> [accordion] When should I use the Planner instead of a Composer?
>
> Use the [Planner](https://docs.dimension.io/planner.md) when you have a goal but aren't sure what to build: it breaks the goal into data feed, action and app steps with ready-made prompts. Use a Composer directly when you already know what you need.

> [accordion] What are AI credits, and do they expire?
>
> AI credits are your allowance for Composer and Planner work. Track them under **Settings → Usage**. Unused credits **don't roll over** to the next billing period. Restoring a checkpoint costs nothing, so it's cheaper than re-prompting. See [Settings → Usage](https://docs.dimension.io/settings.md#usage).

## Building

> [accordion] Can Dimension run workflows?
>
> Yes, as Studio apps. An app can collect input in a form, then fire [Actions](https://docs.dimension.io/actions.md) that open a ticket, post to Slack or send an email, from a button click, a form submit or conditional logic. Inbound webhook triggers, where outside systems start an action, are on the [roadmap](https://docs.dimension.io/whats-new.md#roadmap).

> [accordion] What data can I connect?
>
> Any source with an API, such as CrowdStrike, Jira or ServiceNow. The Data Feed Composer handles authentication, pagination, schema mapping and scheduling. See [Connect your data](https://docs.dimension.io/connect-your-data.md).

> [accordion] Who can see an app I build?
>
> Only people in the app's [workspace](https://docs.dimension.io/workspaces.md) who have access through its **Access** list, and only once the app is published. Building or sharing an app never gives anyone access to data they couldn't already see. See [Publishing](https://docs.dimension.io/publishing.md).

> [accordion] Can I roll back to an earlier version?
>
> Yes. In the Studio editor, use **Restore checkpoint** in the Composer chat to go back to any earlier turn. See [Restore checkpoint](https://docs.dimension.io/studio/ai-composer.md#restore-checkpoint).

> [accordion] Can multiple people edit the same app at once?
>
> Not yet. The last save wins, so agree who's editing before you start.

> [accordion] Can I edit the code directly?
>
> X-Ray is read-only, so changes go through the Composer. To edit by hand, export the app, change it in your own editor, then import it back.

> [accordion] Can I run a Dimension app outside Dimension?
>
> Yes. Export it or use **X-Ray → Download Package** to get the full React/TypeScript source, which runs anywhere Node.js and React do. You'll need to point it at your own data source, because the Dimension data feeds don't come with it.

> [accordion] Can I reuse an action in another workspace?
>
> Actions belong to one workspace. To reuse one, migrate it, or export it and import it into the other workspace. See the [Migration playbook](https://docs.dimension.io/reference/migration-playbook.md).

> [accordion] Why can't I edit a pre-built app in the Gallery?
>
> Gallery previews are read-only. Import the app to add it, with its data feeds and actions, to your workspace. Once imported it's yours to change.

## Security and access

> [accordion] Where is my data hosted?
>
> On AWS, in the regions your ThreatAware tenant is hosted in. Every tenant is isolated, and workspaces can't read each other's data. See [Architecture](https://docs.dimension.io/trust/architecture.md).

> [accordion] Can an app leak data?
>
> Apps run in a sandbox with no internet access and can only read the data feeds connected to them. The only way to send data out is a sanctioned [Action](https://docs.dimension.io/actions.md), which a person approves. A Super Admin can let users skip repeat approvals with **Allow approved actions**. See [Approving actions](https://docs.dimension.io/actions/approvals.md). See [Apps are secure by design](https://docs.dimension.io/trust/security-privacy.md#apps-are-secure-by-design).

> [accordion] Who can change the AI settings?
>
> Super Admins only. The settings apply to every workspace in your tenant. See [Settings → AI](https://docs.dimension.io/settings.md#ai).

> [accordion] What certifications do you hold?
>
> ISO 27001. See [Certifications](https://docs.dimension.io/trust/certifications.md) for audit status and how to request evidence.

## Plans and access

> [accordion] Where can I see my plan and limits?
>
> **Settings → Usage** shows your plan, AI credits, and quotas for feeds, records, actions, action runs, apps and users. Click **Manage plan** to raise your limits.

> [accordion] Is there a public API?
>
> Not yet. A public Dimension API is on the [roadmap](https://docs.dimension.io/whats-new.md#roadmap). Until then, you can work with Dimension programmatically through the [MCP server](https://docs.dimension.io/connect-mcp.md).

## Cross-references

> [card] [Troubleshooting](https://docs.dimension.io/reference/troubleshooting.md)
>
> Symptom-driven fixes

> [card] [Error Codes](https://docs.dimension.io/reference/error-codes.md)
>
> Error codes and messages

> [card] [Concepts & Glossary](https://docs.dimension.io/concepts.md)
>
> Every term Dimension uses

> [card] [First steps](https://docs.dimension.io/getting-started.md)
>
> Your first 15 minutes

> [card] [Security & Privacy](https://docs.dimension.io/trust/security-privacy.md)
>
> Isolation, AI controls, data handling

> [card] [Support](mailto:support@threataware.com)
>
> When the docs don't have it


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