# Dotfiles

## GetDotfilesConfiguration

`users.dotfiles.get(DotfileGetParams**kwargs)  -> DotfileGetResponse`

**post** `/gitpod.v1.UserService/GetDotfilesConfiguration`

Gets the dotfiles for a user.

Use this method to:

- Retrieve user dotfiles

### Examples

- Get dotfiles:

  Retrieves the dotfiles for the current user.

  ```yaml
  {}
  ```

### Parameters

- `empty: Optional[bool]`

### Returns

- `class DotfileGetResponse: …`

  - `dotfiles_configuration: DotfilesConfiguration`

    - `repository: Optional[str]`

      The URL of a dotfiles repository.

### Example

```python
import os
from gitpod import Gitpod

client = Gitpod(
    bearer_token=os.environ.get("GITPOD_API_KEY"),  # This is the default and can be omitted
)
dotfile = client.users.dotfiles.get()
print(dotfile.dotfiles_configuration)
```

#### Response

```json
{
  "dotfilesConfiguration": {
    "repository": "https://example.com"
  }
}
```

## SetDotfilesConfiguration

`users.dotfiles.set(DotfileSetParams**kwargs)  -> object`

**post** `/gitpod.v1.UserService/SetDotfilesConfiguration`

Sets the dotfiles configuration for a user.

Use this method to:

- Configure user dotfiles
- Update dotfiles settings

### Examples

- Set dotfiles configuration:

  Sets the dotfiles configuration for the current user.

  ```yaml
  {
    "repository": "https://github.com/gitpod-io/dotfiles",
  }
  ```

- Remove dotfiles:

  Removes the dotfiles for the current user.

  ```yaml
  {}
  ```

### Parameters

- `repository: Optional[str]`

### Returns

- `object`

### Example

```python
import os
from gitpod import Gitpod

client = Gitpod(
    bearer_token=os.environ.get("GITPOD_API_KEY"),  # This is the default and can be omitted
)
response = client.users.dotfiles.set()
print(response)
```

#### Response

```json
{}
```

## Domain Types

### Dotfiles Configuration

- `class DotfilesConfiguration: …`

  - `repository: Optional[str]`

    The URL of a dotfiles repository.

### Dotfile Get Response

- `class DotfileGetResponse: …`

  - `dotfiles_configuration: DotfilesConfiguration`

    - `repository: Optional[str]`

      The URL of a dotfiles repository.