List Retention Rules

List the retention rules for a local repository. Returns an empty array when no rules are configured.

Allowed Roles: Workspace Admin or System Admin • Authentication Required • Local repositories only

Notes: If retention rules are disabled on the server, this endpoint returns 403.

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

Path Parameters

workspace-refstringRequired

Workspace ID or name.

repository-refstringRequired

Repository ID or name.

Request

Command Line

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

Response

[
  {
    "id": "9b1d2f3a-8c4e-4f2a-9d10-4c1d6f2f3a8c",
    "repositoryId": "1910c2ac-62c9-4ffb-888a-84daec3aa3e1",
    "workspaceId": "0a8e6f52-3c44-4c9b-b0c5-9f2d7a1e6b3a",
    "name": "Keep recent versions",
    "description": "Keep the latest versions of each package",
    "targetType": "version",
    "ruleJson": {
      "conditions": {
        "and": [
          {
            "field": "creationDay",
            "operator": "OLDER_THAN_DAYS",
            "value": 30
          }
        ]
      },
      "keepRules": {
        "groupBy": "packageName",
        "sortBy": "creationDay",
        "order": "desc",
        "keep": 5
      }
    },
    "isEnabled": true,
    "cron": "0 0 * * *",
    "status": "ready",
    "lastRunDate": null,
    "createdAt": "2026-10-01T08:00:00.000Z",
    "updatedAt": "2026-10-01T08:00:00.000Z"
  }
]