Hippius Management API
The Hippius Management API is a REST API for managing your account, S3 tokens, and billing programmatically. Use it to automate token rotation, monitor your balance, or build integrations that provision storage on demand.
What It Does
The Management API handles everything outside of the S3 data plane:
| Area | What you can do |
|---|---|
| Token management | Create, list, rotate, and revoke master and sub tokens |
| Billing | Check your balance, list transactions and invoices, start a top up by card (Stripe), Bitcoin (BTCPay) or USDC (x402), read your TAO deposit address |
| Account | Manage account settings and access keys |
For storing and retrieving files, start with Getting Started and Advanced Usage. The Management API is the control plane: it manages who can access storage and how much they can use.
Interactive Docs
The full API specification with request/response examples is available as an interactive Swagger UI:
Use Cases
- CI/CD pipelines — Create short-lived sub tokens scoped to a single bucket for deployments, then revoke them automatically
- Multi-tenant apps — Provision a bucket and scoped token per customer from your backend
- Billing automation: monitor your balance and start a top up before running out
- AI agents & LLMs — Automate storage operations end-to-end without manual console interaction
A machine-readable index is at docs.hippius.com/llms.txt. It points at each product's own llms.txt. The long S3 ingest is docs.hippius.com/llms-full.txt.
Authentication
All Management API requests require an access token. Generate one in the Hippius Console under Settings.
Related
- S3 Quickstart: first upload
- Advanced Usage — Presigned URLs, ACLs, public buckets, sub-tokens
- S3 Compatibility Matrix — Supported S3 operations