---
title: "Create or update a note on an article"
method: POST
path: "/api/v1/articles/{id}/notes"
tags: ["Notes"]
---

# Create or update a note on an article

`POST /api/v1/articles/{id}/notes`

## Request

- Base URL: `https://feednest.com`
- URL: `https://feednest.com/api/v1/articles/{id}/notes`
- Auth: HTTP bearer

Creates the note on an article, or replaces the existing one. An article carries at most one note, so this is an upsert rather than an append. Requires the `write` scope.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `content` string, required

## Response `201`

Note created

- object
  - `data` NoteV1, required
    - `id` string, uuid, required
    - `article_id` string, uuid, required
    - `content` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `total_notes_count` integer, required

## Other responses

- `400`: Input validation failed
- `401`: Missing or invalid API key
- `403`: Insufficient permissions or subscription required
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/feednest/apis/feednest-public-api.md) · [All operations](https://skmtc.dev/feednest/apis/feednest-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feednest/apis/feednest-public-api/revisions/51c8242d8418?raw)