v2

latestOpenAPI 3.1.02026-08-05313314398.1 KB
files

List User Files

List uploaded files in the company the caller can see.

Owners see everything; members see files they hold a (direct or folder-inherited) VIEWER grant on.

include_pending=true also returns uploads stuck in parse_state='pending' (never finalized through the wizard) so the files-management UI can show them with a "to finalize" badge. Defaults to committed-only so dataset pickers reusing this endpoint are unaffected. The accessibility filter applies to pending rows the same way.

get/api/v1/files/

Query parameters

include_pendingboolean

Response

Successful Response

idstring uuid required
company_idstring uuid required
user_idstring uuid required
folder_idstring uuid nullable
namestring required
file_typestring required
size_bytesinteger required
metaobject required
created_atstring date-time required
parse_statestring required