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

GET

/v1/avatar-presets

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);
}

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

Authorizations

None

Responses

200

application/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

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

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