Frequently asked questions

Have a different question and can't find the answer you're looking for?
Ping me on Twitter. Or send an email here

Statebin.io is a stateful API that provides an interface for creating and managing atomic counters, locks, and buckets.

Some common use cases include tracking GitHub profile views, keeping a record of link clicks, managing build numbers in CI pipelines, storing user preferences, and maintaining coverage SVG files, among others.

Absolutely! Statebin.io is designed to be used programmatically and fits perfectly in CI/CD pipelines. You can track build numbers, store artifacts, and ensure that only one job runs at a time using locks.

You can create an atomic counter by simply making a PUT request to
/counter/countername
or
/counter/namespace/countername
To check the status of a lock or to release it, make a GET or DELETE request to the same path, respectively.

You can reset a counter by making a DELETE request to your counter e.g.
/counter/countername

You can create a lock by making a PUT request to
/lock/lockname
or
/lock/namespace/lockname
To check the status of a lock or to release it, make a GET or DELETE request to the same path, respectively.

The depth of a counter or lock path is limited to three levels. If an attempt is made to access a path with more depth, an error will be returned. Buckets have a maximum depth of 10 levels.

Each lock has a Time-To-Live (TTL) of 60 minutes. If it is not released within this period, it will be released automatically.

You can upload a file by making a PUT request to /bucket/namespace/path/to/file.ext
To retrieve or delete the file, make a GET or DELETE request to the same path.

The maximum file size is 100MB. If you need to upload larger files, please reach out.