This page walks you through sending your first dump and viewing it. It assumes a running app with the default server, HTTP on 127.0.0.1:21234.
Send your first dump
Send any JSON to the POST /dumps endpoint:
1curl -X POST http://127.0.0.1:21234/dumps \2 -H 'Content-Type: application/json' \3 -d '{"message":"Hello Dumpio","flag":"green","payload":{"answer":42}}'The server replies with 202 and the number of accepted dumps:
1{ "accepted": 1 }The dump appears at the top of the list immediately, marked with a green flag. When clicked, the detail renders {"answer":42} as an expandable tree.
What the reserved fields are
If your JSON value is an object, Dumpio reads a few reserved fields (the envelope) from it and treats the rest as your content:
| Field | Meaning |
|---|---|
message / title |
The title in the list |
flag |
The color flag (red, yellow, blue, gray, purple, pink, green) |
channel |
A channel for grouping, shown as #channel |
type |
Selects a specialized rendering (e.g. exception, query, html) |
Everything is optional. The smallest useful dump is {"message":"hi"}. For details, see the Dump format page.
Batch sending
Send a JSON array and each element becomes its own dump:
1curl -X POST http://127.0.0.1:21234/dumps \2 -H 'Content-Type: application/json' \3 -d '[{"message":"first"},{"message":"second"}]'Sending over TCP
If you have a TCP server configured, just write JSON directly to the socket:
1echo '{"message":"Hello Dumpio","flag":"green"}' | nc localhost 21234Where next
- Sending dumps – a complete description of the protocols and examples in Node.js, Python, and Go.
- Dump types – how Dumpio renders SQL, exceptions, models, HTML, and more.
- Viewer – filtering, search, and keyboard shortcuts.