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

# Settings resource

> Reference for client.settings.

Access these methods through `client.settings`.

## `client.settings.get`

Show your default sandbox provider and saved benchmark services.

```python Signature theme={null}
async def get() -> RunSettingsResponse
```

**Returns**

[`RunSettingsResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/settings#run-settings-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.settings.set_default_provider`

Run on this sandbox provider unless a run names another. Needs a login, not an access key.

```python Signature theme={null}
async def set_default_provider(provider: str) -> RunSettingsResponse
```

**Parameters**

providerrequired · str

**Returns**

[`RunSettingsResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/settings#run-settings-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.settings.set_benchmark_service`

Use this URL for your runs of a benchmark, replacing the URL and credential saved before.

Tracker sends the `auth_secret` secret's value in `auth_header`, `Authorization` by default. Needs a login, not an access key.

```python Signature theme={null}
async def set_benchmark_service(
    benchmark: str,
    url: str,
    *,
    auth_secret: str | None = None,
    auth_header: str | None = None,
) -> RunSettingsResponse
```

**Parameters**

benchmarkrequired · str

urlrequired · str

auth\_secretoptional · str | None · default: `None`

auth\_headeroptional · str | None · default: `None`

**Returns**

[`RunSettingsResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/settings#run-settings-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).

## `client.settings.remove_benchmark_service`

Go back to the hosted service for your runs of a benchmark.

```python Signature theme={null}
async def remove_benchmark_service(benchmark: str) -> RunSettingsResponse
```

**Parameters**

benchmarkrequired · str

**Returns**

[`RunSettingsResponse`](https://docs.valkyrie.vals.ai/reference/sdk/models/settings#run-settings-response)

For examples, see the [Python SDK guide](https://docs.valkyrie.vals.ai/sdk/resources.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.