Get Repository Metadata

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

Retrieve repository metadata, including type, status, and child repositories where applicable. Authorization is optional.

Authentication: Optional (required if repository is private)

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

Request

curl -sS -X GET "https://api.repoflow.io/1/workspaces/<workspace-ref>/repositories/<repository-ref>" \
  -H "Accept: application/json"

Response

{
  "id": "15f3c26d-fc44-4c6a-a2f7-1d27b04e799d",
  "name": "my-repo",
  "packageType": "npm",
  "repositoryType": "virtual",
  "status": "ACTIVE",
  "workspaceId": "0a8e6f52-3c44-4c9b-b0c5-9f2d7a1e6b3a",
  "uploadTargetLocalRepository": {
    "id": "7b2919b3-4ad4-4bd3-9bb4-d1a5efbd95cc",
    "name": "npm-local"
  },
  "childRepositories": [
    {
      "id": "7b2919b3-4ad4-4bd3-9bb4-d1a5efbd95cc",
      "name": "npm-local",
      "repositoryType": "local"
    },
    {
      "id": "a58c49e4-e1c4-468d-8c75-3fb08fdde4b2",
      "name": "npm-remote",
      "repositoryType": "remote"
    }
  ],
  "remoteRepositoryUrl": null,
  "isRemoteCacheEnabled": null,
  "fileCacheTimeTillRevalidation": null,
  "metadataCacheTimeTillRevalidation": null
}

childRepositories is returned only for virtual repositories, and uploadTargetLocalRepository is set only when a virtual repository has an upload target. Remote-only fields (remoteRepositoryUrl, isRemoteCacheEnabled, fileCacheTimeTillRevalidation, metadataCacheTimeTillRevalidation) are null for non-remote repositories.