---
title: "Create Note"
method: POST
path: "/notes"
tags: ["Notes"]
---

# Create Note

`POST /notes`

Create a new note attached to a registry resource.

## Request body

- NoteCreateRequest — Payload for creating a new note.
  - `body` string, required
  - `confidence` 'observed' | 'suspected' | 'verified' — Author-supplied confidence in a note (matches the spec ``NoteConfidence`` enum).
  - `related_execution_id` string, nullable
  - `resource` NoteResource, required — Exactly-one-of resource identifier for a note (request side).
    - `api` NoteApiReference — Loose ``(vendor, name, version)`` identity tuple for a registered API.
      - `name` string, required
      - `vendor` string, required
      - `version` string, required
    - `credential_id` string, nullable
    - `execution_id` string, nullable
    - `operation_id` string, nullable
  - `source` 'agent' | 'human' | 'platform' — Origin tag for a note (matches the spec ``NoteSource`` enum).
  - `type` 'auth_quirk' | 'usage_hint' | 'execution_feedback' | 'correction' — Category of a note (matches the spec ``NoteType`` enum).

## Response `201`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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