---
title: "List notes for a resource"
method: GET
path: "/notes"
tags: ["catalog"]
---

# List notes for a resource

`GET /notes`

List notes attached to resources (operations, workflows, APIs).

Notes capture observations from execution — success signals, failure patterns,
data validation findings, and human annotations. Agents use notes to build
operational knowledge and improve reliability over time.

Filter by `?resource={id}` to see notes for a specific operation/workflow,
or by `?type={type}` to filter by note category (e.g., "success", "error", "validation").

## Query parameters

- `resource` string, nullable — Filter notes by resource ID (capability_id, api_id, or workflow slug)
- `type` string, nullable — Filter notes by type (auth_quirk, usage_hint, execution_feedback, correction)
- `limit` integer — Maximum number of notes to return (1-500)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-13** `76e8f6063728` — 4 breaking, 12 warning, 13 info
  - media type `application/problem+json` was changed to a more general media type `application/json` for the response status `422`
  - the response property `detail` became optional for the status `422`
  - the `detail` response property's maxLength was unset from `4096` for the response status `422`
  - the `detail` response's property type/format changed from `string`/`` to `array`/`` for status `422`
  - …25 more

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/notes/get.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)