Update Note

Update an existing note by ID

PUT https://arfan-notes.val.run/api/notes/:id

Update Request Body

{
  "id": 23,
  "title": "Advanced CSS and Flexbox Techniques",
  "content": "Comprehensive guide to modern CSS layout techniques including Grid, Flexbox, and responsive design patterns.",
  "color": "success"
}

Success Response

{
  "id": 23,
  "title": "Advanced CSS and Flexbox Techniques",
  "content": "Comprehensive guide to modern CSS layout techniques including Grid, Flexbox, and responsive design patterns.",
  "category": "css",
  "group": "first",
  "color": "success",
  "archived": false,
  "createdAt": "2024-01-25T14:30:00Z",
  "updatedAt": "2024-01-25T16:45:00Z"
}

Update Note

Update an existing note by providing its ID and the fields you want to modify. All fields except ID are optional.

Path Parameters

id · integer · required

The unique identifier of the note to update

Request Body

id · integer · required

The ID of the note (must match the path parameter)

title · string

The new title of the note

content · string

The new content/body of the note

category · string

New category classification. Valid values: css, val-town, prompts, notes, chat-gpt, cursor-chats, bash-commands

group · string

New group classification. Valid values: first, second, third, fourth, fifth

color · string

New visual color coding. Valid values: primary, secondary, accent, neutral, info, success, warning, error

Examples

Update Title Only

curl -X PUT "https://arfan-notes.val.run/api/notes/23" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 23,
    "title": "Updated CSS Techniques"
  }'

Request Example

Update Request Body

{
  "id": 23,
  "title": "Advanced CSS and Flexbox Techniques",
  "content": "Comprehensive guide to modern CSS layout techniques including Grid, Flexbox, and responsive design patterns.",
  "color": "success"
}

Response

Success Response

{
  "id": 23,
  "title": "Advanced CSS and Flexbox Techniques",
  "content": "Comprehensive guide to modern CSS layout techniques including Grid, Flexbox, and responsive design patterns.",
  "category": "css",
  "group": "first",
  "color": "success",
  "archived": false,
  "createdAt": "2024-01-25T14:30:00Z",
  "updatedAt": "2024-01-25T16:45:00Z"
}

Important Notes

• The id field in the request body must match the id in the URL path
• Only provided fields will be updated; other fields remain unchanged
• The updatedAt timestamp will be automatically updated
• The archived status cannot be changed through this endpoint (use archive/unarchive endpoints)

Validation Rules

• id: Must be a valid integer and match an existing note
• title: If provided, must be a non-empty string
• content: If provided, must be a non-empty string
• category: If provided, must be one of the valid category values
• group: If provided, must be one of the valid group values
• color: If provided, must be one of the valid color values