# The public catalog contains presentation metadata only, never agent configuration.

Source: <https://everruns.com/docs/api/operations/list_avatar_presets/>

GET

/v1/avatar-presets

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/avatar-presets';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/avatar-presets
```

* Production APIapp.everruns.com/api/v1/avatar-presets

## Authorizations

* **None**

## Responses

### 200

Media typeapplication/json

Array\<object>

Presentation and search metadata for one curated agent avatar.

object

**description**

required

Short description of the preset’s appearance.

string

**family**

required

Visual family used to filter the catalog.

string

**id**

required

Stable catalog ID used to select this preset.

string

**keywords**

required

Search terms covering the preset’s appearance and suggested uses.

Array\<string>

**name**

required

Display name of the character or design.

string

**role**

required

Suggested agent role for this design.

string

##### Example

```json
[
  {
    "family": "Familiars",
    "id": "familiars-patch",
    "name": "Patch",
    "role": "Developer"
  }
]
```