# Traces Commands

> See [Traces module docs](../../modules/traces) for permissions and data model.

# Traces Commands

See [Traces module docs](../../modules/traces) for permissions and data model.

### `soat list-traces`

List traces

- Method: `GET`
- Path: `/api/v1/traces`

#### Usage

```bash
soat list-traces
```

#### Options

##### `--project-id`

Project public ID to filter by

- Source: `query`
- Required: no
- Type: `string`

##### `--limit`

Maximum number of results to return

- Source: `query`
- Required: no
- Type: `integer`
- Default: `50`

##### `--offset`

Number of results to skip

- Source: `query`
- Required: no
- Type: `integer`
- Default: `0`

### `soat get-trace`

Get a trace

- Method: `GET`
- Path: `/api/v1/traces/{trace_id}`

#### Usage

```bash
soat get-trace --trace-id <string>
```

#### Options

##### `--trace-id`

Public ID of the trace

- Source: `path`
- Required: yes
- Type: `string`

### `soat get-trace-tree`

Get trace tree

- Method: `GET`
- Path: `/api/v1/traces/{trace_id}/tree`

#### Usage

```bash
soat get-trace-tree --trace-id <string>
```

#### Options

##### `--trace-id`

Public ID of any trace in the tree (root or child)

- Source: `path`
- Required: yes
- Type: `string`

##### `--include`

Comma-separated list of related resources to embed on each node. Supported value: `generations` — attaches all generations that belong to each trace node (including sub-agent generations linked via `initiator_generation_id`). 

- Source: `query`
- Required: no
- Type: `string`
- Example: `generations`

### `soat purge-trace-content`

Purge trace content

- Method: `DELETE`
- Path: `/api/v1/traces/{trace_id}/content`

#### Usage

```bash
soat purge-trace-content --trace-id <string>
```

#### Options

##### `--trace-id`

Public ID of the trace

- Source: `path`
- Required: yes
- Type: `string`