POST /api/articles/[id]/notes

Adds one typed note to the Brief. createdBy is inferred from the principal — a Bearer/CLI write is an agent; a web/session write is a human.

Endpoint

POST https://scripto.codika.io/api/articles/{id}/notes

Auth

Authorization: Bearer scripto_…

Request

Field	Type	Meaning
kind	string	Required. One of source, decision, idea, question.
title	string	Required, non-empty. The note’s short label.
body	string | null	Optional Markdown detail.
url	string | null	Optional link (mainly for sources).

{ "kind": "source", "title": "Medium import docs", "url": "https://help.medium.com/…" }

Response (201)

{
  "success": true,
  "data": {
    "note": { "anchor": "1a2b3c4d", "kind": "source", "title": "Medium import docs", "url": "https://…", "createdBy": "agent", "html": null },
    "notes": [ "… the fresh notes map …" ]
  }
}

Errors

HTTP	code	Cause	nextAction
400	invalid-argument	Unknown/missing kind.	Pass --kind with one of: source, decision, idea, question.
400	invalid-argument	Empty title, or wrong body/url type.	—
404	not-found	No such article, or you don’t own it.	—
401	unauthenticated	Missing or invalid key.	—

curl

curl -sS -X POST "https://scripto.codika.io/api/articles/$ID/notes" \
  -H "Authorization: Bearer $SCRIPTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"decision","title":"Lead with the install","body":"Every answer starts with scripto <cmd>."}'

Next

• PATCH …/notes/[nid] — edit a note.
• The Brief — note kinds and provenance.