Tag anything.
Keep any shape.

TagBag stores tagged data bags. Every record shares one envelope (tags, instruction, info) while the info object keeps whatever inner structure you need.

View API spec (JSON)

Record shape

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.

Render model

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.

API

POST /

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/
GET /{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
POST /{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."]}}'
GET /{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
GET /{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 characters

returns200 {ok, uid, tag, count, records:[record]}

curl https://daino.gestorm.com/ab3/tag/book