# Configs

## Retrieve configuration files

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

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

Retrieve the configuration files for a given project.

### Parameters

- `ConfigRetrieveParams params`

  - `Optional<String> project`

  - `Optional<String> branch`

    Branch name, defaults to "main".

  - `Optional<String> include`

### Returns

- `class ConfigRetrieveResponse:`

  Config files contents

  - `String content`

    The file content

### Example

```java
package com.stainless.api.example;

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

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        StainlessClient client = StainlessOkHttpClient.builder()
            .fromEnv()
            .project("example-project")
            .build();

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

#### Response

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

## Generate config suggestions

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

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

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

### Parameters

- `ConfigGuessParams params`

  - `Optional<String> project`

  - `String spec`

    OpenAPI spec

  - `Optional<String> branch`

    Branch name

### Returns

- `class ConfigGuessResponse:`

  Config files contents

  - `String content`

    The file content

### Example

```java
package com.stainless.api.example;

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

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        StainlessClient client = StainlessOkHttpClient.builder()
            .fromEnv()
            .project("example-project")
            .build();

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

#### Response

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