{"openapi":"3.0.3","info":{"title":"Peak OS API","version":"1.0.0","description":"REST API for building integrations with Peak OS — objectives, key results, initiatives, metrics, todos, triage, vision/plan items, meetings, and organization data.\n\n**Authentication**: create an API key in Peak OS under *Profile Settings → API Keys* (personal) or *Organization Management → API Keys* (org-wide, admin only), then send it as `Authorization: Bearer pk_...`.\n\n**Scopes**: keys are created read-only by default; request write scope at creation to use POST/PATCH/DELETE endpoints.\n\n**Tenancy**: every key is bound to one organization; the API only returns that organization's data, filtered to the teams the key's owner can access.\n\n**Rate limit**: 100 requests/minute per key. Watch the `X-RateLimit-Remaining` header and back off on 429."},"servers":[{"url":"https://peakos.collective-genius.com/api/v1"}],"tags":[{"name":"System"},{"name":"Organization"},{"name":"Teams"},{"name":"Members"},{"name":"Objectives"},{"name":"Key Results"},{"name":"Initiatives"},{"name":"Metrics"},{"name":"Triage"},{"name":"Todos"},{"name":"Vision & Plan"},{"name":"Meetings"}],"paths":{"/ping":{"get":{"tags":["System"],"summary":"Health check / verify your key","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/me":{"get":{"tags":["System"],"summary":"Current key's user, organization binding, and permissions","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Key context","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/organization":{"get":{"tags":["Organization"],"summary":"The organization this key is bound to","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Organization","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Organization"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/foundations":{"get":{"tags":["Organization"],"summary":"Mission, vision, BHAG, and core values","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Foundations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Foundations"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/members":{"get":{"tags":["Members"],"summary":"Organization members","security":[{"bearerAuth":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["active","archived","all"],"default":"active"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Members","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Member"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/teams":{"get":{"tags":["Teams"],"summary":"List teams","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Team"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/teams/{id}":{"get":{"tags":["Teams"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Team"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/objectives":{"get":{"tags":["Objectives"],"summary":"List objectives","security":[{"bearerAuth":[]}],"parameters":[{"name":"teamId","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"type","in":"query","schema":{"type":"string","enum":["three-year","annual","six-months","quarterly"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["Off","On","Done","Push"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Objective"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Objectives"],"summary":"Create a objective","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectiveCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Objective"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/objectives/{id}":{"get":{"tags":["Objectives"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Objective"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Objectives"],"summary":"Update","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectiveUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Objective"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"tags":["Objectives"],"summary":"Delete","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}}},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/objectives/{objectiveId}/key-results":{"get":{"tags":["Key Results"],"summary":"Key results for an objective","security":[{"bearerAuth":[]}],"parameters":[{"name":"objectiveId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Key results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/KeyResult"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/key-results":{"post":{"tags":["Key Results"],"summary":"Create a key result","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyResultCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/KeyResult"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/key-results/{id}":{"get":{"tags":["Key Results"],"summary":"Get a key result","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"Key result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/KeyResult"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Key Results"],"summary":"Update a key result","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyResultUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/KeyResult"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/key-results/{keyResultId}/initiatives":{"get":{"tags":["Initiatives"],"summary":"Initiatives for a key result","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyResultId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Initiatives","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Initiative"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/key-results/{keyResultId}/updates":{"get":{"tags":["Key Results"],"summary":"Update feed for a key result","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyResultId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Updates","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UpdateEntry"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/initiatives":{"post":{"tags":["Initiatives"],"summary":"Create an initiative","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiativeCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Initiative"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/initiatives/{id}":{"get":{"tags":["Initiatives"],"summary":"Get an initiative","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"Initiative","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Initiative"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Initiatives"],"summary":"Update an initiative","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiativeUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Initiative"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/initiatives/{initiativeId}/updates":{"get":{"tags":["Initiatives"],"summary":"Update feed for an initiative","security":[{"bearerAuth":[]}],"parameters":[{"name":"initiativeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Updates","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UpdateEntry"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metrics":{"get":{"tags":["Metrics"],"summary":"List metrics","security":[{"bearerAuth":[]}],"parameters":[{"name":"teamId","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Metric"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Metrics"],"summary":"Create a metric","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Metric"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metrics/{id}":{"get":{"tags":["Metrics"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Metric"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Metrics"],"summary":"Update","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Metric"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metrics/{metricId}/period-values":{"get":{"tags":["Metrics"],"summary":"Period values (planned/projected/actual) for a metric","security":[{"bearerAuth":[]}],"parameters":[{"name":"metricId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"},{"name":"periodType","in":"query","schema":{"type":"string","enum":["quarterly","monthly","weekly","yearly"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Period values","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MetricPeriodValue"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metric-period-values":{"post":{"tags":["Metrics"],"summary":"Create/upsert a metric period value","description":"Requires a key with write scope. Upserts on (metricId, periodType, periodLabel).","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricPeriodValueCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MetricPeriodValue"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metric-period-values/{id}":{"patch":{"tags":["Metrics"],"summary":"Update a metric period value","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"planned":{"type":["string","number","null"]},"projected":{"type":["string","number","null"]},"actual":{"type":["string","number","null"]}}}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MetricPeriodValue"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/triage-items":{"get":{"tags":["Triage"],"summary":"List triage items","security":[{"bearerAuth":[]}],"parameters":[{"name":"teamId","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","schema":{"type":"string","enum":["in-progress","completed","deferred"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TriageItem"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Triage"],"summary":"Create a triage item","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriageItemCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TriageItem"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/triage-items/{id}":{"get":{"tags":["Triage"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TriageItem"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Triage"],"summary":"Update","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriageItemUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TriageItem"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/todo-items":{"get":{"tags":["Todos"],"summary":"List todo items","security":[{"bearerAuth":[]}],"parameters":[{"name":"teamId","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","schema":{"type":"string","enum":["in-progress","complete","blocked"]}},{"name":"ownerId","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TodoItem"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Todos"],"summary":"Create a todo item","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoItemCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TodoItem"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/todo-items/{id}":{"get":{"tags":["Todos"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TodoItem"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Todos"],"summary":"Update","description":"Requires a key with write scope.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoItemUpdate"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TodoItem"},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/todo-items/bulk":{"post":{"tags":["Todos"],"summary":"Bulk create (max 200 items)","description":"Requires a key with write scope. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TodoItemCreate"},"maxItems":200}},"required":["items"]}}}},"responses":{"201":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Todos"],"summary":"Bulk update (max 200 items)","description":"Requires a key with write scope. Each item needs an id. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","maxItems":200,"items":{"allOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},{"$ref":"#/components/schemas/TodoItemUpdate"}]}}},"required":["items"]}}}},"responses":{"200":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/triage-items/bulk":{"post":{"tags":["Triage"],"summary":"Bulk create (max 200 items)","description":"Requires a key with write scope. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TriageItemCreate"},"maxItems":200}},"required":["items"]}}}},"responses":{"201":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Triage"],"summary":"Bulk update (max 200 items)","description":"Requires a key with write scope. Each item needs an id. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","maxItems":200,"items":{"allOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},{"$ref":"#/components/schemas/TriageItemUpdate"}]}}},"required":["items"]}}}},"responses":{"200":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metrics/bulk":{"post":{"tags":["Metrics"],"summary":"Bulk create (max 200 items)","description":"Requires a key with write scope. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MetricCreate"},"maxItems":200}},"required":["items"]}}}},"responses":{"201":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Metrics"],"summary":"Bulk update (max 200 items)","description":"Requires a key with write scope. Each item needs an id. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","maxItems":200,"items":{"allOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},{"$ref":"#/components/schemas/MetricUpdate"}]}}},"required":["items"]}}}},"responses":{"200":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/metric-period-values/bulk":{"post":{"tags":["Metrics"],"summary":"Bulk create (max 200 items)","description":"Requires a key with write scope. Returns 207 on partial success.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MetricPeriodValueCreate"},"maxItems":200}},"required":["items"]}}}},"responses":{"201":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"207":{"description":"Bulk result (207 when partially successful)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object"}},"summary":{"type":"object","properties":{"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"}}}}},"requestId":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/ValidationError"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/three-year-vision":{"get":{"tags":["Vision & Plan"],"summary":"List three year vision","security":[{"bearerAuth":[]}],"parameters":[{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VisionItem"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/three-year-vision/{id}":{"get":{"tags":["Vision & Plan"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/VisionItem"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/one-year-plan":{"get":{"tags":["Vision & Plan"],"summary":"List one year plan","security":[{"bearerAuth":[]}],"parameters":[{"name":"year","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PlanItem"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/one-year-plan/{id}":{"get":{"tags":["Vision & Plan"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PlanItem"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/meetings":{"get":{"tags":["Meetings"],"summary":"List meetings","security":[{"bearerAuth":[]}],"parameters":[{"name":"teamId","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"type","in":"query","schema":{"type":"string","enum":["launch","quarterly","semi_annual","weekly_camp","annual","all_hands","board","one_on_one"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["scheduled","active","completed"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Page size"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Cursor from the previous page's pagination.nextCursor"},{"name":"sort_by","in":"query","schema":{"type":"string"},"description":"Field to sort by"},{"name":"sort_order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Paginated list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Meeting"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/meetings/{id}":{"get":{"tags":["Meetings"],"summary":"Get one","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Resource UUID"}],"responses":{"200":{"description":"The resource","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Meeting"},"requestId":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Peak OS API key (pk_...)"}},"responses":{"Unauthorized":{"description":"Missing, invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Key lacks scope or team/org permission for this action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Resource not found in this organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit exceeded (100 req/min per key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ValidationError":{"description":"Request body failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"requestId":{"type":"string"}}},"Pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"},"pageSize":{"type":"integer"}}},"Organization":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"fiscalYearStart":{"type":"string"},"planningCadence":{"type":"string"},"archived":{"type":"boolean"},"onboardingCompleted":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"Foundations":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"mission":{"type":["string","null"]},"vision":{"type":["string","null"]},"bhag":{"type":["string","null"]},"coreItems":{"type":["array","null"],"items":{"type":"object"}},"selectedCoreType":{"type":["string","null"],"enum":["value","behavior","principle",null]}}},"Member":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"licenseType":{"type":"string","enum":["full","view_only"]},"status":{"type":"string","enum":["active","archived"]},"email":{"type":"string"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"title":{"type":["string","null"]},"department":{"type":["string","null"]}}},"Team":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"parentTeamId":{"type":["string","null"],"format":"uuid"},"displayOrder":{"type":["integer","null"]}}},"Objective":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"title":{"type":"string"},"description":{"type":["string","null"]},"type":{"type":"string","enum":["three-year","annual","six-months","quarterly"]},"status":{"type":"string","enum":["Off","On","Done","Push"]},"progress":{"type":"integer","minimum":0,"maximum":100},"startDate":{"type":"string","format":"date-time"},"dueDate":{"type":"string","format":"date-time"},"ownerId":{"type":["string","null"]},"year":{"type":["string","null"]},"quarter":{"type":["integer","null"]},"half":{"type":["integer","null"]}}},"ObjectiveCreate":{"type":"object","required":["title","type","startDate","dueDate"],"properties":{"teamId":{"type":"string","format":"uuid"},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"type":{"type":"string","enum":["three-year","annual","six-months","quarterly"]},"status":{"type":"string","enum":["Off","On","Done","Push"],"default":"On"},"progress":{"type":"integer","minimum":0,"maximum":100,"default":0},"startDate":{"type":"string","format":"date-time"},"dueDate":{"type":"string","format":"date-time"},"ownerId":{"type":"string"},"year":{"type":"string"},"quarter":{"type":"integer","minimum":1,"maximum":4},"half":{"type":"integer","minimum":1,"maximum":2}}},"ObjectiveUpdate":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"description":{"type":"string"},"status":{"type":"string","enum":["Off","On","Done","Push"]},"progress":{"type":"integer","minimum":0,"maximum":100},"startDate":{"type":"string","format":"date-time"},"dueDate":{"type":"string","format":"date-time"},"ownerId":{"type":["string","null"]},"year":{"type":"string"},"quarter":{"type":["integer","null"]},"half":{"type":["integer","null"]}}},"KeyResult":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"objectiveId":{"type":"string","format":"uuid"},"title":{"type":"string"},"description":{"type":["string","null"]},"dueDate":{"type":["string","null"],"format":"date-time"},"ownerId":{"type":["string","null"]},"status":{"type":"string","enum":["Off","On","Done","Push"]},"progress":{"type":"integer"},"trackerType":{"type":"string","enum":["text_only","measure","checklist"]},"measureTracker":{"type":["object","null"]},"taskListTracker":{"type":["array","null"],"items":{"type":"object"}}}},"KeyResultCreate":{"type":"object","required":["objectiveId","title"],"properties":{"objectiveId":{"type":"string","format":"uuid"},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"dueDate":{"type":"string","format":"date-time"},"ownerId":{"type":"string"},"status":{"type":"string","enum":["Off","On","Done","Push"],"default":"Off"},"progress":{"type":"integer","default":0},"trackerType":{"type":"string","enum":["text_only","measure","checklist"],"default":"text_only"}}},"KeyResultUpdate":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"description":{"type":"string"},"dueDate":{"type":["string","null"],"format":"date-time"},"ownerId":{"type":["string","null"]},"status":{"type":"string","enum":["Off","On","Done","Push"]},"progress":{"type":"integer"}}},"Initiative":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"keyResultId":{"type":"string","format":"uuid"},"title":{"type":"string"},"description":{"type":"string"},"notes":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"dueDate":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["Off","On","Done","Push"]}}},"InitiativeCreate":{"type":"object","required":["keyResultId","description"],"properties":{"keyResultId":{"type":"string","format":"uuid"},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"notes":{"type":"string"},"ownerId":{"type":"string"},"dueDate":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["Off","On","Done","Push"],"default":"On"}}},"InitiativeUpdate":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"notes":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"dueDate":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["Off","On","Done","Push"]}}},"UpdateEntry":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"content":{"type":"string"},"isSystemGenerated":{"type":"boolean"},"createdBy":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}}},"Metric":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string"},"unit":{"type":"string"},"currencySymbol":{"type":["string","null"]},"scale":{"type":"string","enum":["none","k","m"]},"targetValue":{"type":["string","null"]},"currentValue":{"type":["string","null"]},"frequency":{"type":"string","enum":["quarterly","monthly","weekly","yearly"]},"ownerId":{"type":["string","null"]},"teamId":{"type":["string","null"],"format":"uuid"},"isActive":{"type":"boolean"}}},"MetricCreate":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":255},"description":{"type":"string"},"category":{"type":"string","default":"revenue"},"unit":{"type":"string"},"currencySymbol":{"type":"string","maxLength":10},"scale":{"type":"string","enum":["none","k","m"],"default":"none"},"targetValue":{"type":["string","number"]},"currentValue":{"type":["string","number"],"default":"0"},"frequency":{"type":"string","enum":["quarterly","monthly","weekly","yearly"],"default":"quarterly"},"ownerId":{"type":"string"},"teamId":{"type":"string","format":"uuid"}}},"MetricUpdate":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"unit":{"type":"string"},"currencySymbol":{"type":"string"},"scale":{"type":"string","enum":["none","k","m"]},"targetValue":{"type":["string","number","null"]},"currentValue":{"type":["string","number"]},"frequency":{"type":"string","enum":["quarterly","monthly","weekly","yearly"]},"ownerId":{"type":["string","null"]},"teamId":{"type":["string","null"],"format":"uuid"},"isActive":{"type":"boolean"}}},"MetricPeriodValue":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"metricId":{"type":"string","format":"uuid"},"periodType":{"type":"string","enum":["quarterly","monthly","weekly","yearly"]},"periodLabel":{"type":"string"},"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"planned":{"type":["string","null"]},"projected":{"type":["string","null"]},"actual":{"type":["string","null"]}}},"MetricPeriodValueCreate":{"type":"object","required":["metricId","periodType","periodLabel","periodStart","periodEnd"],"properties":{"metricId":{"type":"string","format":"uuid"},"periodType":{"type":"string","enum":["quarterly","monthly","weekly","yearly"]},"periodLabel":{"type":"string"},"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"planned":{"type":["string","number","null"]},"projected":{"type":["string","number","null"]},"actual":{"type":["string","number","null"]}}},"TriageItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"title":{"type":"string"},"description":{"type":["string","null"]},"notes":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"status":{"type":"string","enum":["in-progress","completed","deferred"]},"completedAt":{"type":["string","null"],"format":"date-time"},"dateAdded":{"type":["string","null"],"format":"date-time"}}},"TriageItemCreate":{"type":"object","required":["title"],"properties":{"teamId":{"type":"string","format":"uuid"},"title":{"type":"string"},"description":{"type":"string"},"notes":{"type":"string"},"ownerId":{"type":"string"},"status":{"type":"string","enum":["in-progress","completed","deferred"],"default":"in-progress"}}},"TriageItemUpdate":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":["string","null"]},"notes":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"status":{"type":"string","enum":["in-progress","completed","deferred"]}}},"TodoItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"title":{"type":"string"},"description":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"dueDate":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["in-progress","complete","blocked"]},"priority":{"type":"string","enum":["low","medium","high","urgent"]},"isPersonal":{"type":"boolean"},"triageItemId":{"type":["string","null"],"format":"uuid"}}},"TodoItemCreate":{"type":"object","required":["title"],"properties":{"teamId":{"type":"string","format":"uuid"},"title":{"type":"string"},"description":{"type":"string"},"ownerId":{"type":"string"},"dueDate":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["in-progress","complete","blocked"],"default":"in-progress"},"priority":{"type":"string","enum":["low","medium","high","urgent"],"default":"medium"},"isPersonal":{"type":"boolean","default":false}}},"TodoItemUpdate":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":["string","null"]},"ownerId":{"type":["string","null"]},"dueDate":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["in-progress","complete","blocked"]},"priority":{"type":"string","enum":["low","medium","high","urgent"]}}},"VisionItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"content":{"type":"string"},"description":{"type":["string","null"]},"year":{"type":["integer","null"]}}},"PlanItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"content":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":["string","null"]},"year":{"type":["string","null"]}}},"Meeting":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"teamId":{"type":["string","null"],"format":"uuid"},"type":{"type":"string","enum":["launch","quarterly","semi_annual","weekly_camp","annual","all_hands","board","one_on_one"]},"title":{"type":"string"},"description":{"type":["string","null"]},"status":{"type":"string","enum":["scheduled","active","completed"]},"scheduledAt":{"type":["string","null"],"format":"date-time"},"actualStartTime":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"facilitatorId":{"type":["string","null"]}}}}}}