---
title: "Ask Suggestions"
method: GET
path: "/v1/ask/suggestions"
---

# Ask Suggestions

`GET /v1/ask/suggestions`

## Request

- Base URL: `https://api.graphify.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.graphify.com/v1/ask/suggestions`
- Auth: HTTP bearer

Up to 4 suggested Ask questions for one repository (Ask suggestions, phase 1).

Deterministic templates over signals already stored here -- recent PR reviews that
need attention, files with an FV-reported behaviour change, files named by review
findings (see ``app/services/ask_suggestions``). No model call. 404 while
``ask_suggestions_enabled`` is off so the dashboard hides the chips.

Gated at REPOS_READ (it is a repo-scoped Ask surface) AND BUILDS_READ (the signals
are review/FV run artifacts, which read at BUILDS_READ). Tenant-scoped: the repo
must belong to the caller's tenant (404 otherwise), and every signal query filters
on tenant + repo. Cached briefly per (tenant, repo) on this task.

## Query parameters

- `repositoryId` string, nullable

## Headers

- `X-Graphify-Tenant-ID` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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