Generate sprint planning suggestions

Generates citation-gated planning intents for review. This is proposal-only: it does not write to sprint membership, milestones, capacity, dependencies, or work items.

POST/api/v1/projects/:projectId/sprint-planning/suggestions

Authorization

sprints:readapi key scoperequired

Required scope when calling with an API key.

Path parameters

projectIdstringrequired

Project ID in the resolved workspace

Example: proj_abc123

Request body

confirmbooleanrequired

Must be true to acknowledge suggestion generation.

Example request

{
  "confirm": true
}

Request

POST /api/v1/projects/:projectId/sprint-planning/suggestions

curl -X POST "https://www.digitalstack360.com/api/v1/projects/proj_abc123/sprint-planning/suggestions" \
  -H "Authorization: Bearer $DS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirm":true}'

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "action_kind": "suggest_next_planning_moves",
    "intents": [],
    "observations": [
      "Planning Readiness: 70% (nearly)."
    ],
    "readiness": {
      "score": 70,
      "verdict": "nearly",
      "computed_at": "2026-07-15T14:22:04Z"
    },
    "computed_at": "2026-07-15T14:22:04Z"
  },
  "meta": {
    "webhook_event_type": "sprint_planning.suggestions_generated",
    "authority": "proposal_only_no_substrate_writes"
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks sprints:read scope

400

confirmation_required

confirm must be true

404

project_not_found

Project does not exist in the resolved workspace