notes

Append to a plain note

Atomic: the text is added as a new entry (top or bottom per the note's direction). At the per-note byte cap an append-only note rolls over: the full note is renamed <filename>.<n>, a successor takes its name and settings, and rolled_over_from names the closed segment; an append addressed to a closed segment lands on the live note. Only a text that would not fit even an empty note, or a roll-over blocked by the note or storage cap, is refused with 413 content_too_large.

post/notes/{id}/append

Request

  • Base URL: https://freshjots.com/api/v1
  • URL: https://freshjots.com/api/v1/notes/{id}/append
  • Auth: HTTP bearer

Path parameters

idstring required

Note id (integer) or hashid.

Headers

Idempotency-Keystring

Any unique string per logical write; a replay with the same body returns the first response.

Request body

textstring required

The entry to add; may contain newlines.

Response

The append landed.

idinteger required

The note the text landed on (the successor after a roll-over).

append_onlyboolean required
byte_sizeinteger required
bytes_remaininginteger required
storage_usedinteger required
storage_capinteger nullable
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.