# Configs

## Retrieve configuration files

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

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

Retrieve the configuration files for a given project.

### Parameters

- `project: String`

- `branch: String`

  Branch name, defaults to "main".

- `include: String`

### Returns

- `Hash[Symbol, { content}]`

  Config files contents

  - `content: String`

    The file content

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

config = stainless.projects.configs.retrieve(project: "project")

puts(config)
```

#### Response

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

## Generate config suggestions

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

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

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

### Parameters

- `project: String`

- `spec: String`

  OpenAPI spec

- `branch: String`

  Branch name

### Returns

- `Hash[Symbol, { content}]`

  Config files contents

  - `content: String`

    The file content

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

response = stainless.projects.configs.guess(project: "project", spec: "spec")

puts(response)
```

#### Response

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

## Domain Types

### Config Retrieve Response

- `Hash[Symbol, { content}]`

  Config files contents

  - `content: String`

    The file content

### Config Guess Response

- `Hash[Symbol, { content}]`

  Config files contents

  - `content: String`

    The file content