---
title: "Configure Annotation Reply"
method: POST
path: "/apps/annotation-reply/{action}"
tags: ["Annotations"]
---

# Configure Annotation Reply

`POST /apps/annotation-reply/{action}`

**Available for**: Chatflow, Chatbot, Agent apps.

Enables or disables annotation reply for the app. Runs asynchronously; track progress with [Get Annotation Reply Job Status](/en/api-reference/annotations/get-annotation-reply-job-status).

The body is validated before the action runs, so `score_threshold`, `embedding_provider_name`, and `embedding_model_name` are required even for `disable`.

## Path parameters

- `action` 'enable' | 'disable', required

## Request body

- InitialAnnotationReplySettingsRequest — Request body for configuring annotation reply settings.
  - `embedding_provider_name` string, required — Embedding model provider (for example, `openai`). Get available providers from [Get Available Models](/en/api-reference/models/get-available-models).
  - `embedding_model_name` string, required — Embedding model used to vectorize annotations for matching (for example, `text-embedding-3-small`).
  - `score_threshold` number, float, required — Minimum similarity score for an annotation to be considered a match. Higher values require closer matches.

## Response `200`

Annotation reply settings task initiated.

- InitialAnnotationReplySettingsResponse
  - `job_id` string, uuid — Asynchronous job ID. Use with [Get Annotation Reply Job Status](/en/api-reference/annotations/get-annotation-reply-job-status) to track progress.
  - `job_status` string — Current job status: `waiting` (queued) or `processing` (in progress). `completed` and `error` are returned only by [Get Annotation Reply Job Status](/en/api-reference/annotations/get-annotation-reply-job-status).

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)