---
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 the annotation reply feature. The request body is validated before the action runs, so `embedding_provider_name`, `embedding_model_name`, and `score_threshold` are required for both `enable` and `disable`. Executes asynchronously; use [Get Annotation Reply Job Status](/en/api-reference/annotations/get-annotation-reply-job-status) to track progress.

## Path parameters

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

## Request body

- InitialAnnotationReplySettingsRequest — Request body for configuring annotation reply settings.
  - `embedding_provider_name` string, required — Name of the embedding model provider (e.g., `openai`, `cohere`).
  - `embedding_model_name` string, required — Name of the embedding model to use for annotation matching (e.g., `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.dev/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.dev/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/61cc4ae17b90/schema)