Skip to navigation

Check file existence and get metadata headers

Lightweight existence check and metadata retrieval. Returns the same metadata as GET /{file_id} but as HTTP response headers and with no body — useful for existence checks and ETag-based conditional requests without transferring file content. Mirrors S3 HeadObject semantics. Headers returned: X-File-Id, X-File-Mime-Type, X-File-Size, X-File-Etag, X-File-Namespace, X-File-Filename, X-File-Created-At.

Path parameters

file_idstringRequired

Query parameters

scope_idstringRequired

Session / container identifier.

namespacestringOptionalDefaults to session
Namespace the file belongs to. Defaults to 'session'.

Response

File exists; metadata in response headers.

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error