---
title: "Dashboard payload (avatars + today's stats + recent runs + pending count)."
method: GET
path: "/api/v1/automation/dashboard"
tags: ["Automation"]
---

# Dashboard payload (avatars + today's stats + recent runs + pending count).

`GET /api/v1/automation/dashboard`

## 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/automation/dashboard`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>Scoped to the caller in SQL via `scope_query` inside the repository:<br/>regular users see only their own avatars / videos / runs; admins see<br/>every row.

## Response `200`

OK

- DashboardResponse
  - `avatars` AvatarHealth[], required
    - `auto_publish` integer
    - `default_engine` string, nullable
    - `default_text_style` string, nullable
    - `face_image` string, nullable
    - `heygen_avatar_id` string, nullable
    - `id` integer, required
    - `ig_connected` integer
    - `name` string, required
    - `pending_approvals` integer
    - `pillar_count` integer
    - `posting_frequency` integer, nullable
    - `posting_times` string, nullable
    - `timezone` string, nullable
    - `today_runs` integer
    - `total_completed` integer
    - `total_failed` integer
    - `voice_id` string, nullable
  - `pending_count` integer, required
  - `recent_runs` RecentRunRow[]
    - `avatar_id` integer, nullable
    - `avatar_name` string, nullable
    - `completed_at` unknown
    - `error_message` string, nullable
    - `id` integer, required
    - `started_at` unknown
    - `status` string, nullable
  - `today_stats` TodayStats, required
    - `completed` integer
    - `failed` integer
    - `pending` integer
    - `running` integer

## 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)