---
title: "Get Home Dashboard"
method: GET
path: "/api/home"
tags: ["home", "private"]
---

# Get Home Dashboard

`GET /api/home`

## Response `200`

Successful Response

- HomeDashboardResponse
  - `generated_at` string, date-time, required
  - `timezone` string, required
  - `attention` HomeAttentionItem[], required
    - `id` string, required
    - `kind` 'approval' | 'setup' | 'paused' | 'credits' | 'question', required
    - `priority` 'high' | 'normal', required
    - `title` string, required
    - `description` string, required
    - `why_it_matters` string, required
    - `expert` HomeExpert
      - `id` string, required
      - `name` string, required
      - `role` string, required
      - `avatar_url` string, nullable, required
    - `agent_name` string, nullable
    - `created_at` string, date-time, nullable
    - `preview` string, nullable
    - `review` PendingHumanReviewModel — Response model for pending human review data. Represents a human review request that is awaiting user action. Contains all necessary information for a user to review and approve or reject data from a Human-in-the-Loop block execution. Attributes: id: Unique identifier for the review record user_id: ID of the user who must perform the review node_exec_id: ID of the node execution that created this review node_id: ID of the node definition (for grouping reviews from same node) graph_exec_id: ID of the graph execution containing the node graph_id: ID of the graph template being executed graph_version: Version number of the graph template payload: The actual data payload awaiting review instructions: Instructions or message for the reviewer editable: Whether the reviewer can edit the data status: Current review status (WAITING, APPROVED, or REJECTED) review_message: Optional message from the reviewer created_at: Timestamp when review was created updated_at: Timestamp when review was last modified reviewed_at: Timestamp when review was completed (if applicable)
      - `node_exec_id` string, required — Node execution ID (primary key)
      - `node_id` string — Node definition ID (for grouping)
      - `user_id` string, required — User ID associated with the review
      - `graph_exec_id` string, required — Graph execution ID
      - `graph_id` string, required — Graph ID
      - `graph_version` integer, required — Graph version
      - `payload` union, required — The actual data payload awaiting review
        - object
        - unknown[]
          - unknown
        - string
        - integer
        - number
        - boolean
      - `instructions` string, nullable — Instructions or message for the reviewer
      - `editable` boolean, required — Whether the reviewer can edit the data
      - `status` 'WAITING' | 'APPROVED' | 'REJECTED', required
      - `review_message` string, nullable — Optional message from the reviewer
      - `expert_id` string, nullable — Expert attributed to the requesting run
      - `expert_name` string, nullable
      - `expert_avatar_url` string, nullable
      - `agent_name` string, nullable — Display name of the agent that requested the review
      - `library_agent_id` string, nullable — For run deep links
      - `session_id` string, nullable — Chat session id for copilot run_block reviews
      - `was_edited` boolean, nullable — Whether the data was modified during review
      - `processed` boolean — Whether the review result has been processed by the execution engine
      - `created_at` string, date-time, required — When the review was created
      - `updated_at` string, date-time, nullable — When the review was last updated
      - `reviewed_at` string, date-time, nullable — When the review was completed
    - `primary_action` HomeAction, required
      - `label` string, required
      - `href` string, required
    - `secondary_action` HomeAction
      - `label` string, required
      - `href` string, required
  - `briefing` HomeBriefing, required
    - `generated_at` string, date-time, required
    - `window_started_at` string, date-time, required
    - `completed_count` integer, required
    - `failed_count` integer, required
    - `routine_count` integer, required
    - `outcomes` HomeBriefingOutcome[], required
      - `id` string, required
      - `status` 'completed' | 'failed', required
      - `title` string, required
      - `summary` string, required
      - `expert` HomeExpert
        - `id` string, required
        - `name` string, required
        - `role` string, required
        - `avatar_url` string, nullable, required
      - `agent_name` string, required
      - `occurred_at` string, date-time, nullable
      - `duration_seconds` number
      - `cost_cents` integer
      - `link` string, nullable
      - `trigger` 'schedule' | 'webhook' | 'manual'
    - `author` HomeBriefingAuthor, required — Who wrote the brief. Always Otto, the account's built-in helper: the brief reports the team's work, so no member of the team authors it. `kind` is the seam a future personal-assistant author would widen.
      - `kind` 'autopilot', required
      - `name` string, required
      - `role` string, required
    - `narrative` string, nullable
    - `source` 'persisted' | 'live'
  - `active_tasks` HomeActiveTask[], required
    - `id` string, required
    - `title` string, required
    - `status` 'running' | 'queued', required
    - `expert` HomeExpert
      - `id` string, required
      - `name` string, required
      - `role` string, required
      - `avatar_url` string, nullable, required
    - `image_url` string, nullable
    - `started_at` string, date-time, nullable
    - `link` string, nullable
  - `upcoming_tasks` HomeUpcomingTask[], required
    - `id` string, required
    - `title` string, required
    - `kind` 'agent' | 'followup', required
    - `expert` HomeExpert
      - `id` string, required
      - `name` string, required
      - `role` string, required
      - `avatar_url` string, nullable, required
    - `image_url` string, nullable
    - `next_run_time` string, date-time, required
  - `team` HomeTeamSummary, required
    - `total` integer, required
    - `ready` integer, required
    - `working` integer, required
    - `needs_attention` integer, required
    - `spend_cents` integer
  - `agents` HomeAgentStatus[], required
    - `expert` HomeExpert, required
      - `id` string, required
      - `name` string, required
      - `role` string, required
      - `avatar_url` string, nullable, required
    - `status` 'ready' | 'working' | 'needs_setup' | 'paused' | 'failed', required
    - `detail` string, required
    - `next_run_time` string, date-time, nullable
    - `spend_cents` integer
  - `week` HomeWeekSummary, required
    - `run_count` integer, required
    - `completed_count` integer, required
    - `review_count` integer, required
    - `failed_count` integer, required
    - `total_runtime_seconds` number, required
    - `timed_run_count` integer, required
    - `total_cost_cents` integer, required
    - `credits_balance` integer, nullable, required
    - `daily` HomeDailyActivity[], required
      - `date` string, date, required
      - `completed_count` integer, required
      - `review_count` integer, required
      - `failed_count` integer, required
  - `recent_work` HomeRecentWork
    - `window_started_at` string, date-time, nullable
    - `completed_count` integer
    - `failed_count` integer
    - `groups` HomeRecentWorkGroup[]
      - `actor` HomeWorkActor, required
        - `kind` 'expert' | 'workflow' | 'autopilot', required
        - `name` string, required
        - `expert` HomeExpert
          - `id` string, required
          - `name` string, required
          - `role` string, required
          - `avatar_url` string, nullable, required
        - `image_url` string, nullable
        - `link` string, nullable
      - `latest_at` string, date-time, required
      - `runs` HomeBriefingOutcome[]
        - `id` string, required
        - `status` 'completed' | 'failed', required
        - `title` string, required
        - `summary` string, required
        - `expert` HomeExpert
          - `id` string, required
          - `name` string, required
          - `role` string, required
          - `avatar_url` string, nullable, required
        - `agent_name` string, required
        - `occurred_at` string, date-time, nullable
        - `duration_seconds` number
        - `cost_cents` integer
        - `link` string, nullable
        - `trigger` 'schedule' | 'webhook' | 'manual'
      - `items` HomeRecentWorkItem[]
        - `id` string, required
        - `category` 'file' | 'integration' | 'schedule', required
        - `event_type` string, required
        - `title` string, required
        - `occurred_at` string, date-time, required
        - `provider` string, nullable
        - `file_id` string, nullable
        - `mime_type` string, nullable
        - `session_title` string, nullable
        - `link` string, nullable
      - `run_count` integer
      - `file_count` integer
      - `integration_count` integer
      - `schedule_count` integer
    - `total_count` integer

## Other responses

- `401` — Authentication required

## Changes

- **2026-09-09** `6780d3287eda` — 1 info
  - added the required property `briefing/author` to the response with the `200` status
- **2026-09-07** `a66c17b39fd4` — 3 info
  - added the optional property `active_tasks/items/image_url` to the response with the `200` status
  - added the optional property `recent_work/groups/items/actor/image_url` to the response with the `200` status
  - added the optional property `upcoming_tasks/items/image_url` to the response with the `200` status
- **2026-09-07** `d3946c727d24` — 1 breaking, 5 warning, 13 info
  - the response property `recent_work/groups/items/items` became optional for the status `200`
  - removed the optional property `recent_work/groups/items/link` from the response with the `200` status
  - removed the optional property `recent_work/groups/items/more_count` from the response with the `200` status
  - removed the optional property `recent_work/groups/items/session_id` from the response with the `200` status
  - …15 more
- **2026-08-31** `0cd44ee67f4f` — 1 info
  - added the optional property `recent_work` to the response with the `200` status
- **2026-08-23** `9f56862bbc8a` — 1 warning
  - added the new `question` enum value to the `attention/items/kind` response property for the response status `200`

[Full history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/home/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)
