Skip to main content

​
Agent files list

List generated files available to the authenticated user. Use this endpoint to show generated-file history for the authenticated user.

​
Endpoint

GET /external/agent-files/list

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20.

​
Response body

​
Top-level fields

FieldTypeNotes
itemsobject[]Generated files visible to the authenticated user.
totalintegerTotal files that match the current filter.
pageintegerCurrent page number.
pageSizeintegerPage size used for this response.
totalPagesinteger0 when total is 0.
hasMorebooleantrue when another page exists.

​
items[] fields

FieldTypeNotes
idstringFile record identifier.
fileNamestringOriginal file name.
fileSizeinteger or nullUploaded file size in bytes when known.
mimeTypestringMIME type for the file.
statusstringFile upload status.
createdAtstringMillisecond timestamp serialized as a string.

​
Response example

{
  "items": [
    {
      "id": "1024",
      "fileName": "report.csv",
      "fileSize": 10240,
      "mimeType": "text/csv",
      "status": "uploaded",
      "createdAt": "1776743105123"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "hasMore": false
}

​
Error responses

  • 401 Unauthorized

​
Notes

  • Results are ordered newest first.