---
title: "ezgh obs ai conversations search"
description: "Search a dataset's conversations, newest first."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh obs ai conversations search

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh obs ai conversations search --dataset d [--agent a] [flags]
```

Search the conversations of a dataset: the runs that share one gen_ai.conversation.id. Without `--from`, the last hour. Times are RFC 3339, a date, or a duration ago (2h, 7d).

Part of [`ezgh obs ai conversations`](/cli/reference/obs-ai-conversations).

## Examples

```sh
ezgh obs ai conversations search --dataset production --agent support --from 7d
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--agent` | string |  | only this agent |
| `--all` | boolean |  | follow nextCursor through every page |
| `--conversation` | string |  | only this conversation ID |
| `--cursor` | string |  | start from this page (a previous page's nextCursor) |
| `--dataset` | string |  | the dataset: its ID, slug or environment (required) |
| `--environment` | string |  | only this environment |
| `--from` | string |  | start of the time range (default 1h ago) |
| `--limit` | int | `25` | items per page, 1 to 100 |
| `--model` | string |  | only this model |
| `--provider` | string |  | only this provider |
| `--service` | string |  | only this service |
| `--status` | string |  | only runs with this status (ok or error) |
| `--to` | string |  | end of the time range (default now) |
| `--tool` | string |  | only runs that called this tool |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/obs-ai-conversations-search/index.mdx
