# Configs

## Retrieve configuration files

`$client->projects->configs->retrieve(string project, ?string branch, ?string include): ConfigGetResponse`

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

Retrieve the configuration files for a given project.

### Parameters

- `project: string`

- `branch?:optional string`

  Branch name, defaults to "main".

- `include?:optional string`

### Returns

- `array<string,ConfigGetResponseItem>`

  - `string content`

    The file content

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$config = $client->projects->configs->retrieve(
  project: 'project', branch: 'branch', include: 'include'
);

var_dump($config);
```

#### Response

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

## Generate config suggestions

`$client->projects->configs->guess(string project, string spec, ?string branch): 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?:optional string`

  Branch name

### Returns

- `array<string,ConfigGuessResponseItem>`

  - `string content`

    The file content

### Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'My API Key', environment: 'staging');

$response = $client->projects->configs->guess(
  project: 'project', spec: 'spec', branch: 'branch'
);

var_dump($response);
```

#### Response

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