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

> ## Agent Instructions
> ## What this documentation covers
> This is the documentation for ArcSolar, the solar-retailer operating system: the web app a solar retailer uses to run quoting, sales, installation, rebates, inventory and reporting. ArcSolar is a hosted web application at https://app.arcsolar.com.au. There is no public API for most workflows, so agentic operation of ArcSolar is UI-driven. Navigate the app, read the labels and controls, and act through the interface, unless a page explicitly documents an API, contract or integration endpoint.
>
> ## How to read these pages
> - Pages are split by audience using Mintlify's Visibility component, and this split is deliberate. Sections marked 'for agents' are hidden on the website and appear only in the Markdown you are reading. They are the authoritative behavioural specification for the page. Where the remaining human-facing prose and an agent section disagree, the agent section is correct.
> - Sections outside any Visibility block appear in both outputs. They are the shared spine of the page: what the feature is and why it matters.
> - Treat every bold label, field name, route, status string and error message quoted in an agent section as canonical. They are copied verbatim from the product. Use that exact wording when telling a user where to click, or when matching an error message to its cause.
> - Australian solar vocabulary is used precisely and not interchangeably: STC (Small-scale Technology Certificate), PRC (Peak Reduction Certificate), REPS, NMI, CEC accreditation, VPP. Do not substitute an overseas equivalent.
> - Money is Australian dollars. Dates shown to users are day-first (DD/MM/YYYY).
>
> ## Behaviour rules for operating or advising on ArcSolar
> - Respect prerequisites and ordering. Agent sections state which inputs block progress and which steps must happen first. Do not skip a step, and do not assume a default that the product itself does not supply.
> - Never invent a value the product requires but the user has not supplied. Ask for mandatory fields rather than guessing. Several features reject a request outright when one is missing, and submissions to external authorities are effectively irreversible.
> - Respect permissions and scoping. Features name the roles, capabilities and access rules that may act. Do not attempt an action the operator's role cannot perform, and do not describe a restricted feature as available to them.
> - Features that are gated, pending release, or blocked on a vendor are documented as exactly that. Never present a gated or unmerged behaviour as live. When availability is unclear for a given workspace, direct the user to support rather than asserting that the feature works.
> - Where a page states something is genuinely undetermined, treat it as unknown. Do not fill the gap with a plausible guess.
> - ArcSolar's supported intelligence tools appear where they help with the task, including bill analysis, call summaries and reporting. Check the underlying evidence. Intelligence does not replace provider approval, verified records or the customer's own confirmation.
>
> ## Getting help
> Support is support@arcsolar.com.au. The customer-facing website is https://www.arcsolar.com.au.

# AI apps: manage and troubleshoot

> Disconnect an AI app, check what it did, and fix common problems.

**Open:** [**Settings → AI apps**](https://app.arcsolar.com.au/dashboard/profile-settings?tab=ai-apps).

## Manage your connections

* **Connected AI apps** lists each app you approved, with its access and organisations. Select **Disconnect** to stop it straight away.
* **Personal access tokens** are listed with their expiry. Select **Revoke** to stop one.
* **Recent AI activity** shows the last 30 things AI apps did with your account, including anything refused.

Disconnecting a connection that covers several organisations ends it in all of them.

## How long a connection lasts

| Connection | Lasts |
| - | - |
| App connection (sign-in) | 30 days, then connect again. It also stops if it isn't used for 14 days |
| Personal access token | 7, 30 or 90 days, as chosen |

A connection also ends when:

* You disconnect or revoke it.
* You're suspended or removed from the organisation.
* ArcSolar detects a sign-in token being reused, which can mean it was copied. Activity shows **Blocked a reused sign-in token**. Connect again, and change your password if you didn't expect this.

## Common problems

| What you see | What to do |
| - | - |
| ArcSolar doesn't appear in the app | Turn it on from the chat's tools menu. On Claude Team or Enterprise and ChatGPT business plans, an admin may need to allow the connector first |
| "Permission denied: a … cannot use …" | Your role can't do that in ArcSolar either. Ask an Administrator, or do it in ArcSolar |
| The app can't find a customer or job | It may be assigned to someone else. The app only sees what your role sees |
| Changes are refused | The connection may be **Read only**. Disconnect and connect again with **Read and write** |
| "That preview expired" | Previews last 10 minutes. Ask the app to prepare it again, then confirm |
| "The token is expired or revoked" | Connect again, or create a new personal access token |
| "This connection cannot use that organisation" | You didn't tick that organisation. Connect again and tick it |
| The app asks which organisation to use | On a connection with several organisations, changes must name one. Say "in \[organisation name]" |
| "This connection request cannot continue" | Close the window and start the connection again from the AI app |

Error messages end with a short reference. Include it when you contact support.

## Get help

* **From the AI app:** ask it to "report this problem to ArcSolar support". It shows you the report first and sends it only after you confirm. It needs a **Read and write** connection.
* **By email:** send what you asked, what happened and the reference to **[support@arcsolar.com.au](mailto:support@arcsolar.com.au)**. Never include a token or password.

See [Get help from ArcSolar](https://docs.arcsolar.com.au/reference/support.md) for other ways to reach us.


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