Execution Endpoints

The execution family manages Execution Seasons and cycles, weekly commitments with proof standards, evidence, weekly reviews, and the execution calendar. See the Execution Seasons guide for the product model.

All execution endpoints require an Authorization: Bearer $TOKEN header and return the standard 401 envelope without one.

List Cycles

Retrieve execution cycles for a specific entity.

curl -H "Authorization: Bearer $TOKEN" \
"https://api.sureshake.com/v2/execution/8f2349ef.../cycles"

{
"data": [
  {
    "id": "8f2349ef...",
    "entityId": "8f2349ef...",
    "label": "Founding Season",
    "status": "active",
    "startDate": "2026-01-05T00:00:00Z",
    "endDate": "2026-03-01T23:59:59Z",
    "createdAt": "2026-01-02T10:00:00Z"
  }
],
"meta": {
  "total": 1,
  "limit": 100,
  "offset": 0,
  "hasMore": false
}
}

Baseline

Every company records a pre-season baseline on its entity — a marketplace listing is not required. Fields carry evidence, locking makes the baseline immutable (a hash-sealed snapshot), and corrections preserve the original entries. Season activation requires the latest locked baseline.

The older /v2/startups/{id}/baseline paths remain as deprecated aliases with identical behavior.

Create an Execution Season

Season creation is a discriminated contract on durationMode — eight_week_template or custom (custom supplies its own endDate). Every season names its primary outcome, links a locked baseline, and picks a cadence (weekly, biweekly, or monthly) and a visibility tier (public, follower, capital, diligence, or custom).

curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "durationMode": "eight_week_template",
  "entityId": "8f2349ef...",
  "label": "Founding Season",
  "startDate": "2026-01-05T00:00:00.000Z",
  "primaryOutcome": "Reach 20 paying design partners",
  "baselineId": "1c9a77b2...",
  "ownerUserId": "did:privy:...",
  "cadence": "weekly",
  "visibility": "follower"
}' \
"https://api.sureshake.com/v2/execution/cycles"

Season structure and lifecycle

Weekly commitments

Commitments are versioned; edits after the week starts are guarded and preserved. Quality warnings and AI rewrite proposals return pending drafts that require explicit acceptance.

Evidence and attestations

Missing evidence is an explicit state — never silent completion.

Weekly reviews and the record

Calendar

Calendar reads are explicit: view (today, week, month, or season), timeZone, and — for today/week/month — an anchorDate are required, never defaulted server-side.

curl -H "Authorization: Bearer $TOKEN" \
"https://api.sureshake.com/v2/execution/cycles/{cycleId}/calendar?view=week&timeZone=America/New_York&anchorDate=2026-01-05"

Goals

Cycle-scoped and standalone goals from the Verified Execution Record remain available: