---
title: "Suggest Action Grid Endpoint"
method: POST
path: "/core/agents/suggest-action-grid"
tags: ["Agents"]
---

# Suggest Action Grid Endpoint

`POST /core/agents/suggest-action-grid`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/agents/suggest-action-grid`
- Auth: HTTP bearer

Suggest a starting-message action grid from the agent's instructions.

Asks Claude Sonnet, via structured outputs, to propose a small set of
quick-action buttons. Stateless — operates on the instructions in the
request body so it works on unsaved drafts.

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- SuggestActionGridRequest: Request schema for auto-suggesting a starting-message action grid. The response is a ``StartingActionGrid`` proposed by an LLM from the agent's instructions.
  - `instructions` string: The agent's instructions to base the quick actions on.

## Response `200`

Successful Response

- StartingActionGrid: Optional action grid shown alongside the starting message (chat UI). Rendered on WebRTC sessions as a grid of quick-action buttons. Each item's ``label`` is sent back verbatim as the action value when the user taps it.
  - `title` string, nullable: Optional heading (defaults to 'How can I help?').
  - `items` StartingActionGridItem[]
    - `label` string, required
    - `icon` string, nullable: Icon key for the button. One of: suitcase, ruler, truck, credit, headset, star, reload. Falls back to a default icon if omitted or unknown.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)