---
title: "Get First Query Suggestions"
method: GET
path: "/api/v1/first-query/suggestions"
tags: ["first-query"]
---

# Get First Query Suggestions

`GET /api/v1/first-query/suggestions`

Starting questions, led by the person's stated focus.

``context_workspace_id`` is for staff running as a customer workspace; for
anyone else, or a workspace that cannot be selected, the answer is 409.

Empty suggestions are a valid answer, not an error: the screen keeps its
placeholder and composer either way, so a miss degrades rather than fails.

## Query parameters

- `context_workspace_id` string, uuid, nullable

## Response `200`

Successful Response

- FirstQuerySuggestions — What the query-first screen renders before the user types.
  - `suggestions` FirstQuerySuggestion[]
    - `key` string, required
    - `text` string, required
    - `source` 'focus' | 'context' | 'written' | 'default', required — Why a question is on the screen, for the funnel that measures them.
  - `site_focus` SiteFocus[]
  - `site_focus_other` string, nullable
  - `derived_site_focus` SiteFocus[]

## Other responses

- `409` — Workspace context unavailable.
- `422` — Validation Error

## Changes

- **2026-09-24** `8beaac28e195` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/first-query/suggestions/get.md)

---

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