Project Baselines API

Create point-in-time snapshots of project state and compare against current progress to identify deviations.

List Baselines

GET /api/workspaces/{slug}/projects/{projectId}/baselines/

Create Baseline

Takes a snapshot of the current project state (issue counts by state and priority).

POST /api/workspaces/{slug}/projects/{projectId}/baselines/

Request Body:

{
  "name": "Sprint 12 Start"
}

Response:

{
  "id": "baseline_id",
  "project_id": "project_id",
  "name": "Sprint 12 Start",
  "total_issues": 45,
  "completed_issues": 12,
  "state_breakdown": {
    "backlog": 10,
    "unstarted": 8,
    "started": 15,
    "completed": 12
  },
  "priority_breakdown": {
    "urgent": 3,
    "high": 12,
    "medium": 20,
    "low": 10
  },
  "snapshot_at": "2026-04-08T12:00:00Z"
}

Get Deviation

Compares a baseline snapshot against the current project state.

GET /api/workspaces/{slug}/baselines/{baselineId}/deviation/

Response:

{
  "baseline": { ... },
  "current_total": 52,
  "current_completed": 18,
  "issues_delta": 7,
  "completion_delta": 6,
  "state_delta": {
    "backlog": 3,
    "started": -2,
    "completed": 6
  }
}

Positive deltas mean increase since baseline, negative mean decrease.

Delete Baseline

DELETE /api/workspaces/{slug}/baselines/{baselineId}/