# Configs

## Retrieve configuration files

`projects.configs.retrieve(ConfigRetrieveParams**kwargs)  -> ConfigRetrieveResponse`

**get** `/v0/projects/{project}/configs`

Retrieve the configuration files for a given project.

### Parameters

- `project: Optional[str]`

- `branch: Optional[str]`

  Branch name, defaults to "main".

- `include: Optional[str]`

### Returns

- `Dict[str, ConfigRetrieveResponseItem]`

  Config files contents

  - `content: str`

    The file content

### Example

```python
import os
from stainless_v0 import Stainless

client = Stainless(
    api_key=os.environ.get("STAINLESS_API_KEY"),  # This is the default and can be omitted
)
config = client.projects.configs.retrieve(
    project="project",
)
print(config)
```

#### Response

```json
{
  "foo": {
    "content": "content"
  }
}
```

## Generate config suggestions

`projects.configs.guess(ConfigGuessParams**kwargs)  -> ConfigGuessResponse`

**post** `/v0/projects/{project}/configs/guess`

Generate suggestions for changes to config files based on an OpenAPI spec.

### Parameters

- `project: Optional[str]`

- `spec: str`

  OpenAPI spec

- `branch: Optional[str]`

  Branch name

### Returns

- `Dict[str, ConfigGuessResponseItem]`

  Config files contents

  - `content: str`

    The file content

### Example

```python
import os
from stainless_v0 import Stainless

client = Stainless(
    api_key=os.environ.get("STAINLESS_API_KEY"),  # This is the default and can be omitted
)
response = client.projects.configs.guess(
    project="project",
    spec="spec",
)
print(response)
```

#### Response

```json
{
  "foo": {
    "content": "content"
  }
}
```

## Domain Types

### Config Retrieve Response

- `Dict[str, ConfigRetrieveResponseItem]`

  Config files contents

  - `content: str`

    The file content

### Config Guess Response

- `Dict[str, ConfigGuessResponseItem]`

  Config files contents

  - `content: str`

    The file content