TagBag stores tagged data bags. Every record shares one envelope
(tags, instruction, info) while the
info object keeps whatever inner structure you need.
POST /{uid}/record
{
"tags": ["book", "2026"],
"instruction": "info holds a book: title, author, quotes[]",
"info": {
"title": "Dune",
"author": "Frank Herbert",
"quotes": ["Fear is the mind-killer."]
}
}
tags and instruction are required.
info must be a JSON object; its keys and nesting are free-form
and are explained by instruction. Unknown top-level fields are rejected.
Browsers receive HTML; API clients (curl, SDKs, bots) receive JSON, decided by the
User-Agent. Force a view with the /s/ (JSON) or
/u/ (HTML) path prefix, or with ?format=json|html.
Illegal requests always return the calling instructions.
/
Create an anonymous owner identifier. The server generates a random 3-character uid from [0-9a-z] that is unique across all users.
params none (the request body may be empty)
returns201 {ok, uid, home_url}
curl -X POST https://daino.gestorm.com/
/{uid}
Overview of one uid: stats, all tags and the latest records.
params path parameter uid: exactly 3 characters from [0-9a-z]
returns200 {ok, uid, created_at, stats:{records,tags}, tags:[{tag,count}], recent:[record]}
curl https://daino.gestorm.com/ab3
/{uid}/record
Store one tagged data bag. Every record has the same envelope; the free-form payload lives under `info` and is explained by `instruction`.
json body
tags — required. Non-empty array of non-empty strings. Max 50 tags, max 64 characters each, no '/', duplicates removed.instruction — required. Non-empty string explaining how to read the `info` object.info — required. JSON object with any inner structure you need; the shape is described by `instruction`.notesUnknown top-level fields are rejected to keep every record formed.
returns201 {ok, uid, record:{id,tags,instruction,info,created_at}}
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."]}}'
/{uid}/tags
List every tag stored under this uid, with record counts.
params path parameter uid: exactly 3 characters from [0-9a-z]
returns200 {ok, uid, tags:[{tag,count}], total_tags}
curl https://daino.gestorm.com/ab3/tags
/{uid}/tag/{tag}
Return every record that carries the given tag.
params
uid — exactly 3 characters from [0-9a-z]tag — a tag stored under this uid; URL-encode spaces and special charactersreturns200 {ok, uid, tag, count, records:[record]}
curl https://daino.gestorm.com/ab3/tag/book