Acme Notes API

All requests go to https://api.notes.test/v2. Authenticate with the X-Notes-Key header.

List notes

GET /notes returns notes, newest first, 50 per page. Pass the next_page value from the response as page_token to get the next page.

ParameterTypeDescription
page_tokenstringCursor from a previous response
tagstringOnly notes with this tag
{
  "notes": [{"id": "n_1", "text": "Buy milk", "tags": ["home"]}],
  "next_page": "abc123"
}

Get a note

GET /notes/:note_id returns a single note.

Create a note

POST /notes with a JSON body:

{"text": "Buy milk", "tags": ["home"]}

text is required.

Delete a note

DELETE /notes/:note_id deletes it permanently.

Webhooks