# Configs

## Retrieve configuration files

`projects().configs().retrieve(ConfigRetrieveParamsparams = ConfigRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none()) : ConfigRetrieveResponse`

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

Retrieve the configuration files for a given project.

### Parameters

- `params: ConfigRetrieveParams`

  - `project: Optional<String>`

  - `branch: Optional<String>`

    Branch name, defaults to "main".

  - `include: Optional<String>`

### Returns

- `class ConfigRetrieveResponse:`

  Config files contents

  - `content: String`

    The file content

### Example

```kotlin
package com.configure_me_stainless_v0.api.example

import com.configure_me_stainless_v0.api.client.StainlessClient
import com.configure_me_stainless_v0.api.client.okhttp.StainlessOkHttpClient
import com.configure_me_stainless_v0.api.models.projects.configs.ConfigRetrieveParams
import com.configure_me_stainless_v0.api.models.projects.configs.ConfigRetrieveResponse

fun main() {
    val client: StainlessClient = StainlessOkHttpClient.builder()
        .fromEnv()
        .project("example-project")
        .build()

    val config: ConfigRetrieveResponse = client.projects().configs().retrieve()
}
```

#### Response

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

## Generate config suggestions

`projects().configs().guess(ConfigGuessParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : ConfigGuessResponse`

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

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

### Parameters

- `params: ConfigGuessParams`

  - `project: Optional<String>`

  - `spec: String`

    OpenAPI spec

  - `branch: Optional<String>`

    Branch name

### Returns

- `class ConfigGuessResponse:`

  Config files contents

  - `content: String`

    The file content

### Example

```kotlin
package com.configure_me_stainless_v0.api.example

import com.configure_me_stainless_v0.api.client.StainlessClient
import com.configure_me_stainless_v0.api.client.okhttp.StainlessOkHttpClient
import com.configure_me_stainless_v0.api.models.projects.configs.ConfigGuessParams
import com.configure_me_stainless_v0.api.models.projects.configs.ConfigGuessResponse

fun main() {
    val client: StainlessClient = StainlessOkHttpClient.builder()
        .fromEnv()
        .project("example-project")
        .build()

    val params: ConfigGuessParams = ConfigGuessParams.builder()
        .spec("spec")
        .build()
    val response: ConfigGuessResponse = client.projects().configs().guess(params)
}
```

#### Response

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