---
title: "oz0 tenant offload"
description: "Usage and flags for oz0 tenant offload."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/tenant/offload"
---
# oz0 tenant offload

> Usage and flags for oz0 tenant offload.

For: Operators and developers looking up a command.

A tool result whose text weighs more than a job's threshold (estimated tokens) is kept as a file of the job's tree, readable only by that tree, sealed and erased with its jobs, and the model reads a stub instead: the result's size and an outline made without a model, with oz.read_result to read a section, a range of lines or a view of it. Cards, the job's history and its trace keep the whole result.

--default is the threshold of an agent whose definition sets no offload: a number of tokens, off, or platform for the platform's default (10000 tokens, provisional until measured). --ceiling is the most an agent may set, and what an agent's offload: off becomes: a number of tokens, or none to let agents set any threshold or turn offloading off. Without flags it shows the settings in effect.

The settings are part of the tenant's tool policy, so a change takes --reason (or $OZ0_REASON) as any tool-policy change does. Jobs that are running keep the threshold they started with.

## Usage

```bash
oz0 tenant offload <tenant> [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --ceiling
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the most an agent may set, and what its off becomes: tokens, or none
    </td>
  </tr>
  
  <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>
        --default
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the threshold of an agent that sets none: tokens, off, or platform
    </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>
        --reason
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      why, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it
    </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.