---
title: "Generate AI-Powered Structured Output Suggestions"
method: POST
path: "/structured-output/suggest"
tags: ["Structured Outputs"]
---

# Generate AI-Powered Structured Output Suggestions

`POST /structured-output/suggest`

Analyzes assistant configuration and generates contextual structured output recommendations

## Request body

- GenerateStructuredOutputSuggestionsDTO
  - `assistantId` string, required — The assistant ID to analyze and generate suggestions for
  - `count` number — Number of suggestions to generate
  - `excludeIds` string[] — Existing structured output IDs to exclude from suggestions
  - `seed` number — Iteration/seed for generating diverse suggestions (0 = first generation, 1+ = regenerations with increasing specificity)

## Response `200`

Array of suggested structured outputs with relevance scores

## Other responses

- `201`

## Changes

> 29 revisions in range; 5 could not be searched.

- **2025-11-12** `acbf00c4a7f9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vapiai/apis/vapi-api/changes/structured-output/suggest/post.md)

---

[API](https://skmtc.dev/vapiai/apis/vapi-api.md) · [All operations](https://skmtc.dev/vapiai/apis/vapi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vapiai/vapi-api/revisions/acbf00c4a7f9/schema)