{"create_uid":"POST /","description":"Tagged, free-form data bag storage.","endpoints":{"create_record":{"body":{"info":"required. JSON object with any inner structure you need; the shape is described by `instruction`.","instruction":"required. Non-empty string explaining how to read the `info` object.","tags":"required. Non-empty array of non-empty strings. Max 50 tags, max 64 characters each, no '/', duplicates removed."},"description":"Store one tagged data bag. Every record has the same envelope; the free-form payload lives under `info` and is explained by `instruction`.","example":"curl -X POST https://daino.gestorm.com/ab3/record -H 'Content-Type: application/json' -d '{\"tags\":[\"book\",\"2026\"],\"instruction\":\"info holds a book: title, author, quotes[]\",\"info\":{\"title\":\"Dune\",\"author\":\"Frank Herbert\",\"quotes\":[\"Fear is the mind-killer.\"]}}'","method":"POST","notes":"Unknown top-level fields are rejected to keep every record formed.","path":"/{uid}/record","returns":"201 {ok, uid, record:{id,tags,instruction,info,created_at}}"},"create_user":{"description":"Create an anonymous owner identifier. The server generates a random 3-character uid from [0-9a-z] that is unique across all users.","example":"curl -X POST https://daino.gestorm.com/","method":"POST","params":"none (the request body may be empty)","path":"/","returns":"201 {ok, uid, home_url}"},"list_tags":{"description":"List every tag stored under this uid, with record counts.","example":"curl https://daino.gestorm.com/ab3/tags","method":"GET","params":"path parameter uid: exactly 3 characters from [0-9a-z]","path":"/{uid}/tags","returns":"200 {ok, uid, tags:[{tag,count}], total_tags}"},"records_by_tag":{"description":"Return every record that carries the given tag.","example":"curl https://daino.gestorm.com/ab3/tag/book","method":"GET","params":{"tag":"a tag stored under this uid; URL-encode spaces and special characters","uid":"exactly 3 characters from [0-9a-z]"},"path":"/{uid}/tag/{tag}","returns":"200 {ok, uid, tag, count, records:[record]}"},"user_home":{"description":"Overview of one uid: stats, all tags and the latest records.","example":"curl https://daino.gestorm.com/ab3","method":"GET","params":"path parameter uid: exactly 3 characters from [0-9a-z]","path":"/{uid}","returns":"200 {ok, uid, created_at, stats:{records,tags}, tags:[{tag,count}], recent:[record]}"}},"render_model":"Browser User-Agent -> HTML; other clients -> JSON. /s/ forces JSON, /u/ forces HTML, ?format=json|html overrides.","service":"TagBag"}
