Quickstart¶

This guide sends your first request to the Nimbus API: creating a bucket and uploading a record.

1. Create a bucket¶

nimbus buckets create my-first-bucket

2. Upload a record¶

curl -X POST https://api.nimbus.example.com/v1/buckets/my-first-bucket/records \
  -H "Authorization: Bearer $NIMBUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "hello-world", "value": 42}'

3. Read it back¶

curl https://api.nimbus.example.com/v1/buckets/my-first-bucket/records/hello-world \
  -H "Authorization: Bearer $NIMBUS_API_KEY"

Response

{
  "name": "hello-world",
  "value": 42,
  "created_at": "2026-06-18T12:00:00Z"
}

That's it

You've created a bucket and stored your first record. Next, learn how to authenticate requests properly or explore the full API reference.