The Files API lists and deletes files that have been uploaded to your team. Files are created by the Upload API and are referenced by process jobs. Deleting a file removes it from storage and cannot be undone.
Returns a paginated list of files belonging to your team.
Parameter Type Required Default Description pagenumber No 1 Page number (min: 1) limitnumber No 20 Items per page (min: 1, max: 100) sort_bystring No created_atSort field. Files support created_at sort_orderstring No descSort direction: asc or desc created_afterstring No — ISO 8601 date — files created on or after this date created_beforestring No — ISO 8601 date — files created on or before this date
curl -H "x-api-key: wk_xxxxxxxx.your_secret_here" \ "https://api.exelensia.com/v1/files?page=1&limit=20" { "data" : [ { "id" : "019760a0-0020-7000-8000-000000000020" , "filename" : "invoice_2024_01.pdf" , "bytes" : 245760 , "created_at" : "2024-01-16T09:00:00.000Z" , "updated_at" : "2024-01-16T09:00:15.000Z" }, { "id" : "019760a0-0021-7000-8000-000000000021" , "filename" : "contract_q1.docx" , "bytes" : 87040 , "created_at" : "2024-01-16T08:30:00.000Z" , "updated_at" : "2024-01-16T08:30:10.000Z" } ], "meta" : { "total" : 2 , "page" : 1 , "limit" : 20 , "totalPages" : 1 , "hasNextPage" : false , "hasPrevPage" : false } } Field Description idFile UUID filenameStored filename bytesFile size in bytes created_atWhen the file was uploaded updated_atWhen the file record was last updated
Status Description 200Success 401Missing or invalid authentication
Deletes a file by ID. This removes the file record and its stored content permanently. This action cannot be undone.
Warning: Deleting a file does not delete the process jobs or results derived from it. Existing results remain accessible.
Parameter Type Required Description idstring Yes File UUID
curl -X DELETE \ -H "x-api-key: wk_xxxxxxxx.your_secret_here" \ "https://api.exelensia.com/v1/files/019760a0-0020-7000-8000-000000000020" { "message" : "OK" } Status Description 200File deleted 401Missing or invalid authentication 404File not found
