Sign in
Files

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.

head/v1/files/{file_id}

Path parameters

file_idstring required

Query parameters

scope_idstring required

Session / container identifier.

Example:session-abc123

Session / container identifier.

namespacestring

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

Example:session

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

Response

File exists; metadata in response headers.

{"stackTrail":"paths:/v1/files/{file_id}:head:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

Changed in 1 of the 11 revisions of this API.1