---
title: "Create AI suggestion"
method: POST
path: "/orgs/ai/suggestions"
tags: ["AI"]
---

# Create AI suggestion

`POST /orgs/ai/suggestions`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/ai/suggestions`
- Auth: HTTP bearer

Rewrite a text (improve, polish, formalize, friendly, shorten), or draft a reply or an internal note for a chat.

## Request body

- CreateAiSuggestionSchema: Schema for creating an AI suggestion
  - `action` 'improve' | 'polish' | 'formalize' | 'friendly' | 'shorten' | 'reply' | 'note', required: Schema for the action to perform on the suggestion
  - `text` string: The text to rewrite. Required for every action except `reply` and `note`
  - `chat_id` string: The chat to draft from. Required for the `reply` and `note` actions

## Response `200`

- AiSuggestionSchema: Schema representing an AI suggestion
  - `suggestion` string, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)