Check file existence and get metadata headers | PrivateGPT

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.

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