---
title: "Get the stored AI Widget appearance for an app"
method: GET
path: "/v2/apps/{appId}/widget/appearance"
tags: ["AI Widget"]
---

# Get the stored AI Widget appearance for an app

`GET /v2/apps/{appId}/widget/appearance`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/widget/appearance`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the website widget appearance stored for the App: a map of the
widget's `data-*` attribute names to string values, holding only the
values that differ from the widget's defaults.

Auth: tenantActor, with App settings read access (the App's creator
always has it).

## Path parameters

- `appId` string, required

## Response `200`

```
{ ok: true, appearance: { [attribute: string]: string } }   // {} when nothing is stored
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Caller has no access to this app.
- `404`: ``` { error: 'App not found', code: 'APP_NOT_FOUND' } ```
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)