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

> Usage and flags for oz0 tool call.

For: Operators and developers looking up a command.

Call one function of a tenant's tool, such as jev.decide (or by its address, such as jev-tools/jev.decide, which the server checks against the plugin that provides the tool), with --args as its arguments, and print what it returned.

The call runs as a job of its own (tool-\<id>, named tool:\<function> in job list), on a node of the tenant whose plugin has the function ready, or the one --node names: the tenant's tool policy, the plugins' pre_tool_call and post_tool_call hooks and approvals decide it as they decide an agent's call. A call that waits for approval waits until someone decides it (`approval list`), and a refused one says which rule refused it and how to fix it.

The job's trace is in `job trace` and on its page in the web UI.

## Usage

```bash
oz0 tool call <tool>.<function> | <plugin>/<tool>.<function> [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --args
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        {}
      </code>
    </td>
    
    <td>
      the function's arguments, as a JSON object
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --id
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the call's job ID (default: tool-&lt;a new random one>); an ID whose ended job's files are still kept is refused
    </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>
        --node
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        an online node of the tenant that has the function ready
      </code>
    </td>
    
    <td>
      the node to call it on
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --quiet
      </code>
      
       (<code>
        -q
      </code>
      
      )
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print only the result
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      tenant
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --wait
      </code>
    </td>
    
    <td>
      duration
    </td>
    
    <td>
      <code>
        until the call ends, approvals included
      </code>
    </td>
    
    <td>
      longest to wait for the result
    </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.