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

# Workspace Audit

> Review your whole workspace structure in one designer and apply changes. With AI help.

## Overview

Workspace Audit gives you a single editable view of your workspace's
structure, its objects and the sections that organize them. It's the same
visual schema designer used during onboarding, loaded with your current
workspace so you can review, refine, and restructure everything in one place,
then apply the changes when you're ready.

## How it works

Opening the page exports your live workspace schema (objects and sections) into
the designer. You edit the blueprint there: adding, renaming, or reorganizing
objects and properties, and nothing changes in your workspace until you click
**Apply Changes**. Applying writes the blueprint back, creating the new
structure.

The designer runs with the AI assistant in onboarding mode, so you can describe
the changes you want in plain language and have the assistant adjust the
blueprint for you. After applying, the workspace schema reloads so the designer
reflects the new state.

<Info>
  Because this is a structure (schema) audit, you work against a blueprint
  first. Edits are staged in the designer and only take effect on **Apply
  Changes**, distinct from [Company Audit](/data/audits/company), which scans
  for gaps and creates tasks.
</Info>

## Using it

<Steps>
  <Step title="Open Workspace Audit">
    Go to **Settings → Workspace Audit**. The page loads your current workspace
    schema into the designer.
  </Step>

  <Step title="Review the structure">
    Inspect your objects and sections in the designer to spot gaps or
    redundant structure.
  </Step>

  <Step title="Make changes (optionally with AI)">
    Edit the blueprint directly, or ask the AI assistant to add, rename, or
    reorganize objects and properties.
  </Step>

  <Step title="Apply changes">
    Click **Apply Changes** to write the updated blueprint to your workspace.
    The schema reloads so the designer shows the new state.
  </Step>
</Steps>

<Warning>
  Apply Changes modifies your live workspace structure. Review the blueprint
  before applying.
</Warning>

## Troubleshooting

| Symptom                                    | Likely cause                           | What to check                                                                                    |
| ------------------------------------------ | -------------------------------------- | ------------------------------------------------------------------------------------------------ |
| "Failed to load workspace schema"          | The export request failed              | Reload the page; confirm you have access to the workspace                                        |
| Page sits on "Loading workspace schema..." | Export is slow or stalled              | Wait, then refresh; check the browser console for errors                                         |
| "Failed to apply changes"                  | The apply request was rejected         | Confirm admin access and that the blueprint is valid; the error toast's request id links to logs |
| Changes don't appear after applying        | The reload after apply didn't complete | Refresh the page; the designer re-exports the latest schema on apply                             |
| AI assistant doesn't respond               | Chat context didn't initialize         | Reload the page so the audit chat mode is set up again                                           |

<Note>
  When reporting an issue, include the request id shown in the error toast.
  It links the in-app error to the server logs.
</Note>

## Related

* [Company Audit](/data/audits/company)
* [Objects overview](/data/objects/overview)
* [Workspace setup](/start/onboarding/workspace)


## Related topics

- [Company Audit](/data/audits/company.md)
- [Settings](/start/settings/overview.md)
- [Data Structures](/data/overview.md)
- [Task Types](/team/tasks/types.md)