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

# Create Annotation

`POST /apps/annotations`

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

Creates a new annotation. Annotations provide predefined question-answer pairs that the app can match and return directly instead of generating a response.

## Request body

- CreateAnnotationRequest — Request body for creating a new annotation.
  - `question` string, required — Annotation question.
  - `answer` string, required — Annotation answer.

## 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.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)