Get Repository File Details

Read file metadata. Remote repository cache files also include latest per-file vulnerability results. Local repository vulnerability scanning is reported per package version, so local file details do not include cveSummary or vulnerabilities.

Authentication: Optional (required if repository is private)

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

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

file-idstringRequired

Repository file ID (UUID).

Request

Command Line

curl -sS -X GET "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>/files/<file-id>" \
  -H "Authorization: Bearer <optional-user-token>" \
  -H "Accept: application/json"

Response

{
  "id": "4d0a13f1-cd2f-46c8-9747-82d3d7f0dd15",
  "name": "package.json",
  "path": "package.json",
  "sizeInByte": 2048,
  "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
  },
  "vulnerabilities": [
      {
          "id": "798ec7d4-8934-4fbb-b2c4-50f51a7fc25f",
          "cveId": "CVE-2026-0001",
          "severity": "HIGH",
          "description": "Example vulnerability description",
          "url": "https://example.com/CVE-2026-0001",
          "packageName": "openssl",
          "packageVersion": "3.0.0",
          "fileName": "package.json"
      }
  ]
}