---
title: "Nudge Conversation"
method: POST
path: "/chat/{conversation_id}/nudge"
tags: ["Chat Widget"]
---

# Nudge Conversation

`POST /chat/{conversation_id}/nudge`

Send an idle nudge message to the conversation.

Rate-limited server-side: the nudge is only inserted if enough time
has passed since the last assistant message (based on idle_delay_seconds
configured on the widget). Returns nudged=false if rate-limited, no
idle_message is configured, or conversation is not active.

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

Successful Response

- NudgeResponse
  - `message` AppChatSchemasMessageResponse, required
    - `id` string, uuid, required
    - `role` string, required
    - `content` string, required
    - `created_at` string, date-time, required
  - `nudged` boolean, required — Whether a nudge was actually sent (false if rate-limited or no idle_message configured)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)