Create Note

Create a new note with title, content, category, group, and color

POST /api/notes

Request Body

{
  "title": "Advanced CSS Techniques",
  "content": "Modern CSS techniques including Grid, Flexbox, and custom properties. These tools allow developers to create responsive and beautiful layouts with minimal code.",
  "category": "css",
  "group": "first",
  "color": "primary"
}

Success Response

{
  "id": 23,
  "title": "Advanced CSS Techniques",
  "content": "Modern CSS techniques including Grid, Flexbox, and custom properties. These tools allow developers to create responsive and beautiful layouts with minimal code.",
  "category": "css",
  "group": "first",
  "color": "primary",
  "archived": false,
  "createdAt": "2024-01-25T14:30:00Z",
  "updatedAt": "2024-01-25T14:30:00Z"
}

{
  "error": "Missing required fields: title, content"
}

{
  "error": "Invalid category. Must be one of: css, val-town, prompts, notes, chat-gpt, cursor-chats, bash-commands"
}

Create Note

Create a new note by providing the required fields. All fields are mandatory for creating a note.

Request Body

title · string · required

The title of the note

content · string · required

The main content/body of the note

category · string · required

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

group · string · required

Group classification. Valid values: first, second, third, fourth, fifth

color · string · required

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

Examples

cURL

curl -X POST "https://arfan-notes.val.run/api/notes" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Advanced CSS Techniques",
    "content": "Modern CSS techniques including Grid, Flexbox, and custom properties...",
    "category": "css",
    "group": "first",
    "color": "primary"
  }'

const newNote = {
  title: "Advanced CSS Techniques",
  content: "Modern CSS techniques including Grid, Flexbox, and custom properties...",
  category: "css",
  group: "first",
  color: "primary"
};

const response = await fetch('https://arfan-notes.val.run/api/notes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(newNote)
});

const createdNote = await response.json();
console.log(createdNote);

import requests
import json

new_note = {
    "title": "Advanced CSS Techniques",
    "content": "Modern CSS techniques including Grid, Flexbox, and custom properties...",
    "category": "css",
    "group": "first",
    "color": "primary"
}

response = requests.post(
    'https://arfan-notes.val.run/api/notes',
    headers={'Content-Type': 'application/json'},
    data=json.dumps(new_note)
)

created_note = response.json()
print(created_note)

Request Example

Request Body

{
  "title": "Advanced CSS Techniques",
  "content": "Modern CSS techniques including Grid, Flexbox, and custom properties. These tools allow developers to create responsive and beautiful layouts with minimal code.",
  "category": "css",
  "group": "first",
  "color": "primary"
}

Response

Success Response

{
  "id": 23,
  "title": "Advanced CSS Techniques",
  "content": "Modern CSS techniques including Grid, Flexbox, and custom properties. These tools allow developers to create responsive and beautiful layouts with minimal code.",
  "category": "css",
  "group": "first",
  "color": "primary",
  "archived": false,
  "createdAt": "2024-01-25T14:30:00Z",
  "updatedAt": "2024-01-25T14:30:00Z"
}

{
  "error": "Missing required fields: title, content"
}

{
  "error": "Invalid category. Must be one of: css, val-town, prompts, notes, chat-gpt, cursor-chats, bash-commands"
}

Validation Rules

• title: Must be a non-empty string
• content: Must be a non-empty string
• category: Must be one of the valid category values
• group: Must be one of the valid group values
• color: Must be one of the valid color values

Response Fields

The response includes all the provided fields plus:

• id: Auto-generated unique identifier
• archived: Defaults to false for new notes
• createdAt: Timestamp when the note was created
• updatedAt: Timestamp when the note was last updated (same as createdAt for new notes)