create-goal

To create measurable goals within a mission and project hierarchy, you define a target with a specific metric type and target value under a designated project. The system writes this data via the goals API to a SQLite-backed database, returning identifiers for UI display and progress tracking.

Goal tracking supports count, currency, percentage, and boolean metric types. You must define a target value and optional target metric for each goal, enabling the system to increment current values and mark goal achievement when specified thresholds are met.

API integrations link created goals into dashboard workflows by writing new goals to SQLite-backed tables via POST endpoints. The API then returns slugs and identifiers, allowing you to link these measurable outcomes into routines, heartbeats, or tickets.

Progress tracking works by incrementing the current value as completed goal tasks are logged. When the accumulated current value meets the defined target value threshold, the system automatically marks the goal as achieved for UI dashboard display.

You do not need a due date to define a target with metric types in the goals API. The due date is an optional parameter alongside the required target metric and target value, allowing flexible scheduling for measurable outcomes.

Goal creation requires collecting the correct identifiers because goals must be nested under the right project and mission within the hierarchy. Supplying valid identifiers ensures the API accurately writes targets to the SQLite-backed state and links them properly.