# Configs

## Retrieve configuration files

`$ stl projects:configs retrieve`

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

Retrieve the configuration files for a given project.

### Parameters

- `--project: optional string`

  Path param

- `--branch: optional string`

  Query param: Branch name, defaults to "main".

- `--include: optional string`

  Query param

### Returns

- `ProjectConfigGetResponse: map[object { content } ]`

  Config files contents

  - `content: string`

    The file content

### Example

```cli
stl projects:configs retrieve \
  --api-key 'My API Key' \
  --project project
```

#### Response

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

## Generate config suggestions

`$ stl projects:configs guess`

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

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

### Parameters

- `--project: optional string`

  Path param

- `--spec: string`

  Body param: OpenAPI spec

- `--branch: optional string`

  Body param: Branch name

### Returns

- `ProjectConfigGuessResponse: map[object { content } ]`

  Config files contents

  - `content: string`

    The file content

### Example

```cli
stl projects:configs guess \
  --api-key 'My API Key' \
  --project project \
  --spec spec
```

#### Response

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