> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-sdk-add-methods-properties.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs methods

## <Badge color="yellow" size="lg" shape="rounded">Class</Badge> wandb.apis.public.Runs

## <Badge color="blue" size="lg" shape="rounded">method</Badge> Runs.histories()

Return sampled history metrics for all runs that fit the filters conditions.

```python theme={null}
self,
samples: 'int' = 500,
keys: 'list[str] | None' = None,
x_axis: 'str' = '_step',
format: "Literal['default', 'pandas', 'polars']" = 'default',
stream: "Literal['default', 'system']" = 'default'
```

##### Arguments

<ResponseField name="samples" type="int">
  The number of samples to return per run
</ResponseField>

<ResponseField name="keys" type="list[str] | None">
  Only return metrics for specific keys
</ResponseField>

<ResponseField name="x_axis" type="str">
  Use this metric as the xAxis defaults to \_step
</ResponseField>

<ResponseField name="format" type="Literal['default', 'pandas', 'polars']">
  Format to return data in, options are "default", "pandas", "polars"
</ResponseField>

<ResponseField name="stream" type="Literal['default', 'system']">
  "default" for metrics, "system" for machine metrics
</ResponseField>

##### Returns

`pandas.DataFrame`: If `format="pandas"`, returns a `pandas.DataFrame` of history metrics.

## <Badge color="blue" size="lg" shape="rounded">method</Badge> Paginator.**next**()

Return the next item from the iterator. When exhausted, raise StopIteration

```python theme={null}
self
```

## <Badge color="blue" size="lg" shape="rounded">method</Badge> Paginator.update\_variables()

Update the query variables for the next page fetch.

```python theme={null}
self
```

## <Badge color="blue" size="lg" shape="rounded">method</Badge> Runs.upgrade\_to\_full()

Upgrade this Runs collection from lazy to full mode.

This switches to fetching full run data and
upgrades any already-loaded Run objects to have full data.
Uses parallel loading for better performance when upgrading multiple runs.

```python theme={null}
self
```