---
title: "Read Home Suggestions"
method: GET
path: "/v1/teams/{team_id}/home/suggestions"
tags: ["home"]
---

# Read Home Suggestions

`GET /v1/teams/{team_id}/home/suggestions`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/teams/{team_id}/home/suggestions`
- Auth: none declared

Stormy's next moves for this business (`home/next.md`), checked against
the tree and, for a connect card, against what is connected; with none, the
real things to start from (`fallback`). Never waits on a turn: a stale
record files one background refresh and the read answers now.

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Response `200`

Successful Response

- HomeSuggestions: What `GET /home/suggestions` answers.
  - `suggestions` HomeCard[]
    - `id` string, required
    - `kind` 'teach' | 'setup' | 'do' | 'tip' | 'check' | 'live' | 'connect', required
    - `title` string, required
    - `why` string
    - `noticed` string
    - `say` string
    - `icon` string
    - `tone` string
    - `ref` string
    - `need` string
    - `apps` ConnectApp[]
      - `slug` string, required
      - `name` string, required
      - `state` 'off' | 'broken'
  - `fallback` HomeFallback[]
    - `source` 'ask' | 'desk' | 'connect' | 'start', required
    - `title` string
    - `line` string
    - `desk` string
    - `path` string
    - `need` string
    - `apps` ConnectApp[]
      - `slug` string, required
      - `name` string, required
      - `state` 'off' | 'broken'
  - `ready` boolean
  - `refreshing` boolean
  - `written_at` string
  - `headline` string
  - `starting` boolean

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-07** `534eae1fcead`: 1 info
  - added the optional property `starting` to the response with the `200` status
- **2026-10-06** `8764aa9a19c7`: 1 warning
  - added the new `start` enum value to the `fallback/items/source` response property for the response status `200`
- **2026-10-03** `949d411a4466`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/teams/:team_id/home/suggestions/get.md)

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/a40e83844eaa?raw)