---
title: "Create Annotation"
method: POST
path: "/apps/annotations"
tags: ["Annotations"]
---

# Create Annotation

`POST /apps/annotations`

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

Creates an annotation. Annotations are predefined question-answer pairs the app returns directly on a match, instead of generating a fresh response.

## Request body

- CreateAnnotationRequest — Request body for creating a new annotation.
  - `question` string, required — Question text the app matches incoming user input against.
  - `answer` string, required — Answer returned when this annotation is matched.

## Response `201`

Annotation created successfully.

- AnnotationItem
  - `id` string, uuid — Unique annotation identifier.
  - `question` string, nullable — Question text that triggers this annotation.
  - `answer` string, nullable — Predefined answer returned when the annotation is matched.
  - `hit_count` integer, nullable — Number of times this annotation has been matched and returned as a reply.
  - `created_at` integer, nullable — Creation timestamp (Unix epoch seconds).

---

[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)