---
title: "Suggest Invitation Message"
method: POST
path: "/v1/interviews/{interview_id}/invitation-message/suggest"
tags: ["interviews"]
---

# Suggest Invitation Message

`POST /v1/interviews/{interview_id}/invitation-message/suggest`

Generate one AI suggestion for the campaign's invitation email message.

Written in the campaign's participant language with the workspace's
du/Sie salutation; repeated calls produce fresh variants because the
current field text is passed along as wording to avoid.

## Path parameters

- `interview_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- InvitationSuggestionRequest — Optional steering for the AI-suggested invitation message. ``campaign_title``/``campaign_goal``/``language`` mirror the builder's CURRENT (possibly unsaved) form values — the builder autosaves with a debounce, so the server row can lag what the user just changed.
  - `instructions` string, nullable
  - `current_message` string, nullable
  - `campaign_title` string, nullable
  - `campaign_goal` string, nullable
  - `campaign_background` string, nullable
  - `language` string, nullable
  - `topics` string[]
  - `target` 'invitation_message' | 'participant_context'

## Response `200`

Successful Response

- InvitationSuggestionResponse
  - `message` string, required

## Other responses

- `422` — Validation Error

---

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