Upload a screenshot
Multipart upload from the desktop app. Rejected with 403 unless the caller has screenshotsEnabled, and 503 when R2 storage is not configured. file must be image/jpeg, image/png, or image/webp, at most 5 MB. capturedAt defaults to now; entryId must belong to the caller.
View as MarkdownAuthorization
bearer In: header
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/screenshots" \ -F file="string"{ "screenshot": { "id": "string", "entryId": "string", "contentType": "string", "sizeBytes": 0, "capturedAt": "2019-08-24T14:15:22Z", "url": "string" }}List screenshots
Screenshot records ordered captured_at descending, hard limit 500. from/to filter on captured_at. url is a presigned GET link valid ~10 minutes, or null when storage is not configured.
Delete a screenshot
Owner-scoped delete of the record plus a best-effort delete of the stored object. Users can always delete their own captures.