{"openapi":"3.1.0","info":{"title":"LifeOS v1 API","version":"1.2.0","description":"User-scoped API for goals, logs, journal, field notes, reminders, capture categories, assistant commands, iOS widget bridge, and MCP tool endpoints."},"servers":[{"url":"https://www.mj-fuller.com"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/v1/profile":{"get":{"operationId":"getProfile","summary":"Get app profile settings (timezone/display only)","responses":{"200":{"description":"Profile"}}},"patch":{"operationId":"updateProfile","summary":"Update app profile settings","responses":{"200":{"description":"Profile updated"}}}},"/api/v1/goals":{"get":{"operationId":"listGoals","summary":"List user goals","responses":{"200":{"description":"Goals list"}}},"post":{"operationId":"createGoal","summary":"Create a goal","responses":{"200":{"description":"Goal created"}}}},"/api/v1/goals/{id}":{"patch":{"operationId":"updateGoal","summary":"Update a goal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Goal updated"}}},"delete":{"operationId":"deleteGoal","summary":"Delete a goal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Goal deleted"}}}},"/api/v1/goals/logs":{"get":{"operationId":"listGoalLogs","summary":"List goal logs","responses":{"200":{"description":"Logs list"}}},"post":{"operationId":"upsertGoalLog","summary":"Create/update a goal log","responses":{"200":{"description":"Goal log upserted"}}}},"/api/v1/goals/focus-map":{"get":{"operationId":"getGoalFocusMap","summary":"Get current or requested Focus Map with planned and actual pillar allocation","responses":{"200":{"description":"Focus Map"}}},"patch":{"operationId":"updateGoalFocusMapAllocations","summary":"Update focus point allocations for a cycle","responses":{"200":{"description":"Focus Map updated"}}}},"/api/v1/goals/focus-cycles":{"get":{"operationId":"listGoalFocusCycles","summary":"List goal focus cycles","responses":{"200":{"description":"Focus cycles"}}},"post":{"operationId":"createGoalFocusCycle","summary":"Create a goal focus cycle","responses":{"200":{"description":"Focus cycle created"}}}},"/api/v1/daily":{"get":{"operationId":"getDailySummary","summary":"Get daily summary","responses":{"200":{"description":"Daily summary"}}}},"/api/v1/mobile/workout":{"post":{"operationId":"logWorkout","summary":"Log workout into goals","responses":{"200":{"description":"Workout applied"}}}},"/api/v1/mobile/config":{"get":{"operationId":"getMobileConfig","summary":"Fetch public mobile bootstrap config for native app","responses":{"200":{"description":"Mobile config payload"}}}},"/api/v1/reminders":{"get":{"operationId":"listReminders","summary":"List reminders","responses":{"200":{"description":"Reminders list"}}},"post":{"operationId":"createReminder","summary":"Create reminder","responses":{"200":{"description":"Reminder created"}}}},"/api/v1/field-notes":{"get":{"operationId":"listFieldNotes","summary":"List field notes","responses":{"200":{"description":"Field notes list"}}},"post":{"operationId":"createFieldNote","summary":"Create field note","responses":{"200":{"description":"Field note created"}}}},"/api/v1/journal":{"get":{"operationId":"listJournalEntries","summary":"List journal entries","responses":{"200":{"description":"Journal entries list"}}},"post":{"operationId":"createJournalEntry","summary":"Create journal entry","responses":{"200":{"description":"Journal entry created"}}}},"/api/v1/capture":{"post":{"operationId":"captureQuickNote","summary":"Capture shorthand note and auto-apply when supported","responses":{"200":{"description":"Capture accepted"}}}},"/api/v1/capture/quick":{"post":{"operationId":"captureQuickStructured","summary":"Capture one text/voice blob and split into goals/todos/reminders","responses":{"200":{"description":"Structured capture accepted"}}}},"/api/v1/capture/categories":{"get":{"operationId":"listCaptureCategories","summary":"List capture categories","responses":{"200":{"description":"Capture categories"}}},"post":{"operationId":"createCaptureCategory","summary":"Create capture category","responses":{"200":{"description":"Capture category created"}}}},"/api/v1/capture/categories/{id}":{"patch":{"operationId":"updateCaptureCategory","summary":"Update capture category","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capture category updated"}}},"delete":{"operationId":"deleteCaptureCategory","summary":"Delete capture category","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capture category deleted"}}}},"/api/v1/assistant/content":{"get":{"operationId":"getAssistantContentV1","summary":"Fetch user content for AI context","responses":{"200":{"description":"Assistant content payload"}}}},"/api/v1/assistant/command":{"post":{"operationId":"runAssistantCommand","summary":"Run structured natural-language command (goal edits/create)","responses":{"200":{"description":"Assistant command result"}}}},"/api/v1/ai/keys":{"get":{"operationId":"listApiKeys","summary":"List personal API keys","responses":{"200":{"description":"Keys list"}}},"post":{"operationId":"createApiKey","summary":"Create personal API key","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["read","write","capture","assistant","workout"]}},"expiresInDays":{"type":"integer","minimum":1,"maximum":365},"keyType":{"type":"string","enum":["personal","integration","service"]}}}}}},"responses":{"200":{"description":"Key created"}}}},"/api/v1/ai/keys/{id}/rotate":{"post":{"operationId":"rotateApiKey","summary":"Rotate API key and revoke old key","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Key rotated"}}}},"/api/v1/widget/tokens":{"get":{"operationId":"listWidgetTokens","summary":"List widget bridge tokens","responses":{"200":{"description":"Widget token list"}}},"post":{"operationId":"createWidgetToken","summary":"Create widget bridge token","responses":{"200":{"description":"Widget token created"}}}},"/api/v1/widget/tokens/{id}":{"patch":{"operationId":"updateWidgetToken","summary":"Update widget token settings (config/timezone/name)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Widget token updated"}}},"delete":{"operationId":"revokeWidgetToken","summary":"Revoke widget token","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Widget token revoked"}}}},"/api/v1/widget/tokens/{id}/rotate":{"post":{"operationId":"rotateWidgetToken","summary":"Rotate widget token and revoke old token","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Widget token rotated"}}}},"/api/v1/widget/snapshot":{"get":{"operationId":"getWidgetSnapshot","summary":"Fetch lock-screen widget snapshot payload","responses":{"200":{"description":"Widget snapshot payload"}}}},"/api/v1/widget/bootstrap":{"post":{"operationId":"bootstrapWidgetToken","summary":"Create or rotate a primary widget token and return a usable secret","responses":{"200":{"description":"Widget bootstrap result"}}}},"/api/v1/widget/quick-log":{"post":{"operationId":"quickLogFromWidget","summary":"Write a same-day goal log using widget token auth","responses":{"200":{"description":"Widget quick log result"}}}},"/api/v1/mcp/manifest":{"get":{"operationId":"getMcpManifest","summary":"Get MCP bridge manifest","responses":{"200":{"description":"MCP manifest"}}}},"/api/v1/mcp/tools":{"get":{"operationId":"listMcpTools","summary":"List MCP-compatible tools","responses":{"200":{"description":"MCP tools list"}}}},"/api/v1/mcp/call":{"post":{"operationId":"callMcpTool","summary":"Call an MCP-compatible LifeOS tool","responses":{"200":{"description":"MCP tool response"}}}}}}