---
title: "Generate new suggestions"
method: POST
path: "/threads/{id}/messages/{messageId}/suggestions"
tags: ["threads"]
---

# Generate new suggestions

`POST /threads/{id}/messages/{messageId}/suggestions`

Generates and stores new suggestions for a specific message

## Path parameters

- `id` string, required
- `messageId` string, required

## Request body

- SuggestionsGenerate
  - `maxSuggestions` number — Maximum number of suggestions to generate
  - `availableComponents` AvailableComponent[] — Available components that can be used with this suggestion
    - `props` object, required — JSON Schema for the component's props
    - `name` string, required
    - `description` string, required
    - `contextTools` ComponentContextToolMetadata[], required
      - `maxCalls` number — Maximum number of times this tool can be called in a single thread execution.Overrides project-level maxToolCalls setting for this specific tool.
      - `name` string, required
      - `description` string, required
      - `parameters` ToolParameters[], required
        - `name` string, required
        - `type` string, required
        - `description` string, required
        - `isRequired` boolean, required
        - `items` object
          - `type` string, required
        - `enumValues` string[]
        - `schema` object

## Response `201`

New suggestions generated successfully

- Suggestion[]
  - `id` string, required — Unique identifier for the suggestion
  - `messageId` string, required — ID of the message this suggestion is for
  - `title` string, required — Short title or summary of the suggestion
  - `detailedSuggestion` string, required — Detailed explanation of the suggestion
  - `description` string, required — Detailed explanation of the suggestion (alias for detailedSuggestion)
  - `metadata` object — Additional metadata for the suggestion

## Other responses

- `400` — Invalid request parameters
- `404` — Message not found
- `500` — Failed to generate suggestions

---

[API](https://skmtc.net/tambo-ai/apis/tambo-api.md) · [All operations](https://skmtc.net/tambo-ai/apis/tambo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tambo-ai/tambo-api/versions/312691b28f1c/schema)