---
title: "POST /v1/intake/workflow-sprint/advance"
method: POST
path: "/v1/intake/workflow-sprint/advance"
---

# POST /v1/intake/workflow-sprint/advance

`POST /v1/intake/workflow-sprint/advance`

## Request

- Base URL: `https://thumbgate.ai`
- URL: `https://thumbgate.ai/v1/intake/workflow-sprint/advance`
- Auth: HTTP bearer

## Request body

- WorkflowSprintAdvanceRequest
  - `leadId` string, required
  - `status` 'new' | 'qualified' | 'named_pilot' | 'proof_backed_run' | 'paid_team', required
  - `actor` string
  - `note` string
  - `reviewedBy` string
  - `workflowId` string
  - `teamId` string
  - `proofArtifacts` string[]
  - `qualificationReview` object: Required evidence-based buyer qualification review when advancing to qualified.
    - `severityAndFrequency` string, required
    - `measurableImpact` string, required
    - `urgencyAndTrigger` string, required
    - `decisionAuthority` string, required
    - `budgetMechanism` string, required
    - `offerFit` string, required
    - `proofRequired` string, required
    - `nextStep` string, required
    - `evidenceReferences` string[], required
    - `zeroSpendStatus` 'proceed_zero_cost', required
    - `priceUnderstandingConfirmed` boolean
    - `workflowCount` integer
    - `authorityConfirmed` boolean
    - `urgencyDays` integer
    - `budgetCents` integer
    - `readyToImplement` boolean
    - `proofBackedSprint` boolean
    - `completedEnterprisePilot` boolean
    - `requiresUnavailableHostedFeature` boolean

## Response `200`

Workflow Hardening Sprint lead advanced to the next state

- WorkflowSprintAdvanceResponse
  - `ok` boolean
  - `unchanged` boolean
  - `lead` object
  - `workflowRun` object, nullable

## Other responses

- `400`: Invalid sprint advancement request
- `403`: Forbidden

---

[API](https://skmtc.dev/thumbgate/apis/thumbgate-api.md) · [All operations](https://skmtc.dev/thumbgate/apis/thumbgate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thumbgate/apis/thumbgate-api/revisions/7f57f2edcd23?raw)