Head stream

Get stream metadata without reading its content.

bucketpathstringrequired

Bucket ID.

streampathstringrequired

Stream ID within the bucket.

If-None-Matchheaderstring

ETag for conditional request. Returns 304 if the stream state has not changed.

Response

Status	Meaning
`200`	Stream found.
`304`	Stream state unchanged (when `If-None-Match` matches).
`404`	Stream not found or expired.

Response headers include:

Header	Description
`Content-Type`	The stream's content type.
`Stream-Next-Offset`	The next writable offset (= current length).
`ETag`	Stream state ETag (encodes offset and open/closed state).
`Stream-Closed`	Present and `true` if the stream is closed.
`Stream-Snapshot-Offset`	Present if a snapshot exists, showing its offset.
`Stream-TTL`	Remaining TTL in seconds (if a TTL was set).
`Stream-Expires-At`	Expiration timestamp (if set).
`Cache-Control`	`no-store`.

curl -I http://127.0.0.1:4437/demo/hello

Use If-None-Match with a previously received ETag to efficiently poll for state changes without transferring data.