---
title: "oz0 tenant works-council"
description: "Works-council mode is on for every tenant until one of its admins turns it off."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/tenant/works-council"
---
# oz0 tenant works-council

> Works-council mode is on for every tenant until one of its admins turns it off.

For: Operators and developers looking up a command.

Works-council mode is on for every tenant until one of its admins turns it off. While it is on, usage and cost figures summed over people (quota usage, the web UI's Cost and Budgets pages, and every API that sums per person) show a person's own figures only to that person, a team's only when it has at least the threshold's people (five, or more if you raise it with --threshold), and otherwise only the tenant's totals.

Quotas per person are still enforced. Records are not hidden: the audit trail, budget requests with who asked and who decided, and who started a job. --off turns the mode off and needs --reason, which the audit log keeps (tenant.works_council.off); --on turns it on again; lowering the threshold also needs --reason. Without flags it shows the mode.

## Usage

```bash
oz0 tenant works-council <tenant> [flags]
```

## Flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --decision-ref
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the decision or case the change follows, such as a case number (at most 200 characters)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print JSON instead of a table
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --off
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      turn the mode off: figures about every person and team are shown (needs --reason; audited)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --on
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      turn the mode on again
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --reason
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      why, for the audit log (at most 500 characters)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --threshold
      </code>
    </td>
    
    <td>
      int
    </td>
    
    <td>
      
    </td>
    
    <td>
      the smallest team whose figures are shown, 5 or more
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.