> ## 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.

# Company Audit

> Automated checks that scan your workspace and create admin tasks for improvements.

## Overview

Company Audit runs automated checks against your workspace and turns each
finding into a task. The checks look for gaps that quietly weaken your AI
assistant and team onboarding: missing descriptions, placeholder icons, and an
unset AI system prompt. Audit tasks are assigned to workspace admins and surface
near the top of task lists.

## How it works

When enabled, audits run daily and create a task for each failing check.
Audit tasks are de-duplicated: a resource that already has an open audit task
won't get a second one, so re-running is safe.

Each check inspects a category of workspace data:

| Check                 | What it flags                             |
| --------------------- | ----------------------------------------- |
| Workflow Descriptions | Workflows with no description             |
| Object Descriptions   | Custom objects with no description        |
| Property Descriptions | Properties (fields) with no description   |
| Object Icons          | Objects still using a placeholder icon    |
| Property Icons        | Properties still using a placeholder icon |
| AI System Prompt      | Workspace with no AI system prompt set    |

Audit tasks include an AI-assisted remediation panel: the assistant can
**suggest** a value (a description, a curated icon, or a system prompt) which
you review and **apply** in place, completing the task.

## Using it

<Steps>
  <Step title="Open Company Audit">
    Go to **Settings → Company Audit**.
  </Step>

  <Step title="Enable audits">
    Turn on **Enable Audits** so checks run daily and create improvement tasks.
  </Step>

  <Step title="Choose which checks run">
    Toggle individual checks under **Audit Checks**. Checks are on by default;
    disabling one stops it from creating tasks. (Toggles are disabled while
    audits are off.)
  </Step>

  <Step title="Run on demand">
    Click **Run Audit Now** to queue an audit immediately. It runs in the
    background and new tasks appear shortly.
  </Step>

  <Step title="Resolve the tasks">
    Open each audit task, use the AI suggestion to fix the resource, and apply
    it to mark the task done.
  </Step>
</Steps>

## Troubleshooting

| Symptom                                  | Likely cause                                 | What to check                                                                                   |
| ---------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| "No audit checks available"              | Check definitions failed to load             | Reload the page; check the browser console for errors                                           |
| Run Audit Now creates no tasks           | Every resource passes, or all checks are off | Confirm checks are enabled and that there are objects / workflows missing descriptions or icons |
| Toggles are greyed out                   | The master **Enable Audits** switch is off   | Turn on Enable Audits first                                                                     |
| No audit tasks appear after running      | No admin / owner users to assign to          | Ensure at least one workspace member has admin or owner access                                  |
| The same finding never re-creates a task | An open audit task for it already exists     | Complete or cancel the existing task; duplicates are skipped by design                          |
| "Failed to update audit configuration"   | Save error or insufficient access            | Audit settings require admin access; the error toast's request id links to logs                 |

<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

* [Workspace Audit](/data/audits/workspace)
* [Objects overview](/data/objects/overview)
* [Modify an object](/data/objects/modify)


## Related topics

- [Workspace Audit](/data/audits/workspace.md)
- [Settings](/start/settings/overview.md)
- [Data Structures](/data/overview.md)
- [Task Types](/automation/workflows/task-types.md)
- [Caller verification](/comms/voice/verification.md)