---
title: "Add a note — annotate a capability with feedback or a correction"
method: POST
path: "/notes"
tags: ["catalog"]
---

# Add a note — annotate a capability with feedback or a correction

`POST /notes`

Attaches a note to any capability (operation, workflow, or API). Use to report auth corrections, schema errors, or updated Arazzo workflows. Notes feed back into the catalog improvement loop.

## Request body

- NoteCreate — Create a note on any Jentic resource for knowledge accumulation and catalog improvement.
  - `resource` string, required — Resource identifier: operation_id (METHOD/host/path), api_id, or workflow slug
  - `type` string, nullable — Note category: 'auth_quirk', 'usage_hint', 'execution_feedback', or 'correction'
  - `note` string, required — Note content — be specific and actionable
  - `execution_id` string, nullable — Link to specific execution for context (optional)
  - `confidence` string, nullable — Confidence level: 'observed', 'suspected', or 'verified'
  - `source` string, nullable — Observation source, e.g. 'test run', 'production', 'documentation'

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-13** `76e8f6063728` — 9 breaking, 12 warning, 15 info
  - added the new required request property `note`
  - removed `#/components/schemas/NoteConfidence` from the `confidence` request property `anyOf` list
  - removed `#/components/schemas/NoteSource` from the `source` request property `anyOf` list
  - removed `#/components/schemas/NoteType` from the `type` request property `anyOf` list
  - …32 more

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/notes/post.md)

---

[API](https://skmtc.dev/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.dev/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/revisions/bd463fcefb14/schema)