v52

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-08-03134119177.4 KB

internal

save lists of active commits for garbage collection

post/repositories/{repository}/gc/prepare_commits

Response

paths to commit dataset

run_idstring required

a unique identifier generated for this GC job

gc_commits_locationstring required

location of the resulting commits csv table (partitioned by run_id)

gc_addresses_locationstring required

location to use for expired addresses parquet table (partitioned by run_id)

gc_commits_presigned_urlstring

a presigned url to download the commits csv

Example response

{
  "run_id": "64eaa103-d726-4a33-bcb8-7c0b4abfe09e",
  "gc_commits_location": "s3://my-storage-namespace/_lakefs/retention/commits",
  "gc_addresses_location": "s3://my-storage-namespace/_lakefs/retention/addresses"
}