---
title: "Settings page payload (used by /settings)."
method: GET
path: "/api/v1/settings"
tags: ["Settings"]
---

# Settings page payload (used by /settings).

`GET /api/v1/settings`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/settings`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Identity comes from `current_user()` (the auth gate's resolved user,<br/>which is the TARGET while impersonating), never from the Flask<br/>session: the session read ignored Bearer-JWT callers and leaked the<br/>ADMIN's settings into an impersonated view (spec §3.7, 2026-08-11).

## Response `200`

OK

- SettingsViewResponse
  - `image_models` unknown[]
    - unknown
  - `resolved_image` unknown
  - `resolved_writing` unknown
  - `settings` SettingsValues, required
    - `default_image_resolution` string
    - `default_text_style` string, nullable
    - `default_video_engine` string, nullable
    - `model_image` string, nullable
    - `model_writing` string, nullable
    - `upscaler_backend` string
  - `user_id` integer, nullable
  - `writing_models` unknown[]
    - unknown

## Other responses

- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)