List Repository Files

Browse files and folders stored under a repository. Authorization is optional unless the repository is private. File-level CVE summaries are returned only for remote repository cache files; local repository vulnerability scanning is reported per package version.

Authentication: Optional (required if repository is private)

GET https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/files

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

Query

pathstringOptional

Folder path to browse. Default: repository root.

searchstringOptional

Search text for file or folder paths.

offsetnumberOptional

Pagination offset. Default: 0.

limitnumberOptional

Maximum entries to return. Must be between 1 and 200. Default: 50.

Request

Command Line

curl -sS -X GET "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/files?path=dist&limit=50" \
  -H "Authorization: Bearer <optional-user-token>" \
  -H "Accept: application/json"

Response

{
  "entries": [
      {
          "kind": "folder",
          "name": "dist",
          "path": "dist",
          "itemCount": 12,
          "updatedAt": "2026-05-04T08:00:00.000Z"
      },
      {
          "kind": "file",
          "id": "4d0a13f1-cd2f-46c8-9747-82d3d7f0dd15",
          "name": "package.tgz",
          "path": "dist/package.tgz",
          "sizeInByte": 123456,
          "createdAt": "2026-05-04T07:30:00.000Z",
          "updatedAt": "2026-05-04T08:00:00.000Z",
          "packageId": null,
          "versionId": null,
          "cveSummary": {
              "isScanned": true,
              "scannedAt": "2026-05-04T09:00:00.000Z",
              "scanTool": "grype",
              "cveCount": 1,
              "criticalCveCount": 0,
              "highCveCount": 1,
              "mediumCveCount": 0,
              "lowCveCount": 0,
              "negligibleCveCount": 0,
              "unknownCveCount": 0
          }
      }
  ],
  "totalEntries": 2,
  "totalFiles": 1,
  "offset": 0,
  "limit": 50,
  "path": "dist",
  "search": ""
}