Get file metadata | PrivateGPT

Retrieve metadata for a specific file by its relative path ID, e.g. uploads/data.csv or outputs/result.png.

file_idstringRequired

scope_idstringRequired

Session / container identifier.

namespacestringOptionalDefaults to session

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

Successful Response

idstring

Relative path of the file within the session, e.g. ‘uploads/data.csv’ or ‘outputs/result.png’. Use this value as file_id in subsequent requests.

created_atdatetime

ISO-8601 timestamp when the file was created or last modified.

filenamestring

Filename derived from the path.

mime_typestring

MIME type detected from the file content.

size_bytesinteger

File size in bytes.

downloadableboolean

True for sandbox output files; False for uploaded input files.

scopeobject

Session scope this file belongs to.

type"file"OptionalDefaults to file

Object type discriminator, always 'file'.

etagstring or nullOptional

Content checksum (MD5 hex or S3 ETag). Present after stat; None if unavailable.

namespacestringOptionalDefaults to session

Namespace this file belongs to (e.g. ‘session’, ‘skills’, or a custom namespace).

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

503

Service Unavailable Error