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

# Update Settings

> Update the authenticated user's settings

Updates the authenticated user's settings, such as default hardware configuration for new workspaces.

## Authentication

Requires a valid Bearer token.

## Request Body

<ParamField body="default_hardware" type="object" required>
  Default hardware configuration for new workspaces.

  <Expandable title="Hardware object">
    <ParamField body="cpu_kind" type="string">
      CPU type (e.g., `"shared"`, `"performance"`).
    </ParamField>

    <ParamField body="cpus" type="integer">
      Number of CPUs.
    </ParamField>

    <ParamField body="memory_mb" type="integer">
      Memory in megabytes.
    </ParamField>

    <ParamField body="volume_size_gb" type="integer">
      Volume size in gigabytes.
    </ParamField>

    <ParamField body="gpu_kind" type="string">
      GPU type, or `null` for no GPU.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "default_hardware": {
      "cpu_kind": "shared",
      "cpus": 2,
      "memory_mb": 2048,
      "volume_size_gb": 10
    }
  }
  ```
</RequestExample>

## Response

Returns `200 OK` with the updated settings.

<ResponseExample>
  ```json 200 theme={null}
  {
    "default_hardware": {
      "cpu_kind": "shared",
      "cpus": 2,
      "memory_mb": 2048,
      "volume_size_gb": 10,
      "gpu_kind": null
    }
  }
  ```
</ResponseExample>

## Errors

| Status | Description                                  |
| ------ | -------------------------------------------- |
| `400`  | Bad Request — invalid hardware configuration |
| `401`  | Unauthorized — missing or invalid token      |