---
title: "oz0 job search"
description: "Search the job summaries management keeps, newest first, so jobs Temporal has forgotten are found too."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/job/search"
---
# oz0 job search

> Search the job summaries management keeps, newest first, so jobs Temporal has forgotten are found too.

For: Operators and developers looking up a command.

Search the job summaries management keeps, newest first, so jobs Temporal has forgotten are found too. QUERY holds words that must each be in a job's ID, agent, error or tags, and filters written as key:value: agent:, status:, tag:, node:, version:, group: (an error group from `job errors`), finding:, conversation:, is:top or is:child. For example: `job search agent:triage status:failed timeout`.

## Usage

```bash
oz0 job search [QUERY] [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --agent
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      only this agent's or flow's jobs, by name or &lt;plugin>/&lt;agent>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --all
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      read every page, not one
    </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>
        --limit
      </code>
    </td>
    
    <td>
      int32
    </td>
    
    <td>
      
    </td>
    
    <td>
      at most this many rows a page (the server's 25 when 0, at most 100)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --page-token
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      go on after the page before: the token it printed
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --since
      </code>
    </td>
    
    <td>
      duration
    </td>
    
    <td>
      <code>
        168h0m0s
      </code>
    </td>
    
    <td>
      jobs that started this long ago at most
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --status
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      only jobs with this status: running, completed, failed, canceled, timed_out or terminated
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tag
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      only jobs with this tag; repeat for several, which must all be there
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      tenant
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --until
      </code>
    </td>
    
    <td>
      duration
    </td>
    
    <td>
      
    </td>
    
    <td>
      jobs that started at least this long ago
    </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.