Ursulav0.1.4

Create bucket

bucketpathstringrequired

Bucket ID. The Durable Streams Protocol specifies [a-z0-9_-]{4,64}. Client-side conformance is recommended even though Ursula does not currently enforce the regex.

Response

StatusMeaning
201Bucket created (idempotent - Ursula returns 201 whether or not the bucket existed before).

In the current Ursula implementation PUT /{bucket} is a no-op acknowledgement and always returns 201. Bucket existence is implicit. Streams created under any bucket name will succeed. Validation of the bucket ID (400) and conflict detection (409) are part of the Durable Streams Protocol but are not yet wired up here.

curl -X PUT http://127.0.0.1:4437/demo