Skip to main content

UploadGrantRequest

sizeBytesinteger<int64>required

Positive declared size; upper bound comes from the backend's existing image configuration. The stored original's actual bytes must be checked independently.

Possible values: >= 1

sha256stringrequired

Lowercase SHA-256 hex digest of the intended original; actual stored bytes must match.

Possible values: >= 64 characters and <= 64 characters, Value must match regular expression ^[0-9a-f]{64}$

filenamestring

Optional name of the user's file, kept only as the search's display name. The uploader always receives the bytes as original.jpg; replays of the same key keep the first value.

Possible values: <= 255 characters

titlestring

Optional plain-text search title, separate from the filename. The server trims whitespace; blank means no title. Same-key retries preserve the first title and retention policy without extending the upload deadline.

Possible values: <= 120 characters

UploadGrantRequest
{
"sizeBytes": 0,
"sha256": "string",
"filename": "string",
"title": "string"
}