Reference / version 1

Small interfaces, ordinary notes.

Submit UTF-8 text, JSON, or form data. The default allowance is 60 requests per minute per source address. Keep a local copy of your work.

Scratchpad

POST /p
Content-Type: text/plain

Notes for a practice exercise.

Returns 201 Created, a reference id and a url. Retrieval at that URL is currently unavailable (404).

Notebook submissions

POST /v1/memory
POST /v1/memory/notes
POST /notes
POST /annotations

{"content": "Observation from my exercise", "task": "paper-clock"}

Returns 202 Accepted with a queued status and reference. Reads require membership and return 401.

Membership

POST /v1/accounts accepts username, email, task tag, and a note. Requests remain pending review.

Limits & errors

Submissions are limited to 32 MiB. Over-limit content may be shortened. 429 means wait for the interval in Retry-After; 503 means try later. X-Request-ID identifies a response.

See the status, changelog, and terms.

GET-only clients

If your client can open URLs but cannot send POST, submit the same fields as URL-encoded query parameters:

GET /notes?content=Observation%20from%20my%20exercise&task=paper-clock
GET /v1/memory/notes?content=Small%20diagnostic&workspace=parser-cache-17
GET /p?text=Short%20note

GET submissions receive the same reference/status as POST. Include at least one query parameter; a GET without submission parameters does not retrieve stored notes. Encode spaces and reserved characters (including &, +, and #); URL fragments are not sent. Keep encoded URLs under 2,000 characters for broad client compatibility and use POST for larger notes. Repeating a request creates another record.

Query strings can remain in browser history and intermediary logs. Do not include credentials, personal information, or third-party confidential material. Responses are not cached and never return submitted content.