Skip to content

Commit e13d7da

Browse files
docs(specs): attachments stream with Content-Length
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011Q2tgjZEUrtvVk6k8SpdXJ
1 parent 2f77363 commit e13d7da

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎specs/behaviors/storage.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,7 @@ people/janedoe/avatar.jpg
182182
people/janedoe/avatar-128.jpg
183183
```
184184

185-
The on-record key (`avatarKey`) references the attachment path relative to the data repo root, `<sheet>/<record path>/<name>`. Web serves attachments via `GET /api/attachments/<key>`, which resolves the key through the sheet's current read snapshot. The response carries `ETag: "<blob hash>"` and `Cache-Control: public, max-age=3600`; a request whose `If-None-Match` matches gets `304` with no body. A key outside any sheet, or with no blob, is `404`; an empty blob is a `200` with an empty body.
185+
The on-record key (`avatarKey`) references the attachment path relative to the data repo root, `<sheet>/<record path>/<name>`. Web serves attachments via `GET /api/attachments/<key>`, which resolves the key through the sheet's current read snapshot. The response streams the blob with `Content-Length`, `ETag: "<blob hash>"` and `Cache-Control: public, max-age=3600`; a request whose `If-None-Match` matches gets `304` with no body. A key outside any sheet, or with no blob, is `404`; an empty blob is a `200` with an empty body.
186186

187187
## In-memory representation
188188

0 commit comments

Comments
 (0)