Skip to main content
// Route summary

Developer docs
with signal

Use /api/c/:bin_name. Legacy routes are marked.

MethodRoutePurpose
ANY/api/c/:bin_namePreferred webhook capture endpoint
ANY/:bin_nameLegacy capture alias, deprecated
GET/api/:bin_name/latestLatest request
GET/api/:bin_name/updates?since=Incremental polling
GET/api/:bin_name/:request_idRequest detail
GET/api/legacy/:bin_nameNamespaced legacy metadata
GET/api/legacy/:bin_name/postNamespaced legacy latest
GET/api/legacy/:bin_name/post/jsonNamespaced legacy latest JSON
GET/t/:bin_nameLegacy metadata alias
GET/t/:bin_name/postLegacy latest alias
GET/t/:bin_name/post/jsonLegacy latest JSON alias
POST/api/binsCreate managed bin
GET/api/bins/:bin_nameRead bin metadata
DELETE/api/bins/:bin_nameDelete bin
POST/api/bins/:bin_name/tokensCreate private read token
DELETE/api/bins/:bin_name/tokens/:token_idRevoke private read token

Preferred flow

Capture + inspect

Capture, then read latest or updates.

Private read access

Token-gated reads

Private reads need x-bin-token.

Operational notes

Runtime behavior

Errors: 400, 401, 403, 404, 409, 413, 429.

OpenAPI

Generated reference

Browse generated documentation at /openapi and the JSON schema at /openapi/json.

Capture example

curl -X POST http://localhost:8787/api/c/demo   -H 'content-type: text/plain'   -d 'hello'

Private read example

curl http://localhost:8787/api/demo/latest   -H 'x-bin-token: <token>'