Strategic Horizons (3-Tier) API
The 3-Tier Horizon API connects visionary Long-Term goals (6M) to Mid-Term milestones (3M) and Short-Term deliverables (1M), aggregating automatic completion percentages from linked tasks.
Base Path: /api/v1/horizons
Get Nested Horizon TreeAuth
Fetch the full recursive 3-Tier Horizon tree with automatic progress percentage rollups.
Status Codes
- Name
200- Type
- HTTP
- Description
- Horizon tree returned successfully.
- Name
401- Type
- HTTP
- Description
- Unauthorized.
Request
GET/api/v1/horizons/tree
Response 200
List Horizons (Multi-Value Filter)Auth
List horizons with multi-value type filtering (e.g. types=long_term,mid_term), status filters, search query, and sorting.
Status Codes
- Name
200- Type
- HTTP
- Description
- Filtered list of horizons.
Request
GET/api/v1/horizons
Response 200
Create Strategic HorizonAuth
Create a new strategic horizon goal within the active organization workspace.
Payload Example
{
"type": "mid_term",
"title": "Sub-Second WebRTC Edge Mesh",
"description": "Deploy distributed SFU edge nodes across 4 Australian regions.",
"parent_goal_id": "hor_01j9a87f6e",
"target_date": "2026-09-30"
}Status Codes
- Name
201- Type
- HTTP
- Description
- Horizon created.
- Name
400- Type
- HTTP
- Description
- Validation error.
- Name
type- Type
- string
- Required
- Description
- Horizon tier:
long_term(6M),mid_term(3M), orshort_term(1M).
- Name
title- Type
- string
- Required
- Description
- Goal title or milestone description.
- Name
parent_goal_id- Type
- string
- Description
- Parent horizon ID for recursive decomposition.
- Name
target_date- Type
- string
- Required
- Description
- Target date (YYYY-MM-DD format).
Request
POST/api/v1/horizons
Response 201