Add bulk delete endpoint for flow runs

[zzstoatzz]

summary

this PR adds a bulk delete endpoint for flow runs

key features

• filter-based deletion: uses the standard FlowRunFilter for maximum flexibility - delete by IDs, states, tags, or any criteria
• batch processing: processes flow runs efficiently with proper resource cleanup
• background log cleanup: schedules log deletion as background tasks to avoid blocking the response

api

• endpoint: POST /flow_runs/bulk_delete
• request body:
  • flow_runs: standard FlowRunFilter object (e.g., {"id": {"any_": [id1, id2]}})
  • limit: maximum number of flow runs to delete (1-200, default: 200)
• response: FlowRunBulkDeleteResponse with deleted flow run IDs

implementation details

processing logic

• reuses existing FlowRunFilter schema - the same filter used for querying flow runs
• processes flow runs one at a time with proper concurrency slot cleanup
• schedules log deletion as background tasks

🤖 Generated with Claude Code

[codspeed-hq]

CodSpeed Performance Report

Merging #19232 will not alter performance

_{Comparing backport/flow-run-bulk-delete (f98e75f) with main (9bae64b)}

Summary

✅ 2 untouched

[zzstoatzz]

Test Results ✅

Added comprehensive test coverage for the bulk delete endpoint:

Test Coverage

• test_bulk_delete_by_ids: Verifies deletion by specific flow run IDs (create 5, delete 3, verify 2 remain)
• test_bulk_delete_by_tags: Tests filtering by tags (create tagged/untagged runs, delete only tagged)
• test_bulk_delete_limit: Ensures the limit parameter is enforced (create 10, limit to 5, verify only 5 deleted)
• test_bulk_delete_validation: Tests parameter validation (limit too high/low returns 422)
• test_bulk_delete_with_concurrency_slots: Verifies concurrency slots are released on deletion

Manual Testing

Also created and ran sandbox/test_bulk_delete.py against a live Prefect server to verify end-to-end functionality.

All tests pass:

tests/server/orchestration/api/test_flow_runs.py::TestBulkDeleteFlowRuns::test_bulk_delete_by_ids PASSED
tests/server/orchestration/api/test_flow_runs.py::TestBulkDeleteFlowRuns::test_bulk_delete_by_tags PASSED
tests/server/orchestration/api/test_flow_runs.py::TestBulkDeleteFlowRuns::test_bulk_delete_limit PASSED
tests/server/orchestration/api/test_flow_runs.py::TestBulkDeleteFlowRuns::test_bulk_delete_validation PASSED
tests/server/orchestration/api/test_flow_runs.py::TestBulkDeleteFlowRuns::test_bulk_delete_with_concurrency_slots PASSED

[github-actions]

This pull request is stale because it has been open 14 days with no activity. To keep this pull request open remove stale label or comment.