{"openapi":"3.1.0","info":{"title":"WhoWorked API","version":"1.0.0","description":"Time tracking API for WhoWorked. Authenticate with a Bearer token (API key or OAuth access token)."},"servers":[{"url":"https://api.whoworked.com","description":"Production"}],"tags":[{"name":"Workspaces","description":"Manage workspaces"},{"name":"Members","description":"Manage workspace members"},{"name":"Invitations","description":"Manage workspace invitations"},{"name":"Entries","description":"Track time entries"},{"name":"Projects","description":"Manage projects"},{"name":"Clients","description":"Manage clients"},{"name":"Tags","description":"Manage tags"},{"name":"Agents","description":"Manage AI agents and their sessions"},{"name":"AI Sessions","description":"Track AI tool usage sessions"},{"name":"Reports","description":"Generate and manage reports"},{"name":"Client Reports","description":"Generate PDF reports for clients"},{"name":"Client Dashboards","description":"Manage shared client dashboards"},{"name":"API Keys","description":"Manage API keys"},{"name":"OAuth Apps","description":"Manage OAuth 2.0 applications"},{"name":"Project Assignments","description":"Manage user-project assignments"},{"name":"Rate History","description":"View rate change history"},{"name":"Lock Periods","description":"Manage time lock periods"},{"name":"Manager Grants","description":"Manage scoped manager authority"}],"x-tagGroups":[{"name":"Core","tags":["Workspaces","Members","Invitations"]},{"name":"Time Tracking","tags":["Entries","Projects","Clients","Tags"]},{"name":"AI","tags":["Agents","AI Sessions"]},{"name":"Reporting","tags":["Reports","Client Reports","Client Dashboards"]},{"name":"Access Management","tags":["API Keys","OAuth Apps","Manager Grants"]},{"name":"Configuration","tags":["Project Assignments","Rate History","Lock Periods"]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key (whoworked_...), personal access token (whoworked_pat_...), or OAuth 2.0 access token (whoworked_oat_...)"}},"schemas":{"AnomalyOverrides":{"type":"object","nullable":true,"properties":{"durationTooLongHours":{"type":"number","minimum":0,"exclusiveMinimum":true},"missingDescriptionEnabled":{"type":"boolean"}}},"EntriesTotals":{"type":"object","properties":{"entry_count":{"type":"integer"},"duration_seconds":{"type":"integer","description":"Total tracked seconds; running entries measured as of now"},"billable_duration_seconds":{"type":"integer"}},"required":["entry_count","duration_seconds","billable_duration_seconds"]},"ManagerGrant":{"type":"object","properties":{"id":{"type":"string","example":"grn_01abc..."},"workspace_id":{"type":"string","example":"wsp_01..."},"user_id":{"type":"string","example":"user_01..."},"client_id":{"type":"string","nullable":true,"example":"cli_01..."},"project_id":{"type":"string","nullable":true,"example":"prj_01..."},"granted_by":{"type":"string","nullable":true,"example":"user_01...","description":"User who granted this. Null when granted by an API-key integration, which has no user to attribute."},"granted_at":{"type":"string","example":"2026-04-23T00:00:00.000Z"},"revoked_at":{"type":"string","nullable":true}},"required":["id","workspace_id","user_id","client_id","project_id","granted_by","granted_at","revoked_at"]},"CreateManagerGrantBody":{"type":"object","properties":{"user_id":{"type":"string","minLength":1},"client_id":{"type":"string"},"project_id":{"type":"string"}},"required":["user_id"]},"AnomalySettings":{"type":"object","properties":{"rules":{"type":"object","properties":{"duration_too_long":{"type":"object","properties":{"enabled":{"type":"boolean"},"thresholdHours":{"type":"number","minimum":0,"exclusiveMinimum":true}},"required":["enabled","thresholdHours"]},"overlap":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"after_hours":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"weekend":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"missing_description":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"future_dated":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]},"backdated":{"type":"object","properties":{"enabled":{"type":"boolean"},"thresholdDays":{"type":"integer","minimum":0,"exclusiveMinimum":true}},"required":["enabled","thresholdDays"]},"daily_total_too_high":{"type":"object","properties":{"enabled":{"type":"boolean"},"thresholdHours":{"type":"number","minimum":0,"exclusiveMinimum":true}},"required":["enabled","thresholdHours"]}},"required":["duration_too_long","overlap","after_hours","weekend","missing_description","future_dated","backdated","daily_total_too_high"]},"workingHours":{"type":"object","properties":{"start":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"end":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"tz":{"type":"string","minLength":1}},"required":["start","end","tz"]},"weekendDays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"ai":{"type":"object","properties":{"enabled":{"type":"boolean"},"prompt":{"type":"string","maxLength":4000}},"required":["enabled","prompt"]}},"required":["rules","workingHours","weekendDays","ai"]}},"parameters":{}},"paths":{"/shared-reports/{token}":{"get":{"tags":["Shared Reports"],"operationId":"get","summary":"Read a shared report","description":"Runs a shared report with the sharer's live access. Unknown, revoked and expired links are all reported as 404 so the endpoint cannot be used to probe which tokens exist.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Share token"},"required":true,"description":"Share token","name":"token","in":"path"}],"responses":{"200":{"description":"Shared report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["summary","detailed","team","profit"]},"date_range":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"}},"required":["start","end"]},"show_amounts":{"type":"boolean"},"expires_at":{"type":"string","nullable":true},"data":{"nullable":true}},"required":["name","type","date_range","show_amounts","expires_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Link unknown, revoked or expired","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces":{"get":{"tags":["Workspaces"],"operationId":"list","summary":"List workspaces","description":"Returns workspaces the current user is a member of.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of workspaces","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID (wsp_)"},"slug":{"type":"string"},"name":{"type":"string"},"owner_id":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"currency":{"type":"string"},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"subscription_id":{"type":"string","nullable":true},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"plan_id":{"type":"string","nullable":true},"seat_mode":{"type":"string","enum":["elastic","fixed"]},"current_member_count":{"type":"number"},"logo_url":{"type":"string","nullable":true},"primary_color":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"brand_name":{"type":"string","nullable":true},"theme_css":{"type":"object","nullable":true,"properties":{"primary":{"type":"string"},"primaryForeground":{"type":"string"},"primaryHover":{"type":"string"},"accent":{"type":"string"},"accentForeground":{"type":"string"},"ring":{"type":"string"},"mode":{"type":"string","enum":["surface","accent-only"]}},"required":["primary","primaryForeground","primaryHover","accent","accentForeground","ring","mode"]},"custom_domain":{"type":"string","nullable":true},"workos_organization_id":{"type":"string","nullable":true},"subdomain_enabled":{"type":"boolean"},"ai_style_guide":{"type":"string","nullable":true},"use_whoworked_default_style_guide":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","slug","name","owner_id","plan","billable_by_default","project_visibility_by_default","require_tags_on_entries","currency","subscription_status","subscription_id","trial_ends_at","plan_id","seat_mode","current_member_count","logo_url","primary_color","favicon_url","brand_name","theme_css","custom_domain","workos_organization_id","subdomain_enabled","ai_style_guide","use_whoworked_default_style_guide","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Workspaces"],"operationId":"create","summary":"Create a workspace","description":"Creates a new workspace.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"currency":{"type":"string","minLength":3,"maxLength":3,"default":"USD"},"billable_by_default":{"type":"boolean","default":false},"project_visibility_by_default":{"type":"string","enum":["public","private"],"default":"private"}},"required":["name","slug"]}}}},"responses":{"201":{"description":"Workspace created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID (wsp_)"},"slug":{"type":"string"},"name":{"type":"string"},"owner_id":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"currency":{"type":"string"},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"subscription_id":{"type":"string","nullable":true},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"plan_id":{"type":"string","nullable":true},"seat_mode":{"type":"string","enum":["elastic","fixed"]},"current_member_count":{"type":"number"},"logo_url":{"type":"string","nullable":true},"primary_color":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"brand_name":{"type":"string","nullable":true},"theme_css":{"type":"object","nullable":true,"properties":{"primary":{"type":"string"},"primaryForeground":{"type":"string"},"primaryHover":{"type":"string"},"accent":{"type":"string"},"accentForeground":{"type":"string"},"ring":{"type":"string"},"mode":{"type":"string","enum":["surface","accent-only"]}},"required":["primary","primaryForeground","primaryHover","accent","accentForeground","ring","mode"]},"custom_domain":{"type":"string","nullable":true},"workos_organization_id":{"type":"string","nullable":true},"subdomain_enabled":{"type":"boolean"},"ai_style_guide":{"type":"string","nullable":true},"use_whoworked_default_style_guide":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","slug","name","owner_id","plan","billable_by_default","project_visibility_by_default","require_tags_on_entries","currency","subscription_status","subscription_id","trial_ends_at","plan_id","seat_mode","current_member_count","logo_url","primary_color","favicon_url","brand_name","theme_css","custom_domain","workos_organization_id","subdomain_enabled","ai_style_guide","use_whoworked_default_style_guide","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}":{"get":{"tags":["Workspaces"],"operationId":"get","summary":"Get a workspace","description":"Returns a single workspace by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID"},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Workspace found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID (wsp_)"},"slug":{"type":"string"},"name":{"type":"string"},"owner_id":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"currency":{"type":"string"},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"subscription_id":{"type":"string","nullable":true},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"plan_id":{"type":"string","nullable":true},"seat_mode":{"type":"string","enum":["elastic","fixed"]},"current_member_count":{"type":"number"},"logo_url":{"type":"string","nullable":true},"primary_color":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"brand_name":{"type":"string","nullable":true},"theme_css":{"type":"object","nullable":true,"properties":{"primary":{"type":"string"},"primaryForeground":{"type":"string"},"primaryHover":{"type":"string"},"accent":{"type":"string"},"accentForeground":{"type":"string"},"ring":{"type":"string"},"mode":{"type":"string","enum":["surface","accent-only"]}},"required":["primary","primaryForeground","primaryHover","accent","accentForeground","ring","mode"]},"custom_domain":{"type":"string","nullable":true},"workos_organization_id":{"type":"string","nullable":true},"subdomain_enabled":{"type":"boolean"},"ai_style_guide":{"type":"string","nullable":true},"use_whoworked_default_style_guide":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","slug","name","owner_id","plan","billable_by_default","project_visibility_by_default","require_tags_on_entries","currency","subscription_status","subscription_id","trial_ends_at","plan_id","seat_mode","current_member_count","logo_url","primary_color","favicon_url","brand_name","theme_css","custom_domain","workos_organization_id","subdomain_enabled","ai_style_guide","use_whoworked_default_style_guide","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Workspaces"],"operationId":"update","summary":"Update a workspace","description":"Updates workspace settings. Slug changes are owner-only.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID"},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"currency":{"type":"string","minLength":3,"maxLength":3},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"plan_id":{"type":"string","nullable":true},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"logo_url":{"type":"string","nullable":true,"maxLength":2048,"format":"uri"},"primary_color":{"type":"string","nullable":true,"pattern":"^#[0-9a-fA-F]{6}$"},"favicon_url":{"type":"string","nullable":true,"maxLength":2048,"format":"uri"},"brand_name":{"type":"string","nullable":true,"minLength":1,"maxLength":255},"subdomain_enabled":{"type":"boolean"},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"ai_style_guide":{"type":"string","nullable":true,"maxLength":2000},"use_whoworked_default_style_guide":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Workspace updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID (wsp_)"},"slug":{"type":"string"},"name":{"type":"string"},"owner_id":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"currency":{"type":"string"},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"subscription_id":{"type":"string","nullable":true},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"plan_id":{"type":"string","nullable":true},"seat_mode":{"type":"string","enum":["elastic","fixed"]},"current_member_count":{"type":"number"},"logo_url":{"type":"string","nullable":true},"primary_color":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"brand_name":{"type":"string","nullable":true},"theme_css":{"type":"object","nullable":true,"properties":{"primary":{"type":"string"},"primaryForeground":{"type":"string"},"primaryHover":{"type":"string"},"accent":{"type":"string"},"accentForeground":{"type":"string"},"ring":{"type":"string"},"mode":{"type":"string","enum":["surface","accent-only"]}},"required":["primary","primaryForeground","primaryHover","accent","accentForeground","ring","mode"]},"custom_domain":{"type":"string","nullable":true},"workos_organization_id":{"type":"string","nullable":true},"subdomain_enabled":{"type":"boolean"},"ai_style_guide":{"type":"string","nullable":true},"use_whoworked_default_style_guide":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","slug","name","owner_id","plan","billable_by_default","project_visibility_by_default","require_tags_on_entries","currency","subscription_status","subscription_id","trial_ends_at","plan_id","seat_mode","current_member_count","logo_url","primary_color","favicon_url","brand_name","theme_css","custom_domain","workos_organization_id","subdomain_enabled","ai_style_guide","use_whoworked_default_style_guide","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Workspaces"],"operationId":"delete","summary":"Delete a workspace","description":"Soft-deletes a workspace. Owner-only.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID"},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Workspace deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID (wsp_)"},"slug":{"type":"string"},"name":{"type":"string"},"owner_id":{"type":"string"},"plan":{"type":"string","enum":["free","pro","enterprise"]},"billable_by_default":{"type":"boolean"},"project_visibility_by_default":{"type":"string","enum":["public","private"]},"require_tags_on_entries":{"type":"boolean"},"currency":{"type":"string"},"subscription_status":{"type":"string","enum":["trial","active","past_due","suspended"]},"subscription_id":{"type":"string","nullable":true},"trial_ends_at":{"type":"string","nullable":true,"format":"date-time"},"plan_id":{"type":"string","nullable":true},"seat_mode":{"type":"string","enum":["elastic","fixed"]},"current_member_count":{"type":"number"},"logo_url":{"type":"string","nullable":true},"primary_color":{"type":"string","nullable":true},"favicon_url":{"type":"string","nullable":true},"brand_name":{"type":"string","nullable":true},"theme_css":{"type":"object","nullable":true,"properties":{"primary":{"type":"string"},"primaryForeground":{"type":"string"},"primaryHover":{"type":"string"},"accent":{"type":"string"},"accentForeground":{"type":"string"},"ring":{"type":"string"},"mode":{"type":"string","enum":["surface","accent-only"]}},"required":["primary","primaryForeground","primaryHover","accent","accentForeground","ring","mode"]},"custom_domain":{"type":"string","nullable":true},"workos_organization_id":{"type":"string","nullable":true},"subdomain_enabled":{"type":"boolean"},"ai_style_guide":{"type":"string","nullable":true},"use_whoworked_default_style_guide":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","slug","name","owner_id","plan","billable_by_default","project_visibility_by_default","require_tags_on_entries","currency","subscription_status","subscription_id","trial_ends_at","plan_id","seat_mode","current_member_count","logo_url","primary_color","favicon_url","brand_name","theme_css","custom_domain","workos_organization_id","subdomain_enabled","ai_style_guide","use_whoworked_default_style_guide","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/slug-history":{"get":{"tags":["Workspaces"],"operationId":"getSlugHistory","summary":"Get workspace slug history","description":"Returns the slug change history for a workspace. Owner-only.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID"},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Slug history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"old_slug":{"type":"string"},"new_slug":{"type":"string"},"changed_at":{"type":"string","format":"date-time"},"changed_by":{"type":"string","nullable":true},"redirect_expires_at":{"type":"string","nullable":true,"format":"date-time"},"redirect_status":{"type":"string","enum":["active","freed","expired"]}},"required":["id","workspace_id","old_slug","new_slug","changed_at","changed_by","redirect_expires_at","redirect_status"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/api-keys":{"get":{"tags":["API Keys"],"operationId":"list","summary":"List API keys","description":"Returns a paginated list of API keys in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of API keys","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"API Key ID (key_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_by":{"type":"string"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"expires_at":{"type":"string","nullable":true,"format":"date-time"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","scopes","created_by","last_used_at","expires_at","revoked_at","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["API Keys"],"operationId":"create","summary":"Create an API key","description":"Creates a new API key. The raw key is only returned once.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"scopes":{"type":"array","items":{"type":"string","enum":["entries:read","entries:write","entries:impersonate","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","invoices:read","invoices:write","tags:read","tags:write","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","ai_attributions:manage","deliverables:read","deliverables:write","deliverables:approve","ai_reporters:read","ai_reporters:write","external_id_mappings:read","external_id_mappings:write","skills:read","skills:write","members:read","members:write","invitations:read","invitations:write"]},"default":["entries:read","entries:write","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","invoices:read","invoices:write","tags:read","tags:write","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","ai_attributions:manage","deliverables:read","deliverables:write","ai_reporters:read","ai_reporters:write","external_id_mappings:read","external_id_mappings:write","skills:read","skills:write","members:read","members:write","invitations:read","invitations:write"]},"expires_at":{"type":"string","format":"date-time"}},"required":["name"]}}}},"responses":{"201":{"description":"API key created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"API Key ID (key_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_by":{"type":"string"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"expires_at":{"type":"string","nullable":true,"format":"date-time"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"key":{"type":"string","description":"Raw API key (whoworked_) — only shown once"}},"required":["id","workspace_id","name","scopes","created_by","last_used_at","expires_at","revoked_at","created_at","updated_at","deleted","deleted_at","key"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/api-keys/{key_id}":{"patch":{"tags":["API Keys"],"operationId":"revoke","summary":"Revoke an API key","description":"Revokes an API key, making it unusable.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"API Key ID"},"required":true,"description":"API Key ID","name":"key_id","in":"path"}],"responses":{"200":{"description":"API key revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"API Key ID (key_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_by":{"type":"string"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"expires_at":{"type":"string","nullable":true,"format":"date-time"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","scopes","created_by","last_used_at","expires_at","revoked_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["API Keys"],"operationId":"delete","summary":"Delete an API key","description":"Permanently deletes an API key.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"API Key ID"},"required":true,"description":"API Key ID","name":"key_id","in":"path"}],"responses":{"204":{"description":"API key deleted"}}}},"/v1/workspaces/{workspace_id}/personal-access-tokens":{"get":{"tags":["Personal Access Tokens"],"operationId":"list","summary":"List personal access tokens","description":"Returns the caller's personal access tokens. Owners and admins can pass all=true to list every token in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"all","in":"query"}],"responses":{"200":{"description":"Paginated list of personal access tokens","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Personal access token ID (pat_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["entries:read","entries:write","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","tags:read","tags:write","members:read","invoices:read","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","deliverables:read","deliverables:write"]}},"token_hint":{"type":"string","minLength":4,"maxLength":4},"user_id":{"type":"string","description":"WorkOS user ID of the token owner"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","scopes","token_hint","user_id","last_used_at","expires_at","created_at","updated_at","status"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Personal Access Tokens"],"operationId":"create","summary":"Create a personal access token","description":"Creates a personal access token for the caller. The raw token is only returned once.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"scopes":{"type":"array","items":{"type":"string","enum":["entries:read","entries:write","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","tags:read","tags:write","members:read","invoices:read","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","deliverables:read","deliverables:write"]},"minItems":1},"expires_at":{"type":"string","format":"date-time"}},"required":["name","scopes","expires_at"]}}}},"responses":{"201":{"description":"Personal access token created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Personal access token ID (pat_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["entries:read","entries:write","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","tags:read","tags:write","members:read","invoices:read","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","deliverables:read","deliverables:write"]}},"token_hint":{"type":"string","minLength":4,"maxLength":4},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"token":{"type":"string","description":"Raw personal access token (whoworked_pat_) — only shown once"}},"required":["id","name","scopes","token_hint","expires_at","created_at","token"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/personal-access-tokens/{pat_id}":{"patch":{"tags":["Personal Access Tokens"],"operationId":"revoke","summary":"Revoke a personal access token","description":"Revokes a token owned by the caller, or any workspace token for owners and admins.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^pat_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","description":"Personal access token ID (pat_)"},"required":true,"description":"Personal access token ID (pat_)","name":"pat_id","in":"path"}],"responses":{"200":{"description":"Personal access token revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Personal access token ID (pat_)"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["entries:read","entries:write","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","tags:read","tags:write","members:read","invoices:read","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","deliverables:read","deliverables:write"]}},"token_hint":{"type":"string","minLength":4,"maxLength":4},"user_id":{"type":"string","description":"WorkOS user ID of the token owner"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","scopes","token_hint","user_id","last_used_at","expires_at","created_at","updated_at","status"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Personal Access Tokens"],"operationId":"delete","summary":"Delete a personal access token","description":"Soft-deletes a token owned by the caller, or any workspace token for owners and admins. Active tokens are revoked first.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^pat_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","description":"Personal access token ID (pat_)"},"required":true,"description":"Personal access token ID (pat_)","name":"pat_id","in":"path"}],"responses":{"204":{"description":"Personal access token deleted"}}}},"/v1/workspaces/{workspace_id}/mcp-connections":{"get":{"tags":["MCP Connections"],"operationId":"list","summary":"List active MCP connections","description":"Returns active OAuth-based MCP connections for the current user.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Active MCP connections","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"app_name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"device":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"created_at":{"type":"string"},"last_used_at":{"type":"string","nullable":true},"expires_at":{"type":"string"}},"required":["id","app_name","scopes","device","location","created_at","last_used_at","expires_at"]}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/mcp-connections/{connection_id}":{"delete":{"tags":["MCP Connections"],"operationId":"revoke","summary":"Revoke an MCP connection","description":"Revokes an active MCP connection (OAuth access token).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Connection ID"},"required":true,"description":"Connection ID","name":"connection_id","in":"path"}],"responses":{"204":{"description":"Connection revoked"},"404":{"description":"Connection not found"}}}},"/v1/workspaces/{workspace_id}/mcp-connections/all":{"get":{"tags":["MCP Connections"],"operationId":"listAll","summary":"List all workspace MCP connections","description":"Returns all active OAuth-based MCP connections across all users in the workspace. Requires owner or admin role.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"All active MCP connections in workspace","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"app_name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"device":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"created_at":{"type":"string"},"last_used_at":{"type":"string","nullable":true},"expires_at":{"type":"string"},"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string"}},"required":["id","app_name","scopes","device","location","created_at","last_used_at","expires_at","user_id","user_name","user_email"]}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/mcp-connections/all/{connection_id}":{"delete":{"tags":["MCP Connections"],"operationId":"revokeAny","summary":"Revoke any MCP connection","description":"Revokes any active MCP connection in the workspace regardless of owner. Requires owner or admin role.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Connection ID"},"required":true,"description":"Connection ID","name":"connection_id","in":"path"}],"responses":{"204":{"description":"Connection revoked"},"404":{"description":"Connection not found"}}}},"/v1/workspaces/{workspace_id}/oauth-apps":{"get":{"tags":["OAuth Apps"],"operationId":"list","summary":"List OAuth apps","description":"Returns a paginated list of OAuth applications in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Paginated list of OAuth apps","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string","nullable":true},"name":{"type":"string"},"client_id":{"type":"string"},"redirect_uris":{"type":"array","items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"created_by":{"type":"string"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"authorized_users":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string"}},"required":["user_id","user_name","user_email"]}}},"required":["id","workspace_id","name","client_id","redirect_uris","scopes","description","logo_url","created_by","revoked_at","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["OAuth Apps"],"operationId":"create","summary":"Create an OAuth app","description":"Creates a new OAuth application. The client secret is only returned once.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"redirect_uris":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1},"scopes":{"type":"array","items":{"type":"string"},"default":[]},"description":{"type":"string","maxLength":500},"logo_url":{"type":"string","format":"uri"}},"required":["name","redirect_uris"]}}}},"responses":{"201":{"description":"OAuth app created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string","nullable":true},"name":{"type":"string"},"client_id":{"type":"string"},"redirect_uris":{"type":"array","items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"created_by":{"type":"string"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"authorized_users":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string"}},"required":["user_id","user_name","user_email"]}},"client_secret":{"type":"string","description":"Client secret — only shown once"}},"required":["id","workspace_id","name","client_id","redirect_uris","scopes","description","logo_url","created_by","revoked_at","created_at","updated_at","deleted","deleted_at","client_secret"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/oauth-apps/{app_id}":{"get":{"tags":["OAuth Apps"],"operationId":"get","summary":"Get an OAuth app","description":"Returns a single OAuth application by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"OAuth App ID"},"required":true,"description":"OAuth App ID","name":"app_id","in":"path"}],"responses":{"200":{"description":"OAuth app found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string","nullable":true},"name":{"type":"string"},"client_id":{"type":"string"},"redirect_uris":{"type":"array","items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"created_by":{"type":"string"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"authorized_users":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string"}},"required":["user_id","user_name","user_email"]}}},"required":["id","workspace_id","name","client_id","redirect_uris","scopes","description","logo_url","created_by","revoked_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["OAuth Apps"],"operationId":"update","summary":"Update an OAuth app","description":"Updates an existing OAuth application.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"OAuth App ID"},"required":true,"description":"OAuth App ID","name":"app_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"redirect_uris":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1},"scopes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","nullable":true,"maxLength":500},"logo_url":{"type":"string","nullable":true,"format":"uri"}}}}}},"responses":{"200":{"description":"OAuth app updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string","nullable":true},"name":{"type":"string"},"client_id":{"type":"string"},"redirect_uris":{"type":"array","items":{"type":"string"}},"scopes":{"type":"array","items":{"type":"string"}},"description":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"created_by":{"type":"string"},"revoked_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"authorized_users":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string"}},"required":["user_id","user_name","user_email"]}}},"required":["id","workspace_id","name","client_id","redirect_uris","scopes","description","logo_url","created_by","revoked_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["OAuth Apps"],"operationId":"delete","summary":"Delete an OAuth app","description":"Permanently deletes an OAuth application.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"OAuth App ID"},"required":true,"description":"OAuth App ID","name":"app_id","in":"path"}],"responses":{"204":{"description":"OAuth app deleted"}}}},"/v1/workspaces/{workspace_id}/clients":{"get":{"tags":["Clients"],"operationId":"list","summary":"List clients","description":"Returns a paginated list of clients in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of clients","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Client ID (cli_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"email":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"hourly_rate":{"type":"number","nullable":true},"notes":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","email","currency","hourly_rate","notes","slug","logo_url","archived_at","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Clients"],"operationId":"create","summary":"Create a client","description":"Creates a new client in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"email":{"type":"string","format":"email"},"currency":{"type":"string","minLength":3,"maxLength":3},"hourly_rate":{"type":"integer","minimum":0},"notes":{"type":"string","nullable":true},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"logo_url":{"type":"string","nullable":true,"maxLength":2048,"format":"uri"}},"required":["name"]}}}},"responses":{"201":{"description":"Client created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Client ID (cli_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"email":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"hourly_rate":{"type":"number","nullable":true},"notes":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","email","currency","hourly_rate","notes","slug","logo_url","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/clients/{client_id}":{"get":{"tags":["Clients"],"operationId":"get","summary":"Get a client","description":"Returns a single client by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Client ID"},"required":true,"description":"Client ID","name":"client_id","in":"path"}],"responses":{"200":{"description":"Client found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Client ID (cli_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"email":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"hourly_rate":{"type":"number","nullable":true},"notes":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","email","currency","hourly_rate","notes","slug","logo_url","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Clients"],"operationId":"update","summary":"Update a client","description":"Updates an existing client.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Client ID"},"required":true,"description":"Client ID","name":"client_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"email":{"type":"string","nullable":true,"format":"email"},"currency":{"type":"string","nullable":true,"minLength":3,"maxLength":3},"hourly_rate":{"type":"integer","nullable":true,"minimum":0},"effective_from":{"type":"string","nullable":true,"format":"date"},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"notes":{"type":"string","nullable":true},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"logo_url":{"type":"string","nullable":true,"maxLength":2048,"format":"uri"}}}}}},"responses":{"200":{"description":"Client updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Client ID (cli_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"email":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"hourly_rate":{"type":"number","nullable":true},"notes":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"logo_url":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","email","currency","hourly_rate","notes","slug","logo_url","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/clients/{client_id}/report":{"post":{"tags":["Client Reports"],"operationId":"generate","summary":"Generate a client report","description":"Generates a PDF report for a client and returns it as binary.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Client ID"},"required":true,"description":"Client ID","name":"client_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"sections":{"type":"object","properties":{"cover":{"type":"boolean","default":true},"summary":{"type":"boolean","default":true},"projects":{"type":"boolean","default":true},"time_log":{"type":"boolean","default":false}},"default":{"cover":true,"summary":true,"projects":true,"time_log":false}},"visibility":{"type":"object","properties":{"show_billable_amounts":{"type":"boolean","default":true},"show_team_members":{"type":"boolean","default":false},"show_descriptions":{"type":"boolean","default":true}},"default":{"show_billable_amounts":true,"show_team_members":false,"show_descriptions":true}}},"required":["from","to"]}}}},"responses":{"200":{"description":"PDF report"}}}},"/v1/workspaces/{workspace_id}/clients/{client_id}/reports":{"get":{"tags":["Client Reports"],"operationId":"list","summary":"List client reports","description":"Lists saved reports for a client.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Client ID"},"required":true,"description":"Client ID","name":"client_id","in":"path"}],"responses":{"200":{"description":"Client reports","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/client-dashboards":{"post":{"tags":["Client Dashboards"],"operationId":"create","summary":"Create a client dashboard","description":"Creates a new client dashboard for sharing time tracking data.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":255},"visibility_config":{"type":"object","properties":{"show_billable_amounts":{"type":"boolean","default":true},"show_hourly_rates":{"type":"boolean","default":false},"show_team_members":{"type":"boolean","default":false},"show_descriptions":{"type":"boolean","default":true},"show_tags":{"type":"boolean","default":true},"show_budget_progress":{"type":"boolean","default":true},"show_burn_chart":{"type":"boolean","default":true}}},"layout":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"options":{"nullable":true}},"required":["id","type"]}},"ai_value_config":{"type":"object","properties":{"audience":{"type":"string","enum":["external","internal"],"default":"external"},"disclosure":{"type":"string","enum":["internal","signal","transparent"],"default":"internal"},"rules":{"type":"array","items":{"type":"object","properties":{"scope":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["workspace"]}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","enum":["project"]},"projectId":{"type":"string","minLength":1}},"required":["kind","projectId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["workstream"]},"taskId":{"type":"string","minLength":1}},"required":["kind","taskId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["tag"]},"tagId":{"type":"string","minLength":1}},"required":["kind","tagId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["contribution"]},"type":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"required":["kind","type"]},{"type":"object","properties":{"kind":{"type":"string","enum":["model"]},"model":{"type":"string","minLength":1}},"required":["kind","model"]}]},"basis":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["multiplier"]},"factor":{"type":"number","minimum":0,"maximum":1}},"required":["kind","factor"]},{"type":"object","properties":{"kind":{"type":"string","enum":["token"]},"markupPct":{"type":"number","minimum":0}},"required":["kind"]}]}},"required":["scope","basis"]},"default":[]},"thresholds":{"type":"object","properties":{"minAiShareToShow":{"type":"number","minimum":0,"maximum":1,"default":0.05},"minCoverageToQuantify":{"type":"number","minimum":0,"maximum":1,"default":0.7},"warmupReports":{"type":"integer","minimum":0,"default":2}},"default":{"minAiShareToShow":0.05,"minCoverageToQuantify":0.7,"warmupReports":2}}}},"password":{"type":"string","minLength":6,"maxLength":128},"expires_at":{"type":"string","format":"date-time"}},"required":["client_id"]}}}},"responses":{"201":{"description":"Dashboard created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"get":{"tags":["Client Dashboards"],"operationId":"list","summary":"List client dashboards","description":"Returns a paginated list of client dashboards.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Paginated list of dashboards","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"nullable":true}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/client-dashboards/{dashboard_id}":{"get":{"tags":["Client Dashboards"],"operationId":"get","summary":"Get a client dashboard","description":"Returns a single client dashboard by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Dashboard ID"},"required":true,"description":"Dashboard ID","name":"dashboard_id","in":"path"}],"responses":{"200":{"description":"Dashboard found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"patch":{"tags":["Client Dashboards"],"operationId":"update","summary":"Update a client dashboard","description":"Updates an existing client dashboard.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Dashboard ID"},"required":true,"description":"Dashboard ID","name":"dashboard_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"visibility_config":{"type":"object","properties":{"show_billable_amounts":{"type":"boolean","default":true},"show_hourly_rates":{"type":"boolean","default":false},"show_team_members":{"type":"boolean","default":false},"show_descriptions":{"type":"boolean","default":true},"show_tags":{"type":"boolean","default":true},"show_budget_progress":{"type":"boolean","default":true},"show_burn_chart":{"type":"boolean","default":true}}},"layout":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"options":{"nullable":true}},"required":["id","type"]}},"ai_value_config":{"type":"object","properties":{"audience":{"type":"string","enum":["external","internal"],"default":"external"},"disclosure":{"type":"string","enum":["internal","signal","transparent"],"default":"internal"},"rules":{"type":"array","items":{"type":"object","properties":{"scope":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["workspace"]}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","enum":["project"]},"projectId":{"type":"string","minLength":1}},"required":["kind","projectId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["workstream"]},"taskId":{"type":"string","minLength":1}},"required":["kind","taskId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["tag"]},"tagId":{"type":"string","minLength":1}},"required":["kind","tagId"]},{"type":"object","properties":{"kind":{"type":"string","enum":["contribution"]},"type":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"required":["kind","type"]},{"type":"object","properties":{"kind":{"type":"string","enum":["model"]},"model":{"type":"string","minLength":1}},"required":["kind","model"]}]},"basis":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["multiplier"]},"factor":{"type":"number","minimum":0,"maximum":1}},"required":["kind","factor"]},{"type":"object","properties":{"kind":{"type":"string","enum":["token"]},"markupPct":{"type":"number","minimum":0}},"required":["kind"]}]}},"required":["scope","basis"]},"default":[]},"thresholds":{"type":"object","properties":{"minAiShareToShow":{"type":"number","minimum":0,"maximum":1,"default":0.05},"minCoverageToQuantify":{"type":"number","minimum":0,"maximum":1,"default":0.7},"warmupReports":{"type":"integer","minimum":0,"default":2}},"default":{"minAiShareToShow":0.05,"minCoverageToQuantify":0.7,"warmupReports":2}}}},"password":{"type":"string","nullable":true,"minLength":6,"maxLength":128},"expires_at":{"type":"string","nullable":true,"format":"date-time"}}}}}},"responses":{"200":{"description":"Dashboard updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"delete":{"tags":["Client Dashboards"],"operationId":"revoke","summary":"Revoke a client dashboard","description":"Revokes access to a client dashboard.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Dashboard ID"},"required":true,"description":"Dashboard ID","name":"dashboard_id","in":"path"}],"responses":{"200":{"description":"Dashboard revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/client-dashboards/{dashboard_id}/regenerate-token":{"post":{"tags":["Client Dashboards"],"operationId":"regenerate","summary":"Regenerate dashboard token","description":"Regenerates the access token for a client dashboard.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Dashboard ID"},"required":true,"description":"Dashboard ID","name":"dashboard_id","in":"path"}],"responses":{"200":{"description":"Token regenerated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/client-dashboards/{dashboard_id}/layout/assist":{"post":{"tags":["Client Dashboards"],"operationId":"assistLayout","summary":"AI-assisted layout edit","description":"Turns a natural-language request into validated layout operations, staged for human review. Never alters computed numbers.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Dashboard ID"},"required":true,"description":"Dashboard ID","name":"dashboard_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":2000},"mode":{"type":"string","enum":["adjust","generate"],"default":"adjust"},"layout":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"options":{"nullable":true}},"required":["id","type"]}}},"required":["prompt","layout"]}}}},"responses":{"200":{"description":"Proposed layout operations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects":{"get":{"tags":["Projects"],"operationId":"list","summary":"List projects","description":"Returns a paginated list of projects in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"client_id","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_custom_fields","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"assigned_only","in":"query"}],"responses":{"200":{"description":"Paginated list of projects","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Project ID (prj_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","nullable":true},"name":{"type":"string"},"slug":{"type":"string","nullable":true},"color":{"type":"string"},"icon":{"type":"string","nullable":true},"billable_by_default":{"type":"boolean"},"hourly_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["public","private"]},"budget_weekly_hours":{"type":"number","nullable":true},"budget_total_hours":{"type":"number","nullable":true},"budget_amount":{"type":"number","nullable":true},"approval_mode":{"type":"string","enum":["off","all","over_budget"]},"anomaly_overrides":{"$ref":"#/components/schemas/AnomalyOverrides"},"ai_style_guide":{"type":"string","nullable":true},"tracked_hours":{"type":"number"},"billable_amount_cents":{"type":"number"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}}},"required":["id","workspace_id","client_id","name","slug","color","icon","billable_by_default","hourly_rate","currency","notes","archived_at","created_at","updated_at","visibility","budget_weekly_hours","budget_total_hours","budget_amount","approval_mode","anomaly_overrides","ai_style_guide","tracked_hours","billable_amount_cents","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Projects"],"operationId":"create","summary":"Create a project","description":"Creates a new project in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"client_id":{"type":"string"},"color":{"type":"string","pattern":"^#[0-9a-f]{6}$/i","default":"#6366f1"},"icon":{"type":"string","nullable":true,"maxLength":64},"billable_by_default":{"type":"boolean","default":false},"hourly_rate":{"type":"integer","minimum":0},"currency":{"type":"string","minLength":3,"maxLength":3},"notes":{"type":"string","nullable":true},"visibility":{"type":"string","enum":["public","private"],"description":"Project visibility. Defaults to the workspace's project_visibility_by_default setting."},"budget_weekly_hours":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"budget_total_hours":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"budget_amount":{"type":"integer","nullable":true,"minimum":0},"approval_mode":{"type":"string","enum":["off","all","over_budget"],"default":"off"}},"required":["name"]}}}},"responses":{"201":{"description":"Project created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Project ID (prj_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","nullable":true},"name":{"type":"string"},"slug":{"type":"string","nullable":true},"color":{"type":"string"},"icon":{"type":"string","nullable":true},"billable_by_default":{"type":"boolean"},"hourly_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["public","private"]},"budget_weekly_hours":{"type":"number","nullable":true},"budget_total_hours":{"type":"number","nullable":true},"budget_amount":{"type":"number","nullable":true},"approval_mode":{"type":"string","enum":["off","all","over_budget"]},"anomaly_overrides":{"$ref":"#/components/schemas/AnomalyOverrides"},"ai_style_guide":{"type":"string","nullable":true},"tracked_hours":{"type":"number"},"billable_amount_cents":{"type":"number"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}}},"required":["id","workspace_id","client_id","name","slug","color","icon","billable_by_default","hourly_rate","currency","notes","archived_at","created_at","updated_at","visibility","budget_weekly_hours","budget_total_hours","budget_amount","approval_mode","anomaly_overrides","ai_style_guide","tracked_hours","billable_amount_cents","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}":{"get":{"tags":["Projects"],"operationId":"get","summary":"Get a project","description":"Returns a single project by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"}],"responses":{"200":{"description":"Project found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Project ID (prj_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","nullable":true},"name":{"type":"string"},"slug":{"type":"string","nullable":true},"color":{"type":"string"},"icon":{"type":"string","nullable":true},"billable_by_default":{"type":"boolean"},"hourly_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["public","private"]},"budget_weekly_hours":{"type":"number","nullable":true},"budget_total_hours":{"type":"number","nullable":true},"budget_amount":{"type":"number","nullable":true},"approval_mode":{"type":"string","enum":["off","all","over_budget"]},"anomaly_overrides":{"$ref":"#/components/schemas/AnomalyOverrides"},"ai_style_guide":{"type":"string","nullable":true},"tracked_hours":{"type":"number"},"billable_amount_cents":{"type":"number"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}}},"required":["id","workspace_id","client_id","name","slug","color","icon","billable_by_default","hourly_rate","currency","notes","archived_at","created_at","updated_at","visibility","budget_weekly_hours","budget_total_hours","budget_amount","approval_mode","anomaly_overrides","ai_style_guide","tracked_hours","billable_amount_cents","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Projects"],"operationId":"update","summary":"Update a project","description":"Updates an existing project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"slug":{"type":"string","minLength":2,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"client_id":{"type":"string","nullable":true},"color":{"type":"string","pattern":"^#[0-9a-f]{6}$/i"},"icon":{"type":"string","nullable":true,"maxLength":64},"billable_by_default":{"type":"boolean"},"hourly_rate":{"type":"integer","nullable":true,"minimum":0},"effective_from":{"type":"string","nullable":true,"format":"date"},"currency":{"type":"string","nullable":true,"minLength":3,"maxLength":3},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"notes":{"type":"string","nullable":true},"visibility":{"type":"string","enum":["public","private"]},"budget_weekly_hours":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"budget_total_hours":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true},"budget_amount":{"type":"integer","nullable":true,"minimum":0},"approval_mode":{"type":"string","enum":["off","all","over_budget"]},"anomaly_overrides":{"$ref":"#/components/schemas/AnomalyOverrides"},"ai_style_guide":{"type":"string","nullable":true,"maxLength":2000}}}}}},"responses":{"200":{"description":"Project updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Project ID (prj_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","nullable":true},"name":{"type":"string"},"slug":{"type":"string","nullable":true},"color":{"type":"string"},"icon":{"type":"string","nullable":true},"billable_by_default":{"type":"boolean"},"hourly_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["public","private"]},"budget_weekly_hours":{"type":"number","nullable":true},"budget_total_hours":{"type":"number","nullable":true},"budget_amount":{"type":"number","nullable":true},"approval_mode":{"type":"string","enum":["off","all","over_budget"]},"anomaly_overrides":{"$ref":"#/components/schemas/AnomalyOverrides"},"ai_style_guide":{"type":"string","nullable":true},"tracked_hours":{"type":"number"},"billable_amount_cents":{"type":"number"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}}},"required":["id","workspace_id","client_id","name","slug","color","icon","billable_by_default","hourly_rate","currency","notes","archived_at","created_at","updated_at","visibility","budget_weekly_hours","budget_total_hours","budget_amount","approval_mode","anomaly_overrides","ai_style_guide","tracked_hours","billable_amount_cents","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/budget":{"get":{"tags":["Projects"],"operationId":"getBudget","summary":"Get project budget summary","description":"Returns the budget summary for a project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"}],"responses":{"200":{"description":"Budget summary","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"budget_weekly_hours":{"type":"number","nullable":true},"budget_total_hours":{"type":"number","nullable":true},"total_used_hours":{"type":"number"},"pending_hours":{"type":"number"},"weekly_used_hours_by_user":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"hours":{"type":"number"},"budget_weekly_hours":{"type":"number","nullable":true}},"required":["user_id","hours","budget_weekly_hours"]}}},"required":["budget_weekly_hours","budget_total_hours","total_used_hours","pending_hours","weekly_used_hours_by_user"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/tasks":{"get":{"tags":["Tasks"],"operationId":"list","summary":"List tasks","description":"Returns a paginated list of tasks in the project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"}],"responses":{"200":{"description":"Paginated list of tasks","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Tasks"],"operationId":"create","summary":"Create a task","description":"Creates a new task in the project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"color":{"type":"string","nullable":true,"pattern":"^#[0-9a-f]{6}$/i"}},"required":["name"]}}}},"responses":{"201":{"description":"Task created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}":{"get":{"tags":["Tasks"],"operationId":"get","summary":"Get a task","description":"Returns a single task by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"Task ID"},"required":true,"description":"Task ID","name":"task_id","in":"path"}],"responses":{"200":{"description":"Task found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Tasks"],"operationId":"update","summary":"Update a task","description":"Updates an existing task.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"Task ID"},"required":true,"description":"Task ID","name":"task_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"color":{"type":"string","nullable":true,"pattern":"^#[0-9a-f]{6}$/i"}}}}}},"responses":{"200":{"description":"Task updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Tasks"],"operationId":"delete","summary":"Delete a task","description":"Permanently deletes a task. Fails if any time entries reference it.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"Task ID"},"required":true,"description":"Task ID","name":"task_id","in":"path"}],"responses":{"204":{"description":"Task deleted"}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}/archive":{"post":{"tags":["Tasks"],"operationId":"archive","summary":"Archive a task","description":"Marks a task as archived.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"Task ID"},"required":true,"description":"Task ID","name":"task_id","in":"path"}],"responses":{"200":{"description":"Task archived","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/tasks/{task_id}/unarchive":{"post":{"tags":["Tasks"],"operationId":"unarchive","summary":"Unarchive a task","description":"Clears the archived marker on a task.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"Task ID"},"required":true,"description":"Task ID","name":"task_id","in":"path"}],"responses":{"200":{"description":"Task unarchived","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/tasks":{"get":{"tags":["Tasks"],"operationId":"listAll","summary":"List tasks across the workspace","description":"Paginated list of all tasks in the workspace, optionally filtered by project. Used for populating filter bars.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_ids","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"}],"responses":{"200":{"description":"Paginated list of workspace tasks","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Task ID (tsk_)"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"project_name":{"type":"string"}},"required":["id","workspace_id","project_id","name","color","archived_at","created_at","updated_at","project_name"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries":{"get":{"tags":["Entries"],"operationId":"list","summary":"List entries","description":"Returns a paginated list of time entries in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"},{"schema":{"type":"string","enum":["pending","approved","rejected"]},"required":false,"name":"approval_status","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"project_ids","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"task_ids","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"client_ids","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"member_ids","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"tag_ids","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"approval_statuses","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"billable","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"running","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_custom_fields","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"show_tags","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_totals","in":"query"},{"schema":{"type":"string"},"required":false,"name":"date_from","in":"query"},{"schema":{"type":"string"},"required":false,"name":"date_to","in":"query"},{"schema":{"type":"string"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of entries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]},"totals":{"$ref":"#/components/schemas/EntriesTotals"}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Entries"],"operationId":"create","summary":"Create an entry","description":"Creates a new time entry. If stopped_at is omitted, the entry starts running.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"task_id":{"type":"string","nullable":true},"description":{"type":"string","maxLength":10000},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","format":"date-time"},"billable":{"type":"boolean"},"user_id":{"type":"string","description":"On-behalf-of owner user id. Requires the entries:impersonate scope."},"tag_ids":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Entry created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}":{"get":{"tags":["Entries"],"operationId":"get","summary":"Get an entry","description":"Returns a single time entry by ID, with billing fields the requester is entitled to see.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"responses":{"200":{"description":"Entry found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."},"client_id":{"type":"string","nullable":true,"description":"Client ID (cli_)"},"client_name":{"type":"string","nullable":true},"billable_amount_cents":{"type":"number","nullable":true},"effective_hourly_rate":{"type":"number","nullable":true},"cost_cents":{"type":"number","nullable":true},"effective_cost_rate":{"type":"number","nullable":true}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons","client_id","client_name","billable_amount_cents","effective_hourly_rate","cost_cents","effective_cost_rate"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Entries"],"operationId":"update","summary":"Update an entry","description":"Updates an existing time entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true,"maxLength":10000},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"tag_ids":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Entry updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Entries"],"operationId":"delete","summary":"Delete an entry","description":"Soft-deletes a time entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"responses":{"204":{"description":"Entry deleted"}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}/tags":{"post":{"tags":["Entries"],"operationId":"attachTag","summary":"Attach a tag to an entry","description":"Associates a tag with a time entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag_id":{"type":"string","minLength":1}},"required":["tag_id"]}}}},"responses":{"201":{"description":"Tag attached","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entry_id":{"type":"string"},"tag_id":{"type":"string"}},"required":["entry_id","tag_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}/tags/{tag_id}":{"delete":{"tags":["Entries"],"operationId":"detachTag","summary":"Detach a tag from an entry","description":"Removes a tag association from a time entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"},{"schema":{"type":"string","description":"Tag ID"},"required":true,"description":"Tag ID","name":"tag_id","in":"path"}],"responses":{"200":{"description":"Tag detached","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entry_id":{"type":"string"},"tag_id":{"type":"string"}},"required":["entry_id","tag_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}/approve":{"post":{"tags":["Entries"],"operationId":"approve","summary":"Approve or reject an entry","description":"Approves pending or untracked entries, or rejects pending entries. Repeating the same terminal decision refreshes its audit metadata.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["approve","reject"]},"note":{"type":"string","maxLength":500}},"required":["action"]}}}},"responses":{"200":{"description":"Entry approved/rejected","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries/enhance-description":{"post":{"tags":["Entries"],"operationId":"enhance","summary":"Enhance an entry description with AI","description":"Rewrites a rough time-entry description into a polished one using the workspace's AI style guide.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":3,"maxLength":1000},"project_id":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true}},"required":["text"]}}}},"responses":{"200":{"description":"Enhanced description","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"enhanced":{"type":"string","maxLength":1000},"unchanged":{"type":"boolean"}},"required":["enhanced","unchanged"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"429":{"description":"Rate limit exceeded"},"503":{"description":"Enhancement unavailable"}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}/stop":{"post":{"tags":["Entries"],"operationId":"stop","summary":"Stop a running entry","description":"Stops a running time entry. Optionally provide stopped_at, defaults to now.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"responses":{"200":{"description":"Entry stopped","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Entry ID (ent_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"project_color":{"type":"string","nullable":true},"project_icon":{"type":"string","nullable":true},"task_id":{"type":"string","nullable":true},"task":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"user_id":{"type":"string","nullable":true},"agent_id":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"stopped_at":{"type":"string","nullable":true,"format":"date-time"},"billable":{"type":"boolean"},"approval_status":{"type":"string","nullable":true,"enum":["pending","approved","rejected",null]},"approval_by":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true,"format":"date-time"},"rejected_at":{"type":"string","nullable":true,"format":"date-time"},"approval_note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"flag_reasons":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string","enum":["low","med","high"]},"detail":{"type":"string","nullable":true},"source":{"type":"string","enum":["rule","ai"]},"aiConfidence":{"type":"string","enum":["low","med","high"]}},"required":["rule","severity","detail","source"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"field_type":{"type":"string"},"value":{"nullable":true}},"required":["field_id","field_name","field_type"]}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"description":"Present when tags were requested (list: show_tags=true, default; get: always)."}},"required":["id","workspace_id","project_id","task_id","task","user_id","agent_id","description","started_at","stopped_at","billable","approval_status","approval_by","approved_at","rejected_at","approval_note","created_at","updated_at","deleted","deleted_at","flag_reasons"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/entries/{entry_id}/validate":{"post":{"tags":["Entries"],"operationId":"validate","summary":"AI-validate a time entry","description":"Uses AI to check a time entry for potential issues such as unusual duration, missing description, or timing anomalies.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Entry ID"},"required":true,"description":"Entry ID","name":"entry_id","in":"path"}],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"is_valid":{"type":"boolean"},"issues":{"type":"array","items":{"type":"string"}},"suggestions":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"}},"required":["is_valid","issues","suggestions","confidence"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/tags":{"get":{"tags":["Tags"],"operationId":"list","summary":"List tags","description":"Returns a paginated list of tags in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"applied_to_members","in":"query"}],"responses":{"200":{"description":"Paginated list of tags","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","color","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Tags"],"operationId":"create","summary":"Create a tag","description":"Creates a new tag in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["name"]}}}},"responses":{"201":{"description":"Tag created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","color","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/tags/{tag_id}":{"get":{"tags":["Tags"],"operationId":"get","summary":"Get a tag","description":"Returns a single tag by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Tag ID"},"required":true,"description":"Tag ID","name":"tag_id","in":"path"}],"responses":{"200":{"description":"Tag found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","color","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Tags"],"operationId":"update","summary":"Update a tag","description":"Updates an existing tag.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Tag ID"},"required":true,"description":"Tag ID","name":"tag_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"type":"string","nullable":true,"pattern":"^#[0-9a-fA-F]{6}$"}}}}}},"responses":{"200":{"description":"Tag updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Tag ID (tag_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","color","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/agents":{"get":{"tags":["Agents"],"operationId":"list","summary":"List agents","description":"Returns a paginated list of agents in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of agents","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Agent ID (agt_)"},"workspace_id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["ci","coding","data","custom"]},"model":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","type","model","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Agents"],"operationId":"create","summary":"Create an agent","description":"Creates a new agent in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"type":{"type":"string","enum":["ci","coding","data","custom"]},"model":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["name","type"]}}}},"responses":{"201":{"description":"Agent created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Agent ID (agt_)"},"workspace_id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["ci","coding","data","custom"]},"model":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","type","model","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/agents/{agent_id}":{"get":{"tags":["Agents"],"operationId":"get","summary":"Get an agent","description":"Returns a single agent by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"}],"responses":{"200":{"description":"Agent found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Agent ID (agt_)"},"workspace_id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["ci","coding","data","custom"]},"model":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","type","model","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Agents"],"operationId":"update","summary":"Update an agent","description":"Updates an existing agent.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"model":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"}}}}}},"responses":{"200":{"description":"Agent updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Agent ID (agt_)"},"workspace_id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["ci","coding","data","custom"]},"model":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","name","type","model","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/agents/{agent_id}/sessions":{"get":{"tags":["Agents"],"operationId":"listSessions","summary":"List agent sessions","description":"Returns a paginated list of sessions for an agent.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["running","completed","failed"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of sessions","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Session ID (ses_)"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"trigger":{"type":"string","enum":["manual","webhook","scheduled","ci"]},"status":{"type":"string","enum":["running","completed","failed"]},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","trigger","status","started_at","ended_at","tokens_used","cost_usd","metadata","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Agents"],"operationId":"createSession","summary":"Create an agent session","description":"Creates a new session for an agent.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string"},"trigger":{"type":"string","enum":["manual","webhook","scheduled","ci"]},"started_at":{"type":"string","format":"date-time"},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["trigger"]}}}},"responses":{"201":{"description":"Session created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Session ID (ses_)"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"trigger":{"type":"string","enum":["manual","webhook","scheduled","ci"]},"status":{"type":"string","enum":["running","completed","failed"]},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","trigger","status","started_at","ended_at","tokens_used","cost_usd","metadata","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/agents/{agent_id}/sessions/{session_id}":{"get":{"tags":["Agents"],"operationId":"getSession","summary":"Get an agent session","description":"Returns a single agent session by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"},{"schema":{"type":"string","description":"Session ID"},"required":true,"description":"Session ID","name":"session_id","in":"path"}],"responses":{"200":{"description":"Session found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Session ID (ses_)"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"trigger":{"type":"string","enum":["manual","webhook","scheduled","ci"]},"status":{"type":"string","enum":["running","completed","failed"]},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","trigger","status","started_at","ended_at","tokens_used","cost_usd","metadata","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Agents"],"operationId":"updateSession","summary":"Update an agent session","description":"Updates an existing agent session.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Agent ID"},"required":true,"description":"Agent ID","name":"agent_id","in":"path"},{"schema":{"type":"string","description":"Session ID"},"required":true,"description":"Session ID","name":"session_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["running","completed","failed"]},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"tokens_used":{"type":"integer","minimum":0},"cost_usd":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Session updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Session ID (ses_)"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"trigger":{"type":"string","enum":["manual","webhook","scheduled","ci"]},"status":{"type":"string","enum":["running","completed","failed"]},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","trigger","status","started_at","ended_at","tokens_used","cost_usd","metadata","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions":{"get":{"tags":["AI Attributions"],"summary":"List AI attributions","description":"Returns a paginated list of AI attributions in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^(ent_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary."},"required":false,"description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary.","name":"timeEntryId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"userId","in":"query"},{"schema":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"required":false,"name":"reviewStatus","in":"query"},{"schema":{"type":"boolean","nullable":true},"required":false,"name":"orphan","in":"query"},{"schema":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"required":false,"name":"identityStatus","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Paginated list of AI attributions","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["AI Attributions"],"summary":"Create or push an AI attribution","description":"Creates a manual attribution (session principal + timeEntryId) or pushes a host event (api-key principal).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"timeEntryId":{"type":"string","pattern":"^(ent_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary."},"tool":{"type":"string","minLength":1},"model":{"type":"string"},"level":{"type":"string","enum":["primarily_ai","collaborative","primarily_human","no_ai"]},"contributionType":{"type":"array","items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","enum":["human","ai_suggested"]},"useCaseNote":{"type":"string"}},"required":["timeEntryId","tool"]},{"type":"object","properties":{"userId":{"type":"string"},"externalUserId":{"type":"string"},"externalSystem":{"type":"string"},"email":{"type":"string","format":"email"},"reporterId":{"type":"string","format":"uuid"},"tool":{"type":"string","minLength":1},"model":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"},"promptTokens":{"type":"integer","minimum":0},"completionTokens":{"type":"integer","minimum":0},"cachedTokens":{"type":"integer","minimum":0},"costUsd":{"type":"number","minimum":0},"conversationId":{"type":"string"},"messageId":{"type":"string"},"useCaseNote":{"type":"string"},"contributionType":{"type":"array","items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"level":{"type":"string","enum":["primarily_ai","collaborative","primarily_human","no_ai"]},"initiation":{"type":"string","enum":["human","ai_suggested"]},"source":{"type":"string","enum":["host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"],"default":"redacted_content"},"capturePolicyVersion":{"type":"string"},"contentRef":{"type":"string","nullable":true},"correlationTimeEntryId":{"type":"string","pattern":"^(ent_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary."},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"allowUnresolved":{"type":"boolean","default":false}},"required":["tool","occurredAt"]}]}}}},"responses":{"201":{"description":"Attribution created","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]},{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"matched":{"type":"boolean"},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]}},"required":["id","timeEntryId","parentAttributionId","reviewStatus","matched","identityStatus"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/batch":{"post":{"tags":["AI Attributions"],"summary":"Batch push AI attributions","description":"Pushes multiple AI attribution events in a single request.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"externalUserId":{"type":"string"},"externalSystem":{"type":"string"},"email":{"type":"string","format":"email"},"reporterId":{"type":"string","format":"uuid"},"tool":{"type":"string","minLength":1},"model":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"},"promptTokens":{"type":"integer","minimum":0},"completionTokens":{"type":"integer","minimum":0},"cachedTokens":{"type":"integer","minimum":0},"costUsd":{"type":"number","minimum":0},"conversationId":{"type":"string"},"messageId":{"type":"string"},"useCaseNote":{"type":"string"},"contributionType":{"type":"array","items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"level":{"type":"string","enum":["primarily_ai","collaborative","primarily_human","no_ai"]},"initiation":{"type":"string","enum":["human","ai_suggested"]},"source":{"type":"string","enum":["host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"],"default":"redacted_content"},"capturePolicyVersion":{"type":"string"},"contentRef":{"type":"string","nullable":true},"correlationTimeEntryId":{"type":"string","pattern":"^(ent_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary."},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"allowUnresolved":{"type":"boolean","default":false}},"required":["tool","occurredAt"]},"minItems":1,"maxItems":100}},"required":["events"]}}}},"responses":{"201":{"description":"Batch results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"results":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"matched":{"type":"boolean"},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"ok":{"type":"boolean","enum":[true]}},"required":["id","timeEntryId","parentAttributionId","reviewStatus","matched","identityStatus","ok"]},{"type":"object","properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"string"}},"required":["ok","error"]}]}}},"required":["results"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/identity-issues":{"get":{"tags":["AI Attributions"],"summary":"List unresolved AI attribution identities","description":"Groups unresolved attribution activity by its stable claimed identity.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Grouped identity issues","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"identityKey":{"type":"string"},"identityStatus":{"type":"string","enum":["known_non_member","unknown_actor"]},"claimedEmail":{"type":"string","nullable":true},"claimedUserId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"tool":{"type":"string"},"eventCount":{"type":"integer"},"firstSeenAt":{"type":"string"},"lastSeenAt":{"type":"string"},"promptTokens":{"type":"integer"},"completionTokens":{"type":"integer"},"costUsd":{"type":"string"}},"required":["identityKey","identityStatus","claimedEmail","claimedUserId","externalUserId","externalSystem","reporterId","tool","eventCount","firstSeenAt","lastSeenAt","promptTokens","completionTokens","costUsd"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/identity-issues/link-member":{"post":{"tags":["AI Attributions"],"summary":"Link an attribution identity to a workspace member","description":"Creates a durable identity alias and reprocesses the unresolved backlog.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identityKey":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1}},"required":["identityKey","userId"]}}}},"responses":{"200":{"description":"Identity linked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"updated":{"type":"integer"}},"required":["updated"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/identity-issues/dismiss":{"post":{"tags":["AI Attributions"],"summary":"Dismiss an attribution identity issue","description":"Ignores all current unresolved activity in the identity group.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"identityKey":{"type":"string","minLength":1}},"required":["identityKey"]}}}},"responses":{"200":{"description":"Identity issue dismissed","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"updated":{"type":"integer"}},"required":["updated"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/{attribution_id}":{"patch":{"tags":["AI Attributions"],"summary":"Update an AI attribution","description":"Edits mutable fields on an attribution.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","minLength":1},"model":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","enum":["human","ai_suggested"]},"useCaseNote":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["unreviewed","reviewed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]}}}}}},"responses":{"200":{"description":"Attribution updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["AI Attributions"],"summary":"Delete an AI attribution","description":"Soft-deletes an AI attribution.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"responses":{"204":{"description":"Attribution deleted"}}}},"/v1/workspaces/{workspace_id}/ai-attributions/{attribution_id}/confirm":{"post":{"tags":["AI Attributions"],"summary":"Confirm an AI attribution","description":"Marks an attribution reviewed, without asserting how much of the work it was. To record the involvement level and output verdict in the same action, PATCH the attribution with { level, outputVerdict, reviewStatus: \"reviewed\" } instead — that is what the review queue does. A row confirmed without a level is reported as unassessed, never as a measurement.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"responses":{"200":{"description":"Attribution confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/{attribution_id}/dismiss":{"post":{"tags":["AI Attributions"],"summary":"Dismiss an AI attribution","description":"Marks an attribution as not real work. Dismissed rows are excluded from reports, client-facing composition, deliverable rollups and the work graph.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"responses":{"200":{"description":"Attribution dismissed","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/{attribution_id}/verify":{"post":{"tags":["AI Attributions"],"summary":"Verify a reviewed AI attribution","description":"Second-line sign-off on an already-reviewed attribution. Requires an assigned involvement level — verifying a row nobody assessed would present an absence as a confirmation.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"responses":{"200":{"description":"Attribution verified","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/{attribution_id}/link-time-entry":{"post":{"tags":["AI Attributions"],"summary":"Link an orphan attribution to a time entry","description":"Attaches an orphan AI attribution to a specific time entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Attribution ID"},"required":true,"description":"AI Attribution ID","name":"attribution_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeEntryId":{"type":"string","pattern":"^(ent_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID. Public callers should send ent_; legacy raw UUIDs are normalized at the API boundary."}},"required":["timeEntryId"]}}}},"responses":{"200":{"description":"Attribution linked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"timeEntryId":{"type":"string","nullable":true,"pattern":"^ent_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","description":"Time entry ID (ent_)."},"parentAttributionId":{"type":"string","nullable":true,"format":"uuid"},"userId":{"type":"string","nullable":true},"identityStatus":{"type":"string","enum":["resolved_member","known_non_member","unknown_actor"]},"claimedUserId":{"type":"string","nullable":true},"claimedEmail":{"type":"string","nullable":true},"identityKey":{"type":"string","nullable":true},"reporterId":{"type":"string","nullable":true,"format":"uuid"},"source":{"type":"string","enum":["manual","host_push","extension","provider_api","mcp","cli_hook"]},"captureMode":{"type":"string","enum":["metadata_only","redacted_content","full_content"]},"capturePolicyVersion":{"type":"string","nullable":true},"contentRef":{"type":"string","nullable":true},"reviewStatus":{"type":"string","enum":["auto_draft","unreviewed","reviewed","verified","dismissed"]},"outputVerdict":{"type":"string","nullable":true,"enum":["used_as_is","edited","discarded",null]},"verifiedBy":{"type":"string","nullable":true},"verifiedAt":{"type":"string","nullable":true},"level":{"type":"string","nullable":true,"enum":["primarily_ai","collaborative","primarily_human","no_ai",null]},"contributionType":{"type":"array","nullable":true,"items":{"type":"string","enum":["generated","edited","summarized","translated","researched","coded","reviewed"]}},"initiation":{"type":"string","nullable":true,"enum":["human","ai_suggested",null]},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"promptTokens":{"type":"number","nullable":true},"completionTokens":{"type":"number","nullable":true},"cachedTokens":{"type":"number","nullable":true},"costUsd":{"type":"string","nullable":true},"useCaseNote":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true},"messageId":{"type":"string","nullable":true},"externalUserId":{"type":"string","nullable":true},"externalSystem":{"type":"string","nullable":true},"occurredAt":{"type":"string"},"startedAt":{"type":"string","nullable":true},"endedAt":{"type":"string","nullable":true},"reviewedBy":{"type":"string","nullable":true},"reviewedAt":{"type":"string","nullable":true},"dismissedAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","timeEntryId","parentAttributionId","userId","identityStatus","claimedUserId","claimedEmail","identityKey","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","outputVerdict","verifiedBy","verifiedAt","level","contributionType","initiation","tool","model","promptTokens","completionTokens","cachedTokens","costUsd","useCaseNote","conversationId","messageId","externalUserId","externalSystem","occurredAt","startedAt","endedAt","reviewedBy","reviewedAt","dismissedAt","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-attributions/bulk-confirm":{"post":{"tags":["AI Attributions"],"summary":"Bulk confirm AI attributions","description":"Confirms multiple AI attributions in a single request.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":500}},"required":["ids"]}}}},"responses":{"200":{"description":"Bulk confirm result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"confirmed":{"type":"integer"}},"required":["confirmed"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-reporters":{"get":{"tags":["AI Reporters"],"summary":"List AI reporters","description":"Returns AI reporters registered for the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"List of AI reporters","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"userId":{"type":"string","nullable":true},"surface":{"type":"string","enum":["browser_extension","claude_code_hook","codex_cli_hook","mcp_connector","host_push","desktop_companion"]},"displayName":{"type":"string","nullable":true},"adapterVersion":{"type":"string","nullable":true},"deviceFingerprintHash":{"type":"string","nullable":true},"capabilities":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","stale","revoked"]},"firstSeenAt":{"type":"string"},"lastHeartbeatAt":{"type":"string","nullable":true},"lastSeenAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","userId","surface","displayName","adapterVersion","deviceFingerprintHash","capabilities","status","firstSeenAt","lastHeartbeatAt","lastSeenAt","metadata","createdAt","updatedAt"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-reporters/heartbeat":{"post":{"tags":["AI Reporters"],"summary":"Send AI reporter heartbeat","description":"Creates or updates an AI reporter for the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reporterId":{"type":"string","format":"uuid"},"surface":{"type":"string","enum":["browser_extension","claude_code_hook","codex_cli_hook","mcp_connector","host_push","desktop_companion"]},"displayName":{"type":"string"},"adapterVersion":{"type":"string"},"deviceFingerprintHash":{"type":"string","minLength":1},"capabilities":{"type":"array","items":{"type":"string"},"default":[]},"observedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["surface"]}}}},"responses":{"200":{"description":"Reporter heartbeat accepted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"userId":{"type":"string","nullable":true},"surface":{"type":"string","enum":["browser_extension","claude_code_hook","codex_cli_hook","mcp_connector","host_push","desktop_companion"]},"displayName":{"type":"string","nullable":true},"adapterVersion":{"type":"string","nullable":true},"deviceFingerprintHash":{"type":"string","nullable":true},"capabilities":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","stale","revoked"]},"firstSeenAt":{"type":"string"},"lastHeartbeatAt":{"type":"string","nullable":true},"lastSeenAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","userId","surface","displayName","adapterVersion","deviceFingerprintHash","capabilities","status","firstSeenAt","lastHeartbeatAt","lastSeenAt","metadata","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-reporters/{reporter_id}/revoke":{"post":{"tags":["AI Reporters"],"summary":"Revoke AI reporter","description":"Marks an AI reporter as revoked.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","format":"uuid","description":"AI Reporter ID"},"required":true,"description":"AI Reporter ID","name":"reporter_id","in":"path"}],"responses":{"200":{"description":"Reporter revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspaceId":{"type":"string","format":"uuid"},"userId":{"type":"string","nullable":true},"surface":{"type":"string","enum":["browser_extension","claude_code_hook","codex_cli_hook","mcp_connector","host_push","desktop_companion"]},"displayName":{"type":"string","nullable":true},"adapterVersion":{"type":"string","nullable":true},"deviceFingerprintHash":{"type":"string","nullable":true},"capabilities":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","stale","revoked"]},"firstSeenAt":{"type":"string"},"lastHeartbeatAt":{"type":"string","nullable":true},"lastSeenAt":{"type":"string","nullable":true},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","workspaceId","userId","surface","displayName","adapterVersion","deviceFingerprintHash","capabilities","status","firstSeenAt","lastHeartbeatAt","lastSeenAt","metadata","createdAt","updatedAt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-sessions":{"get":{"tags":["AI Sessions"],"operationId":"list","summary":"List AI sessions","description":"Returns a paginated list of AI sessions in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"},{"schema":{"type":"string","enum":["chatgpt","claude","gemini","api","slack"]},"required":false,"name":"source","in":"query"},{"schema":{"type":"string"},"required":false,"name":"model","in":"query"},{"schema":{"type":"string","description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone"},"required":false,"description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone","name":"date_from","in":"query"},{"schema":{"type":"string","description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone"},"required":false,"description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone","name":"date_to","in":"query"}],"responses":{"200":{"description":"Paginated list of AI sessions","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"actor_user_id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"source":{"type":"string"},"source_session_id":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"message_count":{"type":"number","nullable":true},"summary":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","actor_user_id","title","source","source_session_id","model","message_count","summary","url","tokens_used","cost_usd","started_at","ended_at","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["AI Sessions"],"operationId":"create","summary":"Create an AI session","description":"Creates a new AI session in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"project_id":{"type":"string"},"source":{"type":"string","enum":["chatgpt","claude","gemini","api","slack"]},"model":{"type":"string"},"tokens_used":{"type":"integer","minimum":0},"cost_usd":{"type":"string"},"message_count":{"type":"integer","minimum":0},"summary":{"type":"string","maxLength":5000},"url":{"type":"string","format":"uri"},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","format":"date-time"}},"required":["title","source"]}}}},"responses":{"201":{"description":"AI session created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"actor_user_id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"source":{"type":"string"},"source_session_id":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"message_count":{"type":"number","nullable":true},"summary":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","actor_user_id","title","source","source_session_id","model","message_count","summary","url","tokens_used","cost_usd","started_at","ended_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-sessions/stats":{"get":{"tags":["AI Sessions"],"operationId":"getStats","summary":"Get AI session stats","description":"Returns aggregated stats for AI sessions.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"},{"schema":{"type":"string","description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone"},"required":false,"description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone","name":"date_from","in":"query"},{"schema":{"type":"string","description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone"},"required":false,"description":"ISO 8601 date (YYYY-MM-DD) or datetime with timezone","name":"date_to","in":"query"}],"responses":{"200":{"description":"AI session stats","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total_sessions":{"type":"number"},"total_tokens":{"type":"number"},"total_cost_usd":{"type":"string"},"by_source":{"type":"array","items":{"type":"object","properties":{"sessions":{"type":"number"},"tokens":{"type":"number"},"cost_usd":{"type":"string"},"source":{"type":"string"}},"required":["sessions","tokens","cost_usd","source"]}},"by_model":{"type":"array","items":{"type":"object","properties":{"sessions":{"type":"number"},"tokens":{"type":"number"},"cost_usd":{"type":"string"},"model":{"type":"string"}},"required":["sessions","tokens","cost_usd","model"]}}},"required":["total_sessions","total_tokens","total_cost_usd","by_source","by_model"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-sessions/{session_id}":{"get":{"tags":["AI Sessions"],"operationId":"get","summary":"Get an AI session","description":"Returns a single AI session by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Session ID"},"required":true,"description":"AI Session ID","name":"session_id","in":"path"}],"responses":{"200":{"description":"AI session found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"actor_user_id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"source":{"type":"string"},"source_session_id":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"message_count":{"type":"number","nullable":true},"summary":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","actor_user_id","title","source","source_session_id","model","message_count","summary","url","tokens_used","cost_usd","started_at","ended_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["AI Sessions"],"operationId":"update","summary":"Update an AI session","description":"Updates an existing AI session.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Session ID"},"required":true,"description":"AI Session ID","name":"session_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":500},"project_id":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true,"maxLength":5000},"model":{"type":"string","nullable":true},"tokens_used":{"type":"integer","minimum":0},"cost_usd":{"type":"string","nullable":true},"message_count":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true,"format":"uri"},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"}}}}}},"responses":{"200":{"description":"AI session updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"agent_id":{"type":"string"},"project_id":{"type":"string","nullable":true},"actor_user_id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"source":{"type":"string"},"source_session_id":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"message_count":{"type":"number","nullable":true},"summary":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"tokens_used":{"type":"number","nullable":true},"cost_usd":{"type":"string","nullable":true},"started_at":{"type":"string","format":"date-time"},"ended_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","agent_id","project_id","actor_user_id","title","source","source_session_id","model","message_count","summary","url","tokens_used","cost_usd","started_at","ended_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["AI Sessions"],"operationId":"delete","summary":"Delete an AI session","description":"Soft-deletes an AI session.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"AI Session ID"},"required":true,"description":"AI Session ID","name":"session_id","in":"path"}],"responses":{"204":{"description":"AI session deleted"}}}},"/v1/workspaces/{workspace_id}/deliverables":{"get":{"tags":["Deliverables"],"summary":"List deliverables","description":"Returns a paginated list of deliverables in the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["draft","submitted","approved","rejected"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","description":"Project ID (prj_)"},"required":false,"description":"Project ID (prj_)","name":"project_id","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Paginated list of deliverables","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Deliverables"],"summary":"Create a deliverable","description":"Creates a deliverable in draft. Optionally links time entries and attributions in the same call, so an agent can declare and attach its work at once.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"project_id":{"type":"string","description":"Project ID (prj_)"},"description":{"type":"string","maxLength":5000},"entry_ids":{"type":"array","items":{"type":"string"},"maxItems":200},"attribution_ids":{"type":"array","items":{"type":"string"},"maxItems":200}},"required":["title","project_id"]}}}},"responses":{"201":{"description":"Deliverable created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/candidates":{"get":{"tags":["Deliverables"],"summary":"Suggest deliverables from undeclared work","description":"Clusters recent time entries and attributions that belong to no deliverable into candidates, ranked by value. Computed on request, so a candidate disappears as soon as its work is linked by hand.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Candidate deliverables, most valuable first","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"cluster_key":{"type":"string"},"project_id":{"type":"string"},"label":{"type":"string"},"entry_ids":{"type":"array","items":{"type":"string"}},"attribution_ids":{"type":"array","items":{"type":"string"}},"hours":{"type":"number"},"billable_cents":{"type":"integer"},"ai_cost_usd":{"type":"string"},"total_value_cents":{"type":"integer"},"first_seen":{"type":"string"},"last_seen":{"type":"string"}},"required":["cluster_key","project_id","label","entry_ids","attribution_ids","hours","billable_cents","ai_cost_usd","total_value_cents","first_seen","last_seen"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/candidates/dismiss":{"post":{"tags":["Deliverables"],"summary":"Dismiss a candidate deliverable","description":"Records that a suggested cluster is not a deliverable, so it stops appearing. Keyed on the candidate's cluster_key; logging more work into the same window produces a new key and the candidate returns, because the earlier judgement was about the earlier evidence.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cluster_key":{"type":"string","minLength":1,"maxLength":500}},"required":["cluster_key"]}}}},"responses":{"200":{"description":"Candidate updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/candidates/restore":{"post":{"tags":["Deliverables"],"summary":"Restore a dismissed candidate","description":"Forgets a previous dismissal, so the candidate can be suggested again.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cluster_key":{"type":"string","minLength":1,"maxLength":500}},"required":["cluster_key"]}}}},"responses":{"200":{"description":"Candidate updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}":{"get":{"tags":["Deliverables"],"summary":"Get a deliverable","description":"Returns the deliverable with its rollup. Unapproved deliverables carry a derived AIA preview and a proportion suggestion; approved ones carry the snapshotted statement.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"responses":{"200":{"description":"Deliverable detail","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"rollup":{"type":"object","properties":{"human_hours":{"type":"number"},"billable_cents":{"type":"integer"},"cost_cents":{"type":"integer"},"entry_count":{"type":"integer"},"attribution_count":{"type":"integer"},"direct_count":{"type":"integer"},"inherited_count":{"type":"integer"},"tokens":{"type":"integer"},"ai_cost_usd":{"type":"number"},"tools":{"type":"array","items":{"type":"string"}},"models":{"type":"array","items":{"type":"string"}},"all_reviewed":{"type":"boolean"},"unreviewed_count":{"type":"integer"},"unassessed_count":{"type":"integer"}},"required":["human_hours","billable_cents","cost_cents","entry_count","attribution_count","direct_count","inherited_count","tokens","ai_cost_usd","tools","models","all_reviewed","unreviewed_count","unassessed_count"]},"proportion_suggestion":{"type":"object","nullable":true,"properties":{"proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"assessed_count":{"type":"integer"},"unassessed_count":{"type":"integer"}},"required":["proportion","assessed_count","unassessed_count"]},"aia_compact":{"type":"string","nullable":true},"aia_prose":{"type":"string","nullable":true}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at","rollup","proportion_suggestion","aia_compact","aia_prose"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Deliverables"],"summary":"Update a deliverable","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","nullable":true,"maxLength":5000}}}}}},"responses":{"200":{"description":"Deliverable updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Deliverables"],"summary":"Delete a deliverable","description":"Soft-deletes the deliverable. Linked time entries and attributions are unaffected beyond losing the link.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"responses":{"200":{"description":"Deliverable deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/link":{"post":{"tags":["Deliverables"],"summary":"Link work","description":"Attaches time entries and/or attributions to the deliverable.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entry_ids":{"type":"array","items":{"type":"string"},"maxItems":200},"attribution_ids":{"type":"array","items":{"type":"string"},"maxItems":200}}}}}},"responses":{"200":{"description":"Work links updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entries":{"type":"integer"},"attributions":{"type":"integer"}},"required":["entries","attributions"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/unlink":{"post":{"tags":["Deliverables"],"summary":"Unlink work","description":"Detaches time entries and/or attributions from the deliverable.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entry_ids":{"type":"array","items":{"type":"string"},"maxItems":200},"attribution_ids":{"type":"array","items":{"type":"string"},"maxItems":200}}}}}},"responses":{"200":{"description":"Work links updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entries":{"type":"integer"},"attributions":{"type":"integer"}},"required":["entries","attributions"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/submit":{"post":{"tags":["Deliverables"],"summary":"Submit a deliverable for approval","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"responses":{"200":{"description":"Deliverable submitted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/approve":{"post":{"tags":["Deliverables"],"summary":"Approve a deliverable and record its AI disclosure","description":"Records the approver's AIA proportion and snapshots the rendered statement. This is the only way a statement comes into existence; nothing derives one automatically.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aia_proportion":{"type":"string","enum":["EAI","PAI","HAb","Ph","Eh"]}},"required":["aia_proportion"]}}}},"responses":{"200":{"description":"Deliverable approved","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/reject":{"post":{"tags":["Deliverables"],"summary":"Reject a submitted deliverable","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["reason"]}}}},"responses":{"200":{"description":"Deliverable rejected","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/revise":{"post":{"tags":["Deliverables"],"summary":"Reopen a deliverable for revision","description":"Returns the deliverable to draft and clears its recorded statement, because reopening means the statement no longer describes it.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"}],"responses":{"200":{"description":"Deliverable reopened","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"project_id":{"type":"string"},"client_id":{"type":"string","nullable":true},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","submitted","approved","rejected"]},"aia_proportion":{"type":"string","nullable":true,"enum":["EAI","PAI","HAb","Ph","Eh",null]},"aia_statement":{"type":"string","nullable":true},"aia_schema_version":{"type":"string","nullable":true},"submitted_at":{"type":"string","nullable":true},"submitted_by_user_id":{"type":"string","nullable":true},"approved_at":{"type":"string","nullable":true},"approved_by_user_id":{"type":"string","nullable":true},"rejected_at":{"type":"string","nullable":true},"rejection_reason":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","mcp","api","mined"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","client_id","title","description","status","aia_proportion","aia_statement","aia_schema_version","submitted_at","submitted_by_user_id","approved_at","approved_by_user_id","rejected_at","rejection_reason","source","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/deliverables/{deliverable_id}/export":{"get":{"tags":["Deliverables"],"summary":"Export a deliverable's AI disclosure","description":"Returns the disclosure artifact for an approved deliverable. Unapproved deliverables are rejected rather than exported empty.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Deliverable ID (dlv_)"},"required":true,"description":"Deliverable ID (dlv_)","name":"deliverable_id","in":"path"},{"schema":{"type":"string","enum":["json","csv"],"default":"json"},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"Disclosure export","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/workspaces/{workspace_id}/work-graph":{"get":{"tags":["Work graph"],"summary":"Get the workspace work graph","description":"Builds the traceability graph — scope, actors, work events, disclosure artifacts and deliverables — from the workspace's own rows. Every node is backed by a record; nothing is synthesised.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"The work graph","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["scope","actor","work-event","artifact","outcome"]},"kind":{"type":"string"},"label":{"type":"string"},"detail":{"type":"string"},"cost":{"type":"number"},"duration":{"type":"number"},"tokens":{"type":"number"},"zoomLevel":{"type":"string","enum":["outcome","work","event"]},"timestamp":{"type":"string"}},"required":["id","type","kind","label","zoomLevel"]}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"type":{"type":"string"},"category":{"type":"string"},"label":{"type":"string"}},"required":["id","source","target","type","category"]}}},"required":["nodes","edges"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-reporting":{"get":{"tags":["AI Reporting"],"operationId":"getAiReporting","summary":"Get server-side AI reporting aggregates","description":"Returns complete-window AI usage, reporter health, attribution correlation quality, and an optional session drill-down without client-side row caps.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"until","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":100,"default":"UTC"},"required":false,"name":"timezone","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":500},"required":false,"name":"conversation_id","in":"query"}],"responses":{"200":{"description":"AI reporting aggregates","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"window":{"type":"object","properties":{"since":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"},"timezone":{"type":"string"}},"required":["since","until","timezone"]},"usage":{"type":"object","properties":{"summary":{"type":"object","properties":{"total_cost_usd":{"type":"string"},"requests":{"type":"integer"},"avg_cost_usd":{"type":"string"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"active_users":{"type":"integer"},"usage_mode":{"type":"string","enum":["cost","requests"]}},"required":["total_cost_usd","requests","avg_cost_usd","prompt_tokens","completion_tokens","cached_tokens","total_tokens","active_users","usage_mode"]},"by_tool":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"cost_usd":{"type":"string"},"requests":{"type":"integer"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"percent":{"type":"number"}},"required":["id","label","cost_usd","requests","prompt_tokens","completion_tokens","cached_tokens","total_tokens","percent"]}},"by_model":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"cost_usd":{"type":"string"},"requests":{"type":"integer"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"percent":{"type":"number"}},"required":["id","label","cost_usd","requests","prompt_tokens","completion_tokens","cached_tokens","total_tokens","percent"]}},"by_user":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"cost_usd":{"type":"string"},"requests":{"type":"integer"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"percent":{"type":"number"}},"required":["id","label","cost_usd","requests","prompt_tokens","completion_tokens","cached_tokens","total_tokens","percent"]}},"by_hour":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"cost_usd":{"type":"string"},"requests":{"type":"integer"},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"total_tokens":{"type":"integer"},"percent":{"type":"number"},"hour_key":{"type":"string"}},"required":["id","label","cost_usd","requests","prompt_tokens","completion_tokens","cached_tokens","total_tokens","percent","hour_key"]}}},"required":["summary","by_tool","by_model","by_user","by_hour"]},"reporter_health":{"type":"object","properties":{"members":{"type":"integer"},"reporters":{"type":"integer"},"active_reporters":{"type":"integer"},"stale_reporters":{"type":"integer"},"revoked_reporters":{"type":"integer"},"members_active":{"type":"integer"},"members_stale":{"type":"integer"},"members_without_reporter":{"type":"integer"},"adoption_score":{"type":"number","nullable":true}},"required":["members","reporters","active_reporters","stale_reporters","revoked_reporters","members_active","members_stale","members_without_reporter","adoption_score"]},"correlation":{"type":"object","properties":{"total":{"type":"integer"},"with_reporter":{"type":"integer"},"with_conversation":{"type":"integer"},"with_message":{"type":"integer"},"with_full_dedupe_key":{"type":"integer"},"linked_to_time_entry":{"type":"integer"},"reporter_rate":{"type":"number"},"full_key_rate":{"type":"number"},"time_entry_link_rate":{"type":"number"}},"required":["total","with_reporter","with_conversation","with_message","with_full_dedupe_key","linked_to_time_entry","reporter_rate","full_key_rate","time_entry_link_rate"]},"session":{"type":"object","nullable":true,"properties":{"conversation_id":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"message_id":{"type":"string","nullable":true},"occurred_at":{"type":"string","format":"date-time"},"tool":{"type":"string"},"model":{"type":"string","nullable":true},"event_type":{"type":"string","nullable":true},"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"},"cost_usd":{"type":"string"},"linked_to_time_entry":{"type":"boolean"},"reporter_id":{"type":"string","nullable":true,"format":"uuid"}},"required":["id","message_id","occurred_at","tool","model","event_type","prompt_tokens","completion_tokens","cached_tokens","cost_usd","linked_to_time_entry","reporter_id"]}}},"required":["conversation_id","events"]}},"required":["window","usage","reporter_health","correlation","session"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/provider-ingest/claude-code":{"post":{"tags":["Provider ingest"],"summary":"Pull Claude Code usage from the Anthropic Admin API","description":"Fetches per-user-per-day Claude Code usage and records it as provider_api attributions. Idempotent: re-running a range refreshes cost/tokens and re-parents late CLI-hook rows. Requires an Anthropic Admin API credential configured for the workspace. Pass `{}` when using the default lookback.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"}}}}}},"responses":{"200":{"description":"Ingest run summary","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"days":{"type":"integer"},"fetched":{"type":"integer"},"inserted":{"type":"integer"},"duplicates":{"type":"integer"},"unresolved":{"type":"integer"},"api_key_actors":{"type":"integer"},"reconciled":{"type":"integer"},"unreconciled":{"type":"integer"},"errors":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"message":{"type":"string"}},"required":["day","message"]}}},"required":["days","fetched","inserted","duplicates","unresolved","api_key_actors","reconciled","unreconciled","errors"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/provider-ingest/credential":{"get":{"tags":["Provider ingest"],"summary":"Anthropic Admin credential status","description":"Reports whether an Anthropic Admin API credential is configured. Never returns the key itself — only a hint and its validation state.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Credential status","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"configured":{"type":"boolean"},"hint":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"last_validated_at":{"type":"string","nullable":true}},"required":["configured","hint","status","last_validated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"put":{"tags":["Provider ingest"],"summary":"Set the Anthropic Admin credential","description":"Stores an Anthropic Admin API key for this workspace, encrypted. Replacing an existing key rotates it. The key is never returned by any endpoint.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"admin_api_key":{"type":"string","minLength":1,"maxLength":500}},"required":["admin_api_key"]}}}},"responses":{"200":{"description":"Credential stored","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"configured":{"type":"boolean"},"hint":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"last_validated_at":{"type":"string","nullable":true}},"required":["configured","hint","status","last_validated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Provider ingest"],"summary":"Remove the Anthropic Admin credential","description":"Deletes the stored Anthropic Admin API key. The scheduled pull stops for this workspace; attributions already recorded are untouched.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"204":{"description":"Credential removed"}}}},"/v1/workspaces/{workspace_id}/skills":{"get":{"tags":["Skills"],"operationId":"list","summary":"List skills","description":"Returns a paginated list of skills in the workspace library.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["draft","in_review","approved","archived"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["workspace","builtin"],"description":"Filter by owner. Omit for both."},"required":false,"description":"Filter by owner. Omit for both.","name":"source","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string"},"required":false,"name":"slug","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"include_archived","in":"query"}],"responses":{"200":{"description":"Paginated list of skills","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Skills"],"operationId":"create","summary":"Create a skill","description":"Creates a new skill in the workspace library (status: draft).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","maxLength":2000},"category":{"type":"string","maxLength":100},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["slug","name"]}}}},"responses":{"201":{"description":"Skill created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}":{"get":{"tags":["Skills"],"operationId":"get","summary":"Get a skill","description":"Returns a single skill by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"responses":{"200":{"description":"Skill found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Skills"],"operationId":"update","summary":"Update a skill","description":"Updates a skill's metadata or moves it between draft, in_review, and archived. Approval goes through POST /approve.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","nullable":true,"maxLength":2000},"category":{"type":"string","nullable":true,"maxLength":100},"status":{"type":"string","enum":["draft","in_review","archived"]},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Skill updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Skills"],"operationId":"delete","summary":"Delete a skill","description":"Soft-deletes a skill. Usage telemetry is preserved under the skill's slug.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"responses":{"200":{"description":"Skill deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/approve":{"post":{"tags":["Skills"],"operationId":"approve","summary":"Approve a skill","description":"Approves a skill into the governed library and writes an immutable record to its approval ledger. Requires a published version; only owners and admins can approve, and only with session authentication — an API key cannot canonize a skill. Optionally accepts a JSON body of { note } recording the reviewer's rationale.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"responses":{"200":{"description":"Skill approved","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill ID (skl_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","in_review","approved","archived"]},"source":{"type":"string","enum":["workspace","builtin"],"description":"Who owns the content. `builtin` skills ship with the product."},"current_version_id":{"type":"string","nullable":true,"description":"Published version ID (sklv_)"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"archived_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","slug","name","description","category","status","source","current_version_id","created_by","metadata","archived_at","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/approvals":{"get":{"tags":["Skills"],"operationId":"listApprovals","summary":"List a skill's approvals","description":"Returns the append-only approval ledger for a skill — who canonized it, when, against which version, and with what note. Records are never edited; a superseding decision writes a new row.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"responses":{"200":{"description":"Approval ledger","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"skill_id":{"type":"string"},"skill_slug":{"type":"string"},"version_id":{"type":"string","nullable":true},"approved_by":{"type":"string","nullable":true},"note":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"}},"required":["id","skill_id","skill_slug","version_id","approved_by","note","created_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/versions":{"get":{"tags":["Skills"],"operationId":"listVersions","summary":"List skill versions","description":"Returns a paginated list of versions for a skill, newest first.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Paginated list of versions","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Skill version ID (sklv_)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"content":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}},"frontmatter":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"changelog":{"type":"string","nullable":true},"created_by":{"type":"string"},"published_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","version","content","files","frontmatter","changelog","created_by","published_at","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Skills"],"operationId":"createVersion","summary":"Create a skill version","description":"Creates a new draft version of a skill with the full SKILL.md content.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"content":{"type":"string","minLength":1,"description":"SKILL.md content — the bundle's entry document"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9._-]+(\\/[A-Za-z0-9._-]+)*$","description":"Bundle-relative path, e.g. sections/deep-dive.md"},"content":{"type":"string","maxLength":500000}},"required":["path","content"]},"maxItems":50,"description":"Supporting bundle files (sections, templates, doctrine, scripts)"},"frontmatter":{"type":"object","additionalProperties":{"nullable":true}},"changelog":{"type":"string","maxLength":4000}},"required":["version","content"]}}}},"responses":{"201":{"description":"Version created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill version ID (sklv_)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"content":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}},"frontmatter":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"changelog":{"type":"string","nullable":true},"created_by":{"type":"string"},"published_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","version","content","files","frontmatter","changelog","created_by","published_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/current-version":{"get":{"tags":["Skills"],"operationId":"getCurrentVersion","summary":"Get the current published version","description":"Returns the currently published version of a skill, including its full SKILL.md content. This is the distribution payload.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"}],"responses":{"200":{"description":"Current published version","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill version ID (sklv_)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"content":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}},"frontmatter":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"changelog":{"type":"string","nullable":true},"created_by":{"type":"string"},"published_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","version","content","files","frontmatter","changelog","created_by","published_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/versions/{version_id}":{"get":{"tags":["Skills"],"operationId":"getVersion","summary":"Get a skill version","description":"Returns a single skill version by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"},{"schema":{"type":"string","description":"Skill version ID"},"required":true,"description":"Skill version ID","name":"version_id","in":"path"}],"responses":{"200":{"description":"Version found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill version ID (sklv_)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"content":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}},"frontmatter":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"changelog":{"type":"string","nullable":true},"created_by":{"type":"string"},"published_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","version","content","files","frontmatter","changelog","created_by","published_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/{skill_id}/versions/{version_id}/publish":{"post":{"tags":["Skills"],"operationId":"publishVersion","summary":"Publish a skill version","description":"Publishes a version and makes it the skill's current version.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Skill ID"},"required":true,"description":"Skill ID","name":"skill_id","in":"path"},{"schema":{"type":"string","description":"Skill version ID"},"required":true,"description":"Skill version ID","name":"version_id","in":"path"}],"responses":{"200":{"description":"Version published","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill version ID (sklv_)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string"},"version":{"type":"string"},"content":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}},"frontmatter":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"changelog":{"type":"string","nullable":true},"created_by":{"type":"string"},"published_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","version","content","files","frontmatter","changelog","created_by","published_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skills/import":{"post":{"tags":["Skills"],"operationId":"import","summary":"Import skills in bulk","description":"Ingests skill bundles (e.g. an existing library): each is created as a draft with its version published. Existing slugs are skipped, not overwritten.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"skills":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","maxLength":2000},"category":{"type":"string","maxLength":100},"version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$","default":"1.0.0"},"content":{"type":"string","minLength":1},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9._-]+(\\/[A-Za-z0-9._-]+)*$","description":"Bundle-relative path, e.g. sections/deep-dive.md"},"content":{"type":"string","maxLength":500000}},"required":["path","content"]},"maxItems":50},"frontmatter":{"type":"object","additionalProperties":{"nullable":true}},"changelog":{"type":"string","maxLength":4000}},"required":["slug","name","content"]},"minItems":1,"maxItems":100}},"required":["skills"]}}}},"responses":{"200":{"description":"Import result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"imported":{"type":"array","items":{"type":"string"},"description":"Slugs created and published"},"skipped":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"reason":{"type":"string"}},"required":["slug","reason"]}}},"required":["imported","skipped"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-events":{"post":{"tags":["Skill Events"],"operationId":"create","summary":"Record a skill usage event","description":"Records one skill invocation. Unknown slugs are accepted and recorded — unregistered usage is the shadow-library signal.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"skill_slug":{"type":"string","minLength":1,"maxLength":100},"version":{"type":"string","maxLength":50},"source":{"type":"string","enum":["mcp","cli_hook","host_push","api"],"default":"api"},"surface":{"type":"string","maxLength":100},"outcome":{"type":"string","enum":["completed","error","unknown"],"default":"unknown"},"duration_ms":{"type":"integer","minimum":0},"idempotency_key":{"type":"string","minLength":1,"maxLength":255},"occurred_at":{"type":"string","format":"date-time"},"agent_session_id":{"type":"string"},"conversation_id":{"type":"string","maxLength":255},"message_id":{"type":"string","maxLength":255},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["skill_slug"]}}}},"responses":{"201":{"description":"Event recorded","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Skill event ID (uuid)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string","nullable":true},"skill_slug":{"type":"string"},"version":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true},"agent_session_id":{"type":"string","nullable":true},"conversation_id":{"type":"string","nullable":true},"message_id":{"type":"string","nullable":true},"source":{"type":"string","enum":["mcp","cli_hook","host_push","api"]},"surface":{"type":"string","nullable":true},"outcome":{"type":"string","enum":["completed","error","unknown"]},"duration_ms":{"type":"number","nullable":true},"idempotency_key":{"type":"string","nullable":true},"occurred_at":{"type":"string","format":"date-time"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","skill_slug","version","user_id","agent_session_id","conversation_id","message_id","source","surface","outcome","duration_ms","idempotency_key","occurred_at","metadata","created_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"get":{"tags":["Skill Events"],"operationId":"list","summary":"List skill usage events","description":"Returns a paginated list of skill usage events, newest first.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"skill_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"skill_slug","in":"query"},{"schema":{"type":"string","enum":["completed","error","unknown"]},"required":false,"name":"outcome","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"until","in":"query"}],"responses":{"200":{"description":"Paginated list of events","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Skill event ID (uuid)"},"workspace_id":{"type":"string"},"skill_id":{"type":"string","nullable":true},"skill_slug":{"type":"string"},"version":{"type":"string","nullable":true},"user_id":{"type":"string","nullable":true},"agent_session_id":{"type":"string","nullable":true},"conversation_id":{"type":"string","nullable":true},"message_id":{"type":"string","nullable":true},"source":{"type":"string","enum":["mcp","cli_hook","host_push","api"]},"surface":{"type":"string","nullable":true},"outcome":{"type":"string","enum":["completed","error","unknown"]},"duration_ms":{"type":"number","nullable":true},"idempotency_key":{"type":"string","nullable":true},"occurred_at":{"type":"string","format":"date-time"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","skill_id","skill_slug","version","user_id","agent_session_id","conversation_id","message_id","source","surface","outcome","duration_ms","idempotency_key","occurred_at","metadata","created_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-events/stats":{"get":{"tags":["Skill Events"],"operationId":"getStats","summary":"Get skill usage stats","description":"Returns per-skill usage aggregates (events, errors, last used, average duration) for a time window.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"until","in":"query"}],"responses":{"200":{"description":"Skill usage stats","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total_events":{"type":"number"},"since":{"type":"string","nullable":true,"format":"date-time"},"until":{"type":"string","nullable":true,"format":"date-time"},"skills":{"type":"array","items":{"type":"object","properties":{"skill_id":{"type":"string","nullable":true},"skill_slug":{"type":"string"},"events":{"type":"number"},"errors":{"type":"number"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"avg_duration_ms":{"type":"number","nullable":true}},"required":["skill_id","skill_slug","events","errors","last_used_at","avg_duration_ms"]}}},"required":["total_events","since","until","skills"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-events/economics":{"get":{"tags":["Skill Events"],"operationId":"getEconomics","summary":"Get skill economics","description":"Joins skill telemetry to the ai_attributions ledger to return per-skill cost, tokens, deliverables and hours for a time window, plus a skilled-vs-unskilled cost-per-deliverable baseline. Includes a correlation rate so callers can qualify coverage.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"until","in":"query"}],"responses":{"200":{"description":"Skill economics","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"window":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"]},"coverage":{"type":"object","properties":{"events":{"type":"number"},"correlated_events":{"type":"number"},"correlation_rate":{"type":"number"}},"required":["events","correlated_events","correlation_rate"]},"skills":{"type":"array","items":{"type":"object","properties":{"skill_id":{"type":"string","nullable":true},"skill_slug":{"type":"string"},"events":{"type":"number"},"correlated_events":{"type":"number"},"conversations":{"type":"number"},"cost_usd":{"type":"string"},"tokens":{"type":"number"},"deliverables":{"type":"number"},"hours":{"type":"string"},"billable_value_cents":{"type":"string"},"cost_value_cents":{"type":"string"}},"required":["skill_id","skill_slug","events","correlated_events","conversations","cost_usd","tokens","deliverables","hours","billable_value_cents","cost_value_cents"]}},"baseline":{"type":"object","properties":{"skilled_cost_usd":{"type":"string"},"skilled_deliverables":{"type":"number"},"skilled_attributions":{"type":"number"},"unskilled_cost_usd":{"type":"string"},"unskilled_deliverables":{"type":"number"},"unskilled_attributions":{"type":"number"},"skilled_cost_per_deliverable":{"type":"string","nullable":true},"unskilled_cost_per_deliverable":{"type":"string","nullable":true},"ratio":{"type":"number","nullable":true}},"required":["skilled_cost_usd","skilled_deliverables","skilled_attributions","unskilled_cost_usd","unskilled_deliverables","unskilled_attributions","skilled_cost_per_deliverable","unskilled_cost_per_deliverable","ratio"]}},"required":["window","coverage","skills","baseline"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-events/stewardship":{"get":{"tags":["Skill Events"],"operationId":"getStewardship","summary":"Get library stewardship signals","description":"Returns library health signals: skills whose error rate has jumped materially against the preceding window (gated on a minimum event count so low-volume noise does not fire), approved skills nothing has used inside the staleness threshold, and slugs the team ran that the library has never heard of.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Stewardship signals","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"window":{"type":"object","properties":{"days":{"type":"number"},"min_events":{"type":"number"},"stale_after_days":{"type":"number"}},"required":["days","min_events","stale_after_days"]},"drifting":{"type":"array","items":{"type":"object","properties":{"skill_id":{"type":"string","nullable":true},"skill_slug":{"type":"string"},"events":{"type":"number"},"current_error_rate":{"type":"number"},"previous_error_rate":{"type":"number"},"delta":{"type":"number"}},"required":["skill_id","skill_slug","events","current_error_rate","previous_error_rate","delta"]}},"dead":{"type":"array","items":{"type":"object","properties":{"skill_id":{"type":"string"},"skill_slug":{"type":"string"},"name":{"type":"string"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"},"days_since_used":{"type":"number","nullable":true}},"required":["skill_id","skill_slug","name","last_used_at","days_since_used"]}},"shadow":{"type":"array","items":{"type":"object","properties":{"skill_slug":{"type":"string"},"events":{"type":"number"},"last_used_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["skill_slug","events","last_used_at"]}}},"required":["window","drifting","dead","shadow"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-references":{"get":{"tags":["Skill References"],"operationId":"list","summary":"List references","description":"Returns the ground-truth reference library, with per-reference usage counts.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"required":false,"name":"kind","in":"query"},{"schema":{"type":"string"},"required":false,"name":"slug","in":"query"}],"responses":{"200":{"description":"Paginated list of references","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Reference ID (ref_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string"},"source_url":{"type":"string","nullable":true},"used_by_count":{"type":"number","description":"Number of skills grounding on this reference"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","slug","name","kind","content","source_url","used_by_count","created_by","metadata","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Skill References"],"operationId":"create","summary":"Create a reference","description":"Adds a distilled, governed reference to the library.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"],"default":"reference"},"content":{"type":"string","minLength":1,"maxLength":500000},"source_url":{"type":"string","format":"uri"},"metadata":{"type":"object","additionalProperties":{"nullable":true}}},"required":["slug","name","content"]}}}},"responses":{"201":{"description":"Reference created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Reference ID (ref_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string"},"source_url":{"type":"string","nullable":true},"used_by_count":{"type":"number","description":"Number of skills grounding on this reference"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","slug","name","kind","content","source_url","used_by_count","created_by","metadata","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/skill-references/{reference_id}":{"get":{"tags":["Skill References"],"operationId":"get","summary":"Get a reference","description":"Returns a single reference by ID, including its full content.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Reference ID"},"required":true,"description":"Reference ID","name":"reference_id","in":"path"}],"responses":{"200":{"description":"Reference found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Reference ID (ref_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string"},"source_url":{"type":"string","nullable":true},"used_by_count":{"type":"number","description":"Number of skills grounding on this reference"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","slug","name","kind","content","source_url","used_by_count","created_by","metadata","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Skill References"],"operationId":"update","summary":"Update a reference","description":"Updates a reference's content or metadata.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Reference ID"},"required":true,"description":"Reference ID","name":"reference_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string","minLength":1,"maxLength":500000},"source_url":{"type":"string","nullable":true,"format":"uri"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}}}}}}},"responses":{"200":{"description":"Reference updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Reference ID (ref_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string"},"source_url":{"type":"string","nullable":true},"used_by_count":{"type":"number","description":"Number of skills grounding on this reference"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","slug","name","kind","content","source_url","used_by_count","created_by","metadata","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Skill References"],"operationId":"delete","summary":"Delete a reference","description":"Soft-deletes a reference. Skills that grounded on it keep their frontmatter slugs.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Reference ID"},"required":true,"description":"Reference ID","name":"reference_id","in":"path"}],"responses":{"200":{"description":"Reference deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Reference ID (ref_)"},"workspace_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["methodology","policy","reference","examples","rubric_source"]},"content":{"type":"string"},"source_url":{"type":"string","nullable":true},"used_by_count":{"type":"number","description":"Number of skills grounding on this reference"},"created_by":{"type":"string"},"metadata":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","slug","name","kind","content","source_url","used_by_count","created_by","metadata","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invitations":{"get":{"tags":["Invitations"],"operationId":"list","summary":"List invitations","description":"Returns a paginated list of workspace invitations.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["pending","accepted","expired","revoked"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of invitations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Invitations"],"operationId":"create","summary":"Create an invitation","description":"Creates a workspace invitation for an email address. By default an invitation email is sent; pass send_email=false to skip the email and deliver the returned accept_url/token yourself. Callable with both session credentials and API keys (scope: invitations:write).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["admin","manager","member","viewer"],"default":"member"},"project_assignments":{"type":"array","items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"send_email":{"type":"boolean","default":true,"description":"If false, no invitation email is sent — the caller must deliver the accept URL/token themselves."}},"required":["email"]}}}},"responses":{"201":{"description":"Invitation created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"accept_url":{"type":"string","format":"uri","description":"Full URL the invitee can visit to accept the invitation. Always returned on create."},"token":{"type":"string","description":"Raw invitation token. Always returned on create — caller may need it for custom delivery flows."}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at","accept_url","token"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invitations/imported":{"post":{"tags":["Invitations"],"operationId":"inviteImportedMembers","summary":"Invite imported members","description":"Creates invitations for eligible imported workspace members. Recipients are processed sequentially and the response contains aggregate counts only.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Imported members processed","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"invited_count":{"type":"integer","minimum":0},"skipped_count":{"type":"integer","minimum":0},"failed_count":{"type":"integer","minimum":0}},"required":["invited_count","skipped_count","failed_count"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invitations/{invitation_id}":{"delete":{"tags":["Invitations"],"operationId":"revoke","summary":"Revoke an invitation","description":"Revokes a pending invitation.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invitation ID"},"required":true,"description":"Invitation ID","name":"invitation_id","in":"path"}],"responses":{"200":{"description":"Invitation revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invitations/{invitation_id}/resend":{"post":{"tags":["Invitations"],"operationId":"resend","summary":"Resend an invitation","description":"Rotates the invitation token and (by default) re-sends the email. The response includes the new accept_url and token.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invitation ID"},"required":true,"description":"Invitation ID","name":"invitation_id","in":"path"}],"responses":{"200":{"description":"Invitation resent","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"accept_url":{"type":"string","format":"uri","description":"Full URL the invitee can visit to accept the invitation. Always returned on create."},"token":{"type":"string","description":"Raw invitation token. Always returned on create — caller may need it for custom delivery flows."}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at","accept_url","token"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/members":{"get":{"tags":["Members"],"operationId":"list","summary":"List members","description":"Returns a paginated list of workspace members.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Paginated list of members","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"role":{"type":"string"},"hourly_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"tag_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["user_id","workspace_id","name","email","avatar_url","role","hourly_rate","cost_rate","currency","tag_ids","joined_at","updated_at","deleted","deleted_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Members"],"operationId":"create","summary":"Add a member","description":"Adds a user as a member of the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","minLength":1},"role":{"type":"string","enum":["admin","manager","member","viewer"],"default":"member"}},"required":["user_id"]}}}},"responses":{"201":{"description":"Member added","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"role":{"type":"string"},"hourly_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"tag_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["user_id","workspace_id","name","email","avatar_url","role","hourly_rate","cost_rate","currency","tag_ids","joined_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/members/me":{"get":{"tags":["Members"],"operationId":"getMe","summary":"Get current member","description":"Returns the caller's own membership in the workspace. Available to session and OAuth-token principals — both identify a real person. API keys have no user behind them and receive 403.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Current member info","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"name":{"type":"string","nullable":true},"role":{"type":"string"},"manager_scope":{"anyOf":[{"type":"object","properties":{"global":{"type":"boolean","enum":[true]}},"required":["global"]},{"type":"object","properties":{"client_ids":{"type":"array","items":{"type":"string"}},"project_ids":{"type":"array","items":{"type":"string"}}},"required":["client_ids","project_ids"]},{"nullable":true}],"description":"Resolved manager scope: { global: true } for owners/admins/api-keys; { client_ids, project_ids } for scoped managers (prefixed IDs); null for members/viewers/managers-without-grants."}},"required":["user_id","name","role","manager_scope"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/members/{user_id}":{"get":{"tags":["Members"],"operationId":"get","summary":"Get a member","description":"Returns a single workspace member by user ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"responses":{"200":{"description":"Member found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"role":{"type":"string"},"hourly_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"tag_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["user_id","workspace_id","name","email","avatar_url","role","hourly_rate","cost_rate","currency","tag_ids","joined_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Members"],"operationId":"update","summary":"Update a member","description":"Updates a workspace member's name, role, or rate. The name is stored on the shared user record, so it applies across every workspace the user belongs to.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","nullable":true,"maxLength":255,"description":"Display name for the user. Writes to the shared user record, so the change is visible in every workspace the user belongs to."},"role":{"type":"string","enum":["owner","admin","manager","member","viewer"]},"hourly_rate":{"type":"integer","nullable":true,"minimum":0},"cost_rate":{"type":"integer","nullable":true,"minimum":0},"currency":{"type":"string","nullable":true,"minLength":3,"maxLength":3},"effective_from":{"type":"string","nullable":true,"format":"date"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}}}}}},"responses":{"200":{"description":"Member updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"role":{"type":"string"},"hourly_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true},"tag_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["user_id","workspace_id","name","email","avatar_url","role","hourly_rate","cost_rate","currency","tag_ids","joined_at","updated_at","deleted","deleted_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Members"],"operationId":"delete","summary":"Remove a member","description":"Removes a user from the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"responses":{"204":{"description":"Member removed"}}}},"/v1/workspaces/{workspace_id}/members/{user_id}/tags":{"post":{"tags":["Members"],"operationId":"attachTag","summary":"Attach a tag to a member","description":"Associates a tag with a workspace member.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag_id":{"type":"string","minLength":1}},"required":["tag_id"]}}}},"responses":{"201":{"description":"Tag attached","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"tag_id":{"type":"string"}},"required":["user_id","tag_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/members/{user_id}/tags/{tag_id}":{"delete":{"tags":["Members"],"operationId":"detachTag","summary":"Detach a tag from a member","description":"Removes a tag association from a workspace member.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"},{"schema":{"type":"string","description":"Tag ID"},"required":true,"description":"Tag ID","name":"tag_id","in":"path"}],"responses":{"200":{"description":"Tag detached","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"tag_id":{"type":"string"}},"required":["user_id","tag_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/report-schedules":{"get":{"tags":["Report Schedules"],"operationId":"list","summary":"List report schedules","description":"Returns the recurring client-report deliveries configured in this workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"client_id","in":"query"},{"schema":{"type":"string","enum":["true","false"]},"required":false,"name":"active","in":"query"}],"responses":{"200":{"description":"Report schedules","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Schedule ID (rsc_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","description":"Client ID (cli_)"},"frequency":{"type":"string","enum":["weekly","monthly"]},"day_of_month":{"type":"integer","nullable":true},"recipient_email":{"type":"string"},"sections":{"type":"object","additionalProperties":{"type":"boolean"}},"visibility":{"type":"object","additionalProperties":{"type":"boolean"}},"active":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","error"]},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","client_id","frequency","day_of_month","recipient_email","sections","visibility","active","status","last_sent_at","created_at","updated_at"]}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"post":{"tags":["Report Schedules"],"operationId":"create","summary":"Create a report schedule","description":"Schedules a recurring client report. Weekly deliveries go out on Monday; monthly ones on the given day of the month.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","minLength":1},"frequency":{"type":"string","enum":["weekly","monthly"],"default":"monthly"},"day_of_month":{"type":"integer","minimum":1,"maximum":28},"recipient_email":{"type":"string","format":"email"},"sections":{"type":"object","properties":{"cover":{"type":"boolean","default":true},"summary":{"type":"boolean","default":true},"projects":{"type":"boolean","default":true},"time_log":{"type":"boolean","default":false}}},"visibility":{"type":"object","properties":{"show_billable_amounts":{"type":"boolean","default":true},"show_hourly_rates":{"type":"boolean","default":false},"show_team_members":{"type":"boolean","default":false},"show_descriptions":{"type":"boolean","default":true}}},"active":{"type":"boolean","default":true}},"required":["client_id","recipient_email"]}}}},"responses":{"201":{"description":"Created report schedule","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Schedule ID (rsc_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","description":"Client ID (cli_)"},"frequency":{"type":"string","enum":["weekly","monthly"]},"day_of_month":{"type":"integer","nullable":true},"recipient_email":{"type":"string"},"sections":{"type":"object","additionalProperties":{"type":"boolean"}},"visibility":{"type":"object","additionalProperties":{"type":"boolean"}},"active":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","error"]},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","client_id","frequency","day_of_month","recipient_email","sections","visibility","active","status","last_sent_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Client not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/report-schedules/{schedule_id}":{"get":{"tags":["Report Schedules"],"operationId":"get","summary":"Get a report schedule","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report schedule ID (rsc_)"},"required":true,"description":"Report schedule ID (rsc_)","name":"schedule_id","in":"path"}],"responses":{"200":{"description":"Report schedule","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Schedule ID (rsc_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","description":"Client ID (cli_)"},"frequency":{"type":"string","enum":["weekly","monthly"]},"day_of_month":{"type":"integer","nullable":true},"recipient_email":{"type":"string"},"sections":{"type":"object","additionalProperties":{"type":"boolean"}},"visibility":{"type":"object","additionalProperties":{"type":"boolean"}},"active":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","error"]},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","client_id","frequency","day_of_month","recipient_email","sections","visibility","active","status","last_sent_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Report schedule not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}},"patch":{"tags":["Report Schedules"],"operationId":"update","summary":"Update a report schedule","description":"Pause, resume, retarget or retime a schedule. Setting status back to active retries one the dispatcher parked on error.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report schedule ID (rsc_)"},"required":true,"description":"Report schedule ID (rsc_)","name":"schedule_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"frequency":{"type":"string","enum":["weekly","monthly"]},"day_of_month":{"type":"integer","nullable":true,"minimum":1,"maximum":28},"recipient_email":{"type":"string","format":"email"},"sections":{"type":"object","properties":{"cover":{"type":"boolean","default":true},"summary":{"type":"boolean","default":true},"projects":{"type":"boolean","default":true},"time_log":{"type":"boolean","default":false}}},"visibility":{"type":"object","properties":{"show_billable_amounts":{"type":"boolean","default":true},"show_hourly_rates":{"type":"boolean","default":false},"show_team_members":{"type":"boolean","default":false},"show_descriptions":{"type":"boolean","default":true}}},"active":{"type":"boolean"},"status":{"type":"string","enum":["active","paused"]}}}}}},"responses":{"200":{"description":"Updated report schedule","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Schedule ID (rsc_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"client_id":{"type":"string","description":"Client ID (cli_)"},"frequency":{"type":"string","enum":["weekly","monthly"]},"day_of_month":{"type":"integer","nullable":true},"recipient_email":{"type":"string"},"sections":{"type":"object","additionalProperties":{"type":"boolean"}},"visibility":{"type":"object","additionalProperties":{"type":"boolean"}},"active":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","error"]},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","client_id","frequency","day_of_month","recipient_email","sections","visibility","active","status","last_sent_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Report schedule not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}},"delete":{"tags":["Report Schedules"],"operationId":"delete","summary":"Delete a report schedule","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report schedule ID (rsc_)"},"required":true,"description":"Report schedule ID (rsc_)","name":"schedule_id","in":"path"}],"responses":{"204":{"description":"Report schedule deleted"},"404":{"description":"Report schedule not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices":{"get":{"tags":["Invoices"],"operationId":"list","summary":"List invoices","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"client_id","in":"query"},{"schema":{"type":"string","enum":["draft","issued","paid","void"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["invoice","credit_note"]},"required":false,"name":"document_type","in":"query"}],"responses":{"200":{"description":"Paginated invoices","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Invoices"],"operationId":"generate","summary":"Generate a draft invoice from tracked time","description":"Creates a draft and claims its time entries. Entries already on a live invoice are excluded; a concurrent claim returns 409.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","minLength":1},"period":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"group_lines_by":{"type":"string","enum":["project","project_member"],"default":"project_member"},"due_in_days":{"type":"integer","minimum":0,"maximum":365},"tax_rate_bps":{"type":"integer","minimum":0,"maximum":10000},"tax_label":{"type":"string","maxLength":64},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"notes":{"type":"string","maxLength":4000},"purchase_order":{"type":"string","maxLength":128}},"required":["client_id","period"]}}}},"responses":{"201":{"description":"Draft invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"409":{"description":"Some of this time is already invoiced","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/preview":{"post":{"tags":["Invoices"],"operationId":"preview","summary":"Preview what an invoice would contain","description":"Dry run. Reports billable totals plus the counts that explain them — time already on another invoice, time awaiting approval, and time with no rate anywhere in the cascade.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","minLength":1},"period":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"group_lines_by":{"type":"string","enum":["project","project_member"],"default":"project_member"}},"required":["client_id","period"]}}}},"responses":{"200":{"description":"Preview","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"currency":{"type":"string"},"billable_seconds":{"type":"number"},"billable_amount_cents":{"type":"number"},"entry_count":{"type":"number"},"already_invoiced_seconds":{"type":"number"},"already_invoiced_entry_count":{"type":"number"},"pending_approval_entry_count":{"type":"number"},"unrated_entry_count":{"type":"number"}},"required":["currency","billable_seconds","billable_amount_cents","entry_count","already_invoiced_seconds","already_invoiced_entry_count","pending_approval_entry_count","unrated_entry_count"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}":{"get":{"tags":["Invoices"],"operationId":"get","summary":"Get an invoice with its lines","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}},"patch":{"tags":["Invoices"],"operationId":"update","summary":"Update a draft invoice","description":"Drafts only. Issued documents are immutable.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"due_date":{"type":"string","format":"date"},"issue_date":{"type":"string","format":"date"},"fulfilment_date":{"type":"string","format":"date"},"tax_rate_bps":{"type":"integer","minimum":0,"maximum":10000},"tax_label":{"type":"string","nullable":true,"maxLength":64},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"notes":{"type":"string","nullable":true,"maxLength":4000},"purchase_order":{"type":"string","nullable":true,"maxLength":128}}}}}},"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}},"delete":{"tags":["Invoices"],"operationId":"delete","summary":"Delete a draft invoice","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"responses":{"204":{"description":"Deleted"},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/lines":{"post":{"tags":["Invoices"],"operationId":"addLine","summary":"Add a line to a draft","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"],"default":"manual"},"description":{"type":"string","minLength":1,"maxLength":500},"quantity_seconds":{"type":"integer","nullable":true,"minimum":0},"unit_rate_cents":{"type":"integer","nullable":true},"amount_cents":{"type":"integer"},"sort_order":{"type":"integer","minimum":0}},"required":["description","amount_cents"]}}}},"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/lines/{line_id}":{"delete":{"tags":["Invoices"],"operationId":"deleteLine","summary":"Remove a line from a draft","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"},{"schema":{"type":"string","description":"Line ID (invl_)"},"required":true,"description":"Line ID (invl_)","name":"line_id","in":"path"}],"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/issue":{"post":{"tags":["Invoices"],"operationId":"issue","summary":"Issue a draft invoice","description":"Mints the number and freezes the lines. Irreversible — corrections after this point are credit notes.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"issue_date":{"type":"string","format":"date"},"due_date":{"type":"string","format":"date"}}}}}},"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/void":{"post":{"tags":["Invoices"],"operationId":"void","summary":"Void an issued invoice","description":"Keeps the number and releases its time entries to be invoiced again.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/payments":{"post":{"tags":["Invoices"],"operationId":"recordPayment","summary":"Record a payment","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_cents":{"type":"integer","minimum":1},"paid_at":{"type":"string","format":"date-time"}},"required":["amount_cents"]}}}},"responses":{"200":{"description":"Invoice","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/credit-notes":{"post":{"tags":["Invoices"],"operationId":"createCreditNote","summary":"Raise a credit note against an invoice","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount_cents":{"type":"integer","minimum":1},"reason":{"type":"string","maxLength":500}}}}}},"responses":{"201":{"description":"Credit note","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"client_id":{"type":"string"},"document_type":{"type":"string","enum":["invoice","credit_note"]},"credits_invoice_id":{"type":"string","nullable":true},"number":{"type":"string","nullable":true},"series":{"type":"string"},"status":{"type":"string","enum":["draft","issued","paid","void"]},"overdue":{"type":"boolean"},"currency":{"type":"string"},"issue_date":{"type":"string","nullable":true},"due_date":{"type":"string","nullable":true},"fulfilment_date":{"type":"string","nullable":true},"period_start":{"type":"string"},"period_end":{"type":"string"},"subtotal_cents":{"type":"number"},"tax_rate_bps":{"type":"number"},"tax_label":{"type":"string","nullable":true},"tax_codes":{"type":"object","properties":{"xero":{"type":"string","maxLength":64},"quickbooks":{"type":"string","maxLength":64}}},"tax_cents":{"type":"number"},"total_cents":{"type":"number"},"amount_paid_cents":{"type":"number"},"balance_cents":{"type":"number"},"notes":{"type":"string","nullable":true},"purchase_order":{"type":"string","nullable":true},"pdf_blob_url":{"type":"string","nullable":true},"external_number":{"type":"string","nullable":true},"issued_at":{"type":"string","nullable":true},"paid_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["time","ai_compute","adjustment","manual"]},"description":{"type":"string"},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"quantity_seconds":{"type":"number","nullable":true},"unit_rate_cents":{"type":"number","nullable":true},"amount_cents":{"type":"number"},"ai_multiplier_factor_bps":{"type":"number","nullable":true},"sort_order":{"type":"number"}},"required":["id","kind","description","project_id","project_name","member_name","quantity_seconds","unit_rate_cents","amount_cents","ai_multiplier_factor_bps","sort_order"]}}},"required":["id","workspace_id","client_id","document_type","credits_invoice_id","number","series","status","overdue","currency","issue_date","due_date","fulfilment_date","period_start","period_end","subtotal_cents","tax_rate_bps","tax_label","tax_codes","tax_cents","total_cents","amount_paid_cents","balance_cents","notes","purchase_order","pdf_blob_url","external_number","issued_at","paid_at","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/pdf":{"get":{"tags":["Invoices"],"operationId":"pdf","summary":"Render an invoice as PDF","description":"In delegated compliance mode this is an internal preview, watermarked as not a tax invoice — the issued document comes from the provider.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"responses":{"200":{"description":"PDF file"},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/payment-link":{"post":{"tags":["Invoices"],"operationId":"createPaymentLink","summary":"Create a Stripe payment link for an invoice","description":"Creates the link on the workspace's own connected Stripe account. Money moves client to agency directly; WhoWorked never holds funds.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"}],"responses":{"200":{"description":"Payment link","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/invoices/{invoice_id}/sync/{provider}":{"post":{"tags":["Invoices"],"operationId":"syncInvoice","summary":"Push an invoice to an accounting provider","description":"Issued documents only. Pushing twice is a no-op — the second call returns the existing external id rather than duplicating the invoice in someone's books.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Invoice ID (inv_)"},"required":true,"description":"Invoice ID (inv_)","name":"invoice_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"]},"required":true,"name":"provider","in":"path"}],"responses":{"200":{"description":"External reference","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"external_id":{"type":"string"}},"required":["external_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Invoice not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Invoice is not in a state that allows this","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/stripe-connect":{"get":{"tags":["Invoices"],"operationId":"getStripeConnection","summary":"Get the workspace's Stripe connection","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Connection state","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"connected":{"type":"boolean"},"account_id":{"type":"string","nullable":true}},"required":["connected","account_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Invoices"],"operationId":"disconnectStripe","summary":"Disconnect the Stripe account","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"204":{"description":"Disconnected"}}}},"/v1/workspaces/{workspace_id}/stripe-connect/authorize-url":{"post":{"tags":["Invoices"],"operationId":"getStripeAuthorizeUrl","summary":"Start connecting a Stripe account","description":"Returns the Stripe OAuth URL. The agency connects their own existing account — WhoWorked never creates one on their behalf.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"return_url":{"type":"string","format":"uri"}},"required":["return_url"]}}}},"responses":{"200":{"description":"Authorize URL","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/stripe-connect/callback":{"post":{"tags":["Invoices"],"operationId":"completeStripeConnect","summary":"Complete the Stripe connection","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1}},"required":["code"]}}}},"responses":{"200":{"description":"Connected","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"account_id":{"type":"string"}},"required":["account_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting":{"get":{"tags":["Invoices"],"operationId":"listAccountingConnections","summary":"List accounting connections","description":"Connection state per provider. Tokens are never returned — they are credentials to someone else's books.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Connections","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","enum":["xero","quickbooks"]},"status":{"type":"string","enum":["connected","expired","revoked"]},"tenant_name":{"type":"string","nullable":true},"last_synced_at":{"type":"string","nullable":true},"last_error":{"type":"string","nullable":true},"settings":{"type":"object","properties":{"income_account_id":{"type":"string"},"line_accounts":{"type":"object","additionalProperties":{"type":"string"}},"tax_codes":{"type":"object","additionalProperties":{"type":"string"}},"currency_mode":{"type":"string","enum":["block","home"]}}}},"required":["provider","status","tenant_name","last_synced_at","last_error","settings"]}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}/authorize-url":{"post":{"tags":["Invoices"],"operationId":"getAccountingAuthorizeUrl","summary":"Start connecting an accounting provider","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"redirect_uri":{"type":"string","format":"uri"}},"required":["redirect_uri"]}}}},"responses":{"200":{"description":"Authorize URL","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}/callback":{"post":{"tags":["Invoices"],"operationId":"completeAccountingConnect","summary":"Complete an accounting connection","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1},"redirect_uri":{"type":"string","format":"uri"}},"required":["code","redirect_uri"]}}}},"responses":{"204":{"description":"Connected"}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}":{"delete":{"tags":["Invoices"],"operationId":"disconnectAccounting","summary":"Disconnect an accounting provider","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"responses":{"204":{"description":"Disconnected"}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}/options":{"get":{"tags":["Invoices"],"operationId":"getAccountingOptions","summary":"List what this connection can be configured with","description":"Reads the agency's own organisations, tax codes and income accounts. A provider returns only what it has, so render whichever lists come back non-empty.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"responses":{"200":{"description":"Available options","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tenants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"tax_rates":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"rate_bps":{"type":"number"}},"required":["code","name","rate_bps"]}},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["tenants","tax_rates","accounts"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"No connection for this provider","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting/tax-options":{"get":{"tags":["Invoices"],"operationId":"listInvoiceTaxOptions","summary":"Tax codes available to put on an invoice","description":"Every connected provider's own tax codes, for the invoice editor to offer while the invoice is still a draft. Choosing here is what lets a taxed invoice sync later. A provider that cannot be reached is omitted rather than failing the request. Unlike the per-provider options this is not admin-only, because whoever drafts the invoice sets the tax.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Tax codes per connected provider","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","enum":["xero","quickbooks"]},"tax_rates":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"rate_bps":{"type":"number"}},"required":["code","name","rate_bps"]}}},"required":["provider","tax_rates"]}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}/settings":{"patch":{"tags":["Invoices"],"operationId":"updateAccountingSettings","summary":"Set revenue accounts, tax-code mapping and currency handling","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"income_account_id":{"type":"string"},"line_accounts":{"type":"object","additionalProperties":{"type":"string"}},"tax_codes":{"type":"object","additionalProperties":{"type":"string"}},"currency_mode":{"type":"string","enum":["block","home"]}}}}}},"responses":{"200":{"description":"Updated settings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"income_account_id":{"type":"string"},"line_accounts":{"type":"object","additionalProperties":{"type":"string"}},"tax_codes":{"type":"object","additionalProperties":{"type":"string"}},"currency_mode":{"type":"string","enum":["block","home"]}}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/accounting/{provider}/tenant":{"post":{"tags":["Invoices"],"operationId":"selectAccountingTenant","summary":"Choose which set of books to sync into","description":"For a provider whose authorisation spans several organisations. Validated against what the connection can actually reach.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["xero","quickbooks"],"description":"Accounting provider"},"required":true,"description":"Accounting provider","name":"provider","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string","minLength":1}},"required":["tenant_id"]}}}},"responses":{"204":{"description":"Selected"}}}},"/v1/workspaces/{workspace_id}/reports/summary":{"post":{"tags":["Reports"],"operationId":"generateSummary","summary":"Generate summary report","description":"Generates a summary report for the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"user_ids":{"type":"array","items":{"type":"string"}},"agent_ids":{"type":"array","items":{"type":"string"}},"tag_ids":{"type":"array","items":{"type":"string"}},"tag_filter_mode":{"type":"string","enum":["any","all","none"]},"task_ids":{"type":"array","items":{"type":"string"}},"member_tag_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"has_project":{"type":"boolean"},"has_client":{"type":"boolean"},"has_task":{"type":"boolean"},"has_tag":{"type":"boolean"},"has_member_tag":{"type":"boolean"},"approval_status":{"type":"array","items":{"type":"string","enum":["none","pending","approved","rejected"]},"minItems":1},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string","minLength":1},"values":{"type":"array","items":{"type":"string"}},"has_value":{"type":"boolean"}},"required":["field_id"]}},"group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"sub_group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"sub_sub_group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"custom_field_group_by":{"type":"object","properties":{"group_by":{"type":"string"},"sub_group_by":{"type":"string"},"sub_sub_group_by":{"type":"string"}}}},"required":["date_range","group_by"]}}}},"responses":{"200":{"description":"Summary report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/detailed":{"post":{"tags":["Reports"],"operationId":"generateDetailed","summary":"Generate detailed report","description":"Generates a detailed entry-level report.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"user_ids":{"type":"array","items":{"type":"string"}},"agent_ids":{"type":"array","items":{"type":"string"}},"tag_ids":{"type":"array","items":{"type":"string"}},"tag_filter_mode":{"type":"string","enum":["any","all","none"]},"task_ids":{"type":"array","items":{"type":"string"}},"member_tag_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"has_project":{"type":"boolean"},"has_client":{"type":"boolean"},"has_task":{"type":"boolean"},"has_tag":{"type":"boolean"},"has_member_tag":{"type":"boolean"},"approval_status":{"type":"array","items":{"type":"string","enum":["none","pending","approved","rejected"]},"minItems":1},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string","minLength":1},"values":{"type":"array","items":{"type":"string"}},"has_value":{"type":"boolean"}},"required":["field_id"]}},"sort_by":{"type":"string","enum":["started_at","stopped_at","duration","created_at"],"default":"started_at"},"sort_order":{"type":"string","enum":["asc","desc"],"default":"desc"},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}},"required":["date_range"]}}}},"responses":{"200":{"description":"Detailed report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"nullable":true}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/team":{"post":{"tags":["Reports"],"operationId":"generateTeam","summary":"Generate team report","description":"Generates a team utilization report.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"include_running":{"type":"boolean","default":false}},"required":["date_range"]}}}},"responses":{"200":{"description":"Team report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/profit":{"post":{"tags":["Reports"],"operationId":"generateProfit","summary":"Generate profit report","description":"Generates a profitability report.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"group_by":{"type":"string","enum":["project","client","member","client_project_member","day","week","month"],"default":"project"},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean","default":true},"include_non_billable":{"type":"boolean"},"include_running":{"type":"boolean","default":false},"bucket":{"type":"string","enum":["week","month"]}},"required":["date_range"]}}}},"responses":{"200":{"description":"Profit report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"group_id":{"type":"string","nullable":true},"group_name":{"type":"string","nullable":true},"total_duration_seconds":{"type":"number"},"revenue_cents":{"type":"number"},"cost_cents":{"type":"number"},"profit_cents":{"type":"number"},"margin_percent":{"type":"number","nullable":true}},"required":["group_id","group_name","total_duration_seconds","revenue_cents","cost_cents","profit_cents","margin_percent"]}},"totals":{"type":"object","properties":{"total_duration_seconds":{"type":"number"},"revenue_cents":{"type":"number"},"cost_cents":{"type":"number"},"profit_cents":{"type":"number"},"margin_percent":{"type":"number","nullable":true}},"required":["total_duration_seconds","revenue_cents","cost_cents","profit_cents","margin_percent"]},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket_start":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"group_id":{"type":"string","nullable":true},"group_name":{"type":"string","nullable":true},"total_duration_seconds":{"type":"number"},"revenue_cents":{"type":"number"},"cost_cents":{"type":"number"},"profit_cents":{"type":"number"},"margin_percent":{"type":"number","nullable":true}},"required":["group_id","group_name","total_duration_seconds","revenue_cents","cost_cents","profit_cents","margin_percent"]}}},"required":["bucket_start","groups"]}},"details":{"type":"array","items":{"type":"object","properties":{"client_id":{"type":"string","nullable":true},"client_name":{"type":"string","nullable":true},"project_id":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true},"member_type":{"type":"string","enum":["user","agent"]},"member_id":{"type":"string","nullable":true},"member_name":{"type":"string","nullable":true},"member_avatar_url":{"type":"string","nullable":true},"effective_billable_rate_cents":{"type":"number","nullable":true},"effective_cost_rate_cents":{"type":"number","nullable":true},"total_duration_seconds":{"type":"number"},"billable_duration_seconds":{"type":"number"},"entry_count":{"type":"number"},"billable_amount_cents":{"type":"number"},"cost_amount_cents":{"type":"number"},"profit_cents":{"type":"number"},"margin_percent":{"type":"number","nullable":true}},"required":["client_id","client_name","project_id","project_name","member_type","member_id","member_name","member_avatar_url","effective_billable_rate_cents","effective_cost_rate_cents","total_duration_seconds","billable_duration_seconds","entry_count","billable_amount_cents","cost_amount_cents","profit_cents","margin_percent"]}}},"required":["groups","totals"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/export":{"post":{"tags":["Reports"],"operationId":"exportCsv","summary":"Export report as CSV or Excel","description":"Exports a detailed report as a CSV or Excel (xlsx) file.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"user_ids":{"type":"array","items":{"type":"string"}},"agent_ids":{"type":"array","items":{"type":"string"}},"tag_ids":{"type":"array","items":{"type":"string"}},"tag_filter_mode":{"type":"string","enum":["any","all","none"]},"task_ids":{"type":"array","items":{"type":"string"}},"member_tag_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"has_project":{"type":"boolean"},"has_client":{"type":"boolean"},"has_task":{"type":"boolean"},"has_tag":{"type":"boolean"},"has_member_tag":{"type":"boolean"},"approval_status":{"type":"array","items":{"type":"string","enum":["none","pending","approved","rejected"]},"minItems":1},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string","minLength":1},"values":{"type":"array","items":{"type":"string"}},"has_value":{"type":"boolean"}},"required":["field_id"]}},"format":{"type":"string","enum":["csv","xlsx"],"default":"csv"},"lock_period_id":{"type":"string"}},"required":["date_range"]}}}},"responses":{"200":{"description":"CSV or Excel file"}}}},"/v1/workspaces/{workspace_id}/reports/pdf":{"post":{"tags":["Reports"],"operationId":"exportPdf","summary":"Export report as PDF","description":"Renders any report type as a PDF document.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"user_ids":{"type":"array","items":{"type":"string"}},"agent_ids":{"type":"array","items":{"type":"string"}},"tag_ids":{"type":"array","items":{"type":"string"}},"tag_filter_mode":{"type":"string","enum":["any","all","none"]},"task_ids":{"type":"array","items":{"type":"string"}},"member_tag_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"has_project":{"type":"boolean"},"has_client":{"type":"boolean"},"has_task":{"type":"boolean"},"has_tag":{"type":"boolean"},"has_member_tag":{"type":"boolean"},"approval_status":{"type":"array","items":{"type":"string","enum":["none","pending","approved","rejected"]},"minItems":1},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string","minLength":1},"values":{"type":"array","items":{"type":"string"}},"has_value":{"type":"boolean"}},"required":["field_id"]}},"type":{"type":"string","enum":["summary","detailed","team","profit"]},"title":{"type":"string","minLength":1,"maxLength":200},"group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"sub_group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"sub_sub_group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month","member_tag","custom_field"]},"custom_field_group_by":{"type":"object","properties":{"group_by":{"type":"string"},"sub_group_by":{"type":"string"},"sub_sub_group_by":{"type":"string"}}}},"required":["date_range","type"]}}}},"responses":{"200":{"description":"PDF file"}}}},"/v1/workspaces/{workspace_id}/reports/saved":{"get":{"tags":["Reports"],"operationId":"listSaved","summary":"List saved reports","description":"Returns a paginated list of saved report configurations.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"updated_since","in":"query"}],"responses":{"200":{"description":"Saved reports","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"nullable":true}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Reports"],"operationId":"createSaved","summary":"Create a saved report","description":"Saves a report configuration for later use.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"type":{"type":"string","enum":["summary","detailed","team","profit"]},"filters":{"type":"object","additionalProperties":{"nullable":true}},"visibility":{"type":"string","enum":["private","workspace"],"default":"private"}},"required":["name","type","filters"]}}}},"responses":{"201":{"description":"Saved report created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/saved/{report_id}":{"get":{"tags":["Reports"],"operationId":"getSaved","summary":"Get a saved report","description":"Returns a single saved report configuration.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"responses":{"200":{"description":"Saved report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"patch":{"tags":["Reports"],"operationId":"updateSaved","summary":"Update a saved report","description":"Updates a saved report configuration.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"filters":{"type":"object","additionalProperties":{"nullable":true}},"visibility":{"type":"string","enum":["private","workspace"]}}}}}},"responses":{"200":{"description":"Saved report updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"delete":{"tags":["Reports"],"operationId":"deleteSaved","summary":"Delete a saved report","description":"Deletes a saved report configuration.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"responses":{"204":{"description":"Saved report deleted"}}}},"/v1/workspaces/{workspace_id}/reports/{report_id}/download":{"get":{"tags":["Reports"],"operationId":"download","summary":"Download report PDF","description":"Downloads a saved client report as PDF.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"responses":{"200":{"description":"PDF file"}}}},"/v1/workspaces/{workspace_id}/reports/saved/{report_id}/share":{"post":{"tags":["Reports"],"operationId":"share","summary":"Share a saved report","description":"Creates a read-only link. Calling it again rotates the token, which invalidates the previous URL.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expires_at":{"type":"string","nullable":true,"format":"date-time"},"show_amounts":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Shared report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}},"delete":{"tags":["Reports"],"operationId":"revokeShare","summary":"Revoke a report share link","description":"Clears the token so the URL stops resolving.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Report ID"},"required":true,"description":"Report ID","name":"report_id","in":"path"}],"responses":{"200":{"description":"Report with sharing cleared","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/ai":{"post":{"tags":["Reports"],"operationId":"generateAiReport","summary":"Generate AI involvement report","description":"Breaks tracked time down by AI involvement level, tool, or review status. Only the `level` grouping partitions the hours — see `hours_are_exclusive` in the response.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}},"required":["start","end"]},"timezone":{"type":"string","maxLength":255},"project_ids":{"type":"array","items":{"type":"string"}},"client_ids":{"type":"array","items":{"type":"string"}},"user_ids":{"type":"array","items":{"type":"string"}},"agent_ids":{"type":"array","items":{"type":"string"}},"tag_ids":{"type":"array","items":{"type":"string"}},"tag_filter_mode":{"type":"string","enum":["any","all","none"]},"task_ids":{"type":"array","items":{"type":"string"}},"member_tag_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"has_project":{"type":"boolean"},"has_client":{"type":"boolean"},"has_task":{"type":"boolean"},"has_tag":{"type":"boolean"},"has_member_tag":{"type":"boolean"},"approval_status":{"type":"array","items":{"type":"string","enum":["none","pending","approved","rejected"]},"minItems":1},"custom_fields":{"type":"array","items":{"type":"object","properties":{"field_id":{"type":"string","minLength":1},"values":{"type":"array","items":{"type":"string"}},"has_value":{"type":"boolean"}},"required":["field_id"]}},"group_by":{"type":"string","enum":["level","tool","review_status"],"default":"level"}},"required":["date_range"]}}}},"responses":{"200":{"description":"AI involvement report","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/assignments":{"get":{"tags":["Project Assignments"],"operationId":"list","summary":"List project assignments","description":"Returns a paginated list of user assignments for a project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Paginated list of assignments","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"project_id":{"type":"string"},"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string","nullable":true},"workspace_role":{"type":"string"},"billable_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"budget_weekly_hours":{"type":"number","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["project_id","user_id","user_name","user_email","workspace_role","billable_rate","cost_rate","budget_weekly_hours","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Project Assignments"],"operationId":"create","summary":"Create a project assignment","description":"Assigns a user to a project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true,"minimum":0},"cost_rate":{"type":"integer","nullable":true,"minimum":0},"budget_weekly_hours":{"type":"integer","nullable":true,"minimum":0},"effective_from":{"type":"string","nullable":true,"format":"date"}},"required":["user_id"]}}}},"responses":{"201":{"description":"Assignment created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"project_id":{"type":"string"},"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string","nullable":true},"workspace_role":{"type":"string"},"billable_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"budget_weekly_hours":{"type":"number","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["project_id","user_id","user_name","user_email","workspace_role","billable_rate","cost_rate","budget_weekly_hours","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/projects/{project_id}/assignments/{user_id}":{"patch":{"tags":["Project Assignments"],"operationId":"update","summary":"Update a project assignment","description":"Updates a user's project assignment (rates, budget).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"billable_rate":{"type":"integer","nullable":true,"minimum":0},"cost_rate":{"type":"integer","nullable":true,"minimum":0},"budget_weekly_hours":{"type":"integer","nullable":true,"minimum":0},"effective_from":{"type":"string","nullable":true,"format":"date"}}}}}},"responses":{"200":{"description":"Assignment updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"project_id":{"type":"string"},"user_id":{"type":"string"},"user_name":{"type":"string","nullable":true},"user_email":{"type":"string","nullable":true},"workspace_role":{"type":"string"},"billable_rate":{"type":"number","nullable":true},"cost_rate":{"type":"number","nullable":true},"budget_weekly_hours":{"type":"number","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["project_id","user_id","user_name","user_email","workspace_role","billable_rate","cost_rate","budget_weekly_hours","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Project Assignments"],"operationId":"delete","summary":"Remove a project assignment","description":"Removes a user's assignment from a project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Project ID"},"required":true,"description":"Project ID","name":"project_id","in":"path"},{"schema":{"type":"string","description":"User ID"},"required":true,"description":"User ID","name":"user_id","in":"path"}],"responses":{"204":{"description":"Assignment removed"}}}},"/v1/workspaces/{workspace_id}/rate-history/changelog":{"get":{"tags":["Rate History"],"operationId":"getChangelog","summary":"Get rate changelog","description":"Returns a workspace-wide changelog of rate changes.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"user_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"from_date","in":"query"},{"schema":{"type":"string"},"required":false,"name":"to_date","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Rate changelog","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"entity_type":{"type":"string"},"entity_id":{"type":"string"},"rate_type":{"type":"string"},"rate":{"type":"number"},"previous_rate":{"type":"number","nullable":true},"effective_from":{"type":"string","nullable":true},"created_by":{"type":"string","nullable":true},"created_by_name":{"type":"string","nullable":true},"person_name":{"type":"string","nullable":true},"project_name":{"type":"string","nullable":true}},"required":["id","created_at","entity_type","entity_id","rate_type","rate","previous_rate","effective_from","created_by","created_by_name","person_name","project_name"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/rate-history":{"get":{"tags":["Rate History"],"operationId":"list","summary":"List rate history","description":"Returns rate history for a specific entity.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["project_assignment","project","client","workspace_member"]},"required":true,"name":"entity_type","in":"query"},{"schema":{"type":"string","minLength":1},"required":true,"name":"entity_id","in":"query"},{"schema":{"type":"string","enum":["billable_rate","cost_rate","hourly_rate"]},"required":false,"name":"rate_type","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Rate history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"entity_type":{"type":"string"},"entity_id":{"type":"string"},"rate_type":{"type":"string"},"rate":{"type":"number"},"effective_from":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"created_by":{"type":"string","nullable":true},"created_by_name":{"type":"string","nullable":true}},"required":["id","workspace_id","entity_type","entity_id","rate_type","rate","effective_from","created_at","created_by","created_by_name"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/rate-history/{rate_history_id}":{"delete":{"tags":["Rate History"],"operationId":"delete","summary":"Delete a rate history entry","description":"Deletes a rate history entry.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Rate History ID"},"required":true,"description":"Rate History ID","name":"rate_history_id","in":"path"}],"responses":{"200":{"description":"Rate deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/clockify/mappings/entry/{clockify_entry_id}":{"get":{"tags":["Imports"],"operationId":"getClockifyEntryMapping","summary":"Resolve Clockify entry mapping","description":"Returns the WhoWorked entry id mapped to a Clockify entry id.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"clockify_entry_id","in":"path"}],"responses":{"200":{"description":"Clockify entry mapping","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string","enum":["clockify"]},"entity_type":{"type":"string","enum":["entry"]},"external_id":{"type":"string","minLength":1},"entry_id":{"type":"string","minLength":1,"description":"WhoWorked entry ID (ent_)"}},"required":["source","entity_type","external_id","entry_id"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Mapping not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/clockify/mappings/entries/reverse":{"post":{"tags":["Imports"],"operationId":"reverseClockifyEntryMappings","summary":"Resolve WhoWorked entry mappings","description":"Returns the Clockify entry ids mapped to a batch of WhoWorked entry ids.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entry_ids":{"type":"array","items":{"type":"string","minLength":5},"minItems":1,"maxItems":1000}},"required":["entry_ids"]}}}},"responses":{"200":{"description":"Reverse Clockify entry mappings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"mappings":{"type":"array","items":{"type":"object","properties":{"entry_id":{"type":"string","minLength":5,"description":"WhoWorked entry ID (ent_)"},"clockify_entry_id":{"type":"string","minLength":1}},"required":["entry_id","clockify_entry_id"]}},"missing_entry_ids":{"type":"array","items":{"type":"string","minLength":5}}},"required":["mappings","missing_entry_ids"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}/connect":{"post":{"tags":["Imports"],"operationId":"connectImportProvider","summary":"Connect an import provider","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_workspace_id":{"type":"string","minLength":1},"credentials":{"type":"object","additionalProperties":{"type":"string","minLength":1}}},"required":["external_workspace_id","credentials"]}}}},"responses":{"200":{"description":"Validated provider connection","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"workspace_name":{"type":"string"},"user_count":{"type":"integer","minimum":0},"client_count":{"type":"integer","minimum":0},"project_count":{"type":"integer","minimum":0},"tag_count":{"type":"integer","minimum":0}},"required":["workspace_name","user_count","client_count","project_count","tag_count"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}/status":{"get":{"tags":["Imports"],"operationId":"getImportProviderStatus","summary":"Get import provider status","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"responses":{"200":{"description":"Provider status","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string"},"connected":{"type":"boolean"},"syncing":{"type":"boolean"},"external_workspace_id":{"type":"string","nullable":true},"last_synced_at":{"type":"string","nullable":true},"access_status":{"type":"string","enum":["active","no_access","trial_expired"]},"sync_config":{"type":"object","nullable":true,"properties":{"sync_entities":{"type":"object","properties":{"users":{"type":"boolean"},"custom_fields":{"type":"boolean"},"clients":{"type":"boolean"},"projects":{"type":"boolean"},"tags":{"type":"boolean"},"time_entries":{"type":"boolean"}},"required":["users","custom_fields","clients","projects","tags","time_entries"]},"recurring_sync":{"type":"boolean"},"sync_cadence":{"type":"string","enum":["1m","5m","15m","30m","1h","6h","24h"]},"next_sync_at":{"type":"string","nullable":true},"last_sync_status":{"type":"string","nullable":true,"enum":["success","failed","in_progress",null]},"last_sync_error":{"type":"string","nullable":true}},"required":["sync_entities","recurring_sync","sync_cadence","next_sync_at","last_sync_status","last_sync_error"]},"mapped":{"type":"object","properties":{"users":{"type":"integer","minimum":0},"clients":{"type":"integer","minimum":0},"projects":{"type":"integer","minimum":0},"tags":{"type":"integer","minimum":0},"custom_field_defs":{"type":"integer","minimum":0},"entries":{"type":"integer","minimum":0}},"required":["users","clients","projects","tags","custom_field_defs","entries"]}},"required":["source","connected","syncing","external_workspace_id","last_synced_at","access_status","sync_config","mapped"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}/preview":{"post":{"tags":["Imports"],"operationId":"previewImportProvider","summary":"Preview an import provider","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"responses":{"200":{"description":"Import preview","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"users_total":{"type":"integer","minimum":0},"users_new":{"type":"integer","minimum":0},"clients_total":{"type":"integer","minimum":0},"clients_new":{"type":"integer","minimum":0},"projects_total":{"type":"integer","minimum":0},"projects_new":{"type":"integer","minimum":0},"tags_total":{"type":"integer","minimum":0},"tags_new":{"type":"integer","minimum":0},"custom_field_defs_total":{"type":"integer","minimum":0},"custom_field_defs_new":{"type":"integer","minimum":0},"entries_estimated_total":{"type":"integer","minimum":0}},"required":["users_total","users_new","clients_total","clients_new","projects_total","projects_new","tags_total","tags_new","custom_field_defs_total","custom_field_defs_new","entries_estimated_total"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}/sync":{"post":{"tags":["Imports"],"operationId":"startImportProviderSync","summary":"Start an import provider sync","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"send_invites":{"type":"boolean","default":false},"import_archived":{"type":"boolean","default":false},"skip_entries":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Sync started","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"started":{"type":"boolean","enum":[true]}},"required":["started"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}/config":{"put":{"tags":["Imports"],"operationId":"updateImportProviderSyncConfig","summary":"Update import provider sync settings","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"syncEntities":{"type":"object","properties":{"users":{"type":"boolean"},"customFields":{"type":"boolean"},"clients":{"type":"boolean"},"projects":{"type":"boolean"},"tags":{"type":"boolean"},"timeEntries":{"type":"boolean"}},"required":["users","customFields","clients","projects","tags","timeEntries"]},"recurringSync":{"type":"boolean"},"syncCadence":{"type":"string","enum":["1m","5m","15m","30m","1h","6h","24h"]}}}}}},"responses":{"200":{"description":"Sync settings updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"updated":{"type":"boolean","enum":[true]}},"required":["updated"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/import/providers/{source}":{"delete":{"tags":["Imports"],"operationId":"disconnectImportProvider","summary":"Disconnect an import provider","description":"Removes the provider credentials and recurring sync settings. Existing imported data and mappings are retained.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"required":true,"name":"source","in":"path"}],"responses":{"200":{"description":"Provider disconnected","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"disconnected":{"type":"boolean"}},"required":["disconnected"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Provider or connection not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Import lifecycle conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/feature-access/me":{"get":{"tags":["Feature Access"],"operationId":"getMyFeatureAccess","summary":"Get current member feature access","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Current user's effective feature access map.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"workspace_id":{"type":"string"},"user_id":{"type":"string"},"features":{"type":"object","additionalProperties":{"type":"boolean"}}},"required":["workspace_id","user_id","features"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/feature-access":{"get":{"tags":["Feature Access"],"operationId":"listFeatureAccess","summary":"List member feature access rows","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Member feature access rows.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"workspace_id":{"type":"string"},"user_id":{"type":"string"},"feature_key":{"type":"string"},"enabled":{"type":"boolean"},"reason":{"type":"string"},"set_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["workspace_id","user_id","feature_key","enabled","reason","set_by","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/feature-access/{feature_key}/{user_id}":{"put":{"tags":["Feature Access"],"operationId":"upsertFeatureAccess","summary":"Set member feature access","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"feature_key","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"user_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["enabled","reason"]}}}},"responses":{"200":{"description":"Member feature access row.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"workspace_id":{"type":"string"},"user_id":{"type":"string"},"feature_key":{"type":"string"},"enabled":{"type":"boolean"},"reason":{"type":"string"},"set_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["workspace_id","user_id","feature_key","enabled","reason","set_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Feature Access"],"operationId":"deleteFeatureAccess","summary":"Remove member feature access","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"feature_key","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"user_id","in":"path"}],"responses":{"204":{"description":"Member feature access row removed."},"404":{"description":"Feature access row not found.","content":{"application/json":{"schema":{"nullable":true}}}}}}},"/v1/workspaces/{workspace_id}/lock-periods/config":{"get":{"tags":["Lock Periods"],"operationId":"getConfig","summary":"Get lock period config","description":"Returns the lock period configuration for the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Lock period config","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"frequency":{"type":"string","enum":["weekly","biweekly","monthly","custom"]},"anchor_date":{"type":"string"},"auto_lock_after_days":{"type":"number","nullable":true},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","frequency","anchor_date","auto_lock_after_days","created_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"post":{"tags":["Lock Periods"],"operationId":"upsertConfig","summary":"Upsert lock period config","description":"Creates or updates the lock period configuration.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"frequency":{"type":"string","enum":["weekly","biweekly","monthly","custom"]},"anchor_date":{"type":"string"},"auto_lock_after_days":{"type":"integer","nullable":true,"minimum":0}},"required":["frequency","anchor_date"]}}}},"responses":{"200":{"description":"Config saved","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"frequency":{"type":"string","enum":["weekly","biweekly","monthly","custom"]},"anchor_date":{"type":"string"},"auto_lock_after_days":{"type":"number","nullable":true},"created_by":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","frequency","anchor_date","auto_lock_after_days","created_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/lock-periods":{"get":{"tags":["Lock Periods"],"operationId":"list","summary":"List lock periods","description":"Returns a paginated list of lock periods.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","enum":["open","locked","unlocked"]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"Paginated list of lock periods","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"name":{"type":"string","nullable":true},"start_date":{"type":"string"},"end_date":{"type":"string"},"status":{"type":"string","enum":["open","locked","unlocked"]},"locked_at":{"type":"string","nullable":true,"format":"date-time"},"locked_by":{"type":"string","nullable":true},"unlocked_at":{"type":"string","nullable":true,"format":"date-time"},"unlocked_by":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","name","start_date","end_date","status","locked_at","locked_by","unlocked_at","unlocked_by","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Lock Periods"],"operationId":"create","summary":"Create a lock period","description":"Creates a new lock period.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"start_date":{"type":"string"},"end_date":{"type":"string"}},"required":["start_date","end_date"]}}}},"responses":{"201":{"description":"Lock period created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"name":{"type":"string","nullable":true},"start_date":{"type":"string"},"end_date":{"type":"string"},"status":{"type":"string","enum":["open","locked","unlocked"]},"locked_at":{"type":"string","nullable":true,"format":"date-time"},"locked_by":{"type":"string","nullable":true},"unlocked_at":{"type":"string","nullable":true,"format":"date-time"},"unlocked_by":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","name","start_date","end_date","status","locked_at","locked_by","unlocked_at","unlocked_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/lock-periods/{period_id}":{"get":{"tags":["Lock Periods"],"operationId":"get","summary":"Get a lock period","description":"Returns a single lock period by ID.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Lock Period ID"},"required":true,"description":"Lock Period ID","name":"period_id","in":"path"}],"responses":{"200":{"description":"Lock period found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"name":{"type":"string","nullable":true},"start_date":{"type":"string"},"end_date":{"type":"string"},"status":{"type":"string","enum":["open","locked","unlocked"]},"locked_at":{"type":"string","nullable":true,"format":"date-time"},"locked_by":{"type":"string","nullable":true},"unlocked_at":{"type":"string","nullable":true,"format":"date-time"},"unlocked_by":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","name","start_date","end_date","status","locked_at","locked_by","unlocked_at","unlocked_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Lock Periods"],"operationId":"delete","summary":"Delete a lock period","description":"Deletes an open lock period.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Lock Period ID"},"required":true,"description":"Lock Period ID","name":"period_id","in":"path"}],"responses":{"204":{"description":"Period deleted"}}}},"/v1/workspaces/{workspace_id}/lock-periods/{period_id}/lock":{"post":{"tags":["Lock Periods"],"operationId":"lock","summary":"Lock a period","description":"Locks a lock period, preventing entry modifications.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Lock Period ID"},"required":true,"description":"Lock Period ID","name":"period_id","in":"path"}],"responses":{"200":{"description":"Period locked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"name":{"type":"string","nullable":true},"start_date":{"type":"string"},"end_date":{"type":"string"},"status":{"type":"string","enum":["open","locked","unlocked"]},"locked_at":{"type":"string","nullable":true,"format":"date-time"},"locked_by":{"type":"string","nullable":true},"unlocked_at":{"type":"string","nullable":true,"format":"date-time"},"unlocked_by":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","name","start_date","end_date","status","locked_at","locked_by","unlocked_at","unlocked_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/lock-periods/{period_id}/unlock":{"post":{"tags":["Lock Periods"],"operationId":"unlock","summary":"Unlock a period","description":"Unlocks a previously locked period.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Lock Period ID"},"required":true,"description":"Lock Period ID","name":"period_id","in":"path"}],"responses":{"200":{"description":"Period unlocked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"name":{"type":"string","nullable":true},"start_date":{"type":"string"},"end_date":{"type":"string"},"status":{"type":"string","enum":["open","locked","unlocked"]},"locked_at":{"type":"string","nullable":true,"format":"date-time"},"locked_by":{"type":"string","nullable":true},"unlocked_at":{"type":"string","nullable":true,"format":"date-time"},"unlocked_by":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","name","start_date","end_date","status","locked_at","locked_by","unlocked_at","unlocked_by","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/manager-grants":{"get":{"tags":["Manager Grants"],"operationId":"list","summary":"List manager grants","description":"Returns active manager grants in the workspace (optionally include revoked).","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"user_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"client_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"},{"schema":{"anyOf":[{"type":"string","enum":["true"]},{"type":"string","enum":["false"]}]},"required":false,"name":"include_revoked","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"List of manager grants","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ManagerGrant"}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Manager Grants"],"operationId":"create","summary":"Grant manager authority","description":"Grants a workspace member manager authority over a specific client or project.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateManagerGrantBody"}}}},"responses":{"201":{"description":"Grant created (or existing active grant returned)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ManagerGrant"},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/manager-grants/{grant_id}":{"delete":{"tags":["Manager Grants"],"operationId":"revoke","summary":"Revoke manager grant","description":"Soft-revokes a manager grant by setting revoked_at.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Manager grant ID"},"required":true,"description":"Manager grant ID","name":"grant_id","in":"path"}],"responses":{"200":{"description":"Grant revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ManagerGrant"},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/alerts":{"get":{"tags":["Alerts"],"operationId":"list","summary":"List alerts","description":"Returns insight alerts visible to the caller.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["open","dismissed","auto_resolved"]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"required":false,"name":"alert_type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"user_id","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"List alerts visible to the caller.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"alert_type":{"type":"string","enum":["underlogging","duplicate_entry","long_entry","long_day"]},"severity":{"type":"string","enum":["info","warning"]},"status":{"type":"string","enum":["open","dismissed","auto_resolved"]},"payload":{"type":"object","additionalProperties":{"nullable":true}},"subject_user_id":{"type":"string","nullable":true},"subject_project_id":{"type":"string","nullable":true},"subject_time_entry_id":{"type":"string","nullable":true},"subject_user":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"email":{"type":"string"}},"required":["id","name","email"]},"subject_project":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string","nullable":true}},"required":["id","name","currency"]},"subject_time_entry":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"description":{"type":"string","nullable":true},"started_at":{"type":"string"},"stopped_at":{"type":"string","nullable":true}},"required":["id","description","started_at","stopped_at"]},"first_detected_at":{"type":"string"},"last_detected_at":{"type":"string"},"created_at":{"type":"string"}},"required":["id","alert_type","severity","status","payload","subject_user_id","subject_project_id","subject_time_entry_id","subject_user","subject_project","subject_time_entry","first_detected_at","last_detected_at","created_at"]}}},"required":["data"]}}}}}}},"/v1/workspaces/{workspace_id}/alerts/:alert_id/dismiss":{"post":{"tags":["Alerts"],"operationId":"dismiss","summary":"Dismiss an alert","description":"Dismisses an open alert, with an optional note.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"alert_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"}}}}}},"responses":{"200":{"description":"Alert dismissed.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"alert_type":{"type":"string","enum":["underlogging","duplicate_entry","long_entry","long_day"]},"severity":{"type":"string","enum":["info","warning"]},"status":{"type":"string","enum":["open","dismissed","auto_resolved"]},"payload":{"type":"object","additionalProperties":{"nullable":true}},"subject_user_id":{"type":"string","nullable":true},"subject_project_id":{"type":"string","nullable":true},"subject_time_entry_id":{"type":"string","nullable":true},"subject_user":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"email":{"type":"string"}},"required":["id","name","email"]},"subject_project":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"currency":{"type":"string","nullable":true}},"required":["id","name","currency"]},"subject_time_entry":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"description":{"type":"string","nullable":true},"started_at":{"type":"string"},"stopped_at":{"type":"string","nullable":true}},"required":["id","description","started_at","stopped_at"]},"first_detected_at":{"type":"string"},"last_detected_at":{"type":"string"},"created_at":{"type":"string"}},"required":["id","alert_type","severity","status","payload","subject_user_id","subject_project_id","subject_time_entry_id","subject_user","subject_project","subject_time_entry","first_detected_at","last_detected_at","created_at"]}}}}}}},"/v1/workspaces/{workspace_id}/me/dashboard":{"get":{"tags":["Me Dashboard"],"operationId":"getBundle","summary":"Get personal dashboard bundle","description":"Returns the full personal retrospective dashboard bundle for the authenticated user.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["all","30d","7d"],"default":"all"},"required":false,"name":"range","in":"query"}],"responses":{"200":{"description":"Dashboard bundle","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"range":{"type":"string","enum":["all","30d","7d"]},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"hours":{"type":"number"}},"required":["date","hours"]}},"stats":{"type":"object","properties":{"totalHours":{"type":"number"},"sessions":{"type":"integer"},"activeDays":{"type":"integer"},"currentStreak":{"type":"integer"},"longestStreak":{"type":"integer"},"peakHour":{"type":"integer","nullable":true},"favoriteProject":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true}},"required":["id","name","color"]},"aiMixPct":{"type":"number"}},"required":["totalHours","sessions","activeDays","currentStreak","longestStreak","peakHour","favoriteProject","aiMixPct"]},"heatmap":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"hours":{"type":"number"}},"required":["date","hours"]}},"topProjects":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string","nullable":true},"hours":{"type":"number"},"pct":{"type":"number"},"sparkline":{"type":"array","items":{"type":"number"}}},"required":["projectId","name","color","hours","pct","sparkline"]}},"personalityLine":{"type":"object","nullable":true,"properties":{"template":{"type":"string","enum":["total_hours","ai_mix_shift","streak_personal_best","busiest_day","ai_first_50","top_source","manual_decline","leaderboard_summary"]},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]}}},"required":["template","params"]},"team":{"type":"object","nullable":true,"properties":{"weekHours":{"type":"number"},"activeNow":{"type":"integer"},"topProject":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}},"required":["weekHours","activeNow","topProject"]},"thisWeek":{"type":"object","properties":{"totalHours":{"type":"number"},"prevWeekHours":{"type":"number"},"billableHours":{"type":"number"},"humanHours":{"type":"number"},"aiHours":{"type":"number"},"runningTimers":{"type":"integer"},"activeProjects":{"type":"integer"}},"required":["totalHours","prevWeekHours","billableHours","humanHours","aiHours","runningTimers","activeProjects"]}},"required":["range","series","stats","heatmap","topProjects","personalityLine","team","thisWeek"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/me/dashboard/sources":{"get":{"tags":["Me Dashboard"],"operationId":"getSources","summary":"Personal dashboard — sources breakdown","description":"Returns hours stacked by capture source over time, a leaderboard, and a sources-flavored personality line.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","enum":["all","30d","7d"],"default":"all"},"required":false,"name":"range","in":"query"}],"responses":{"200":{"description":"Sources bundle","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"range":{"type":"string","enum":["all","30d","7d"]},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"bySource":{"type":"object","additionalProperties":{"type":"number"}}},"required":["date","bySource"]}},"leaderboard":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"label":{"type":"string"},"color":{"type":"string"},"hours":{"type":"number"},"pct":{"type":"number"}},"required":["source","label","color","hours","pct"]}},"personalityLine":{"type":"object","nullable":true,"properties":{"template":{"type":"string","enum":["total_hours","ai_mix_shift","streak_personal_best","busiest_day","ai_first_50","top_source","manual_decline","leaderboard_summary"]},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]}}},"required":["template","params"]}},"required":["range","series","leaderboard","personalityLine"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/traces":{"get":{"tags":["Traces"],"operationId":"list","summary":"List current user's monthly Traces in this workspace","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Trace list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"traces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"workspaceId":{"type":"string","format":"uuid"},"periodYear":{"type":"integer"},"periodMonth":{"type":"integer","minimum":1,"maximum":12},"pngUrl":{"type":"string","format":"uri"},"stats":{"type":"object","properties":{"sessions":{"type":"integer","minimum":0},"focusMinutes":{"type":"integer","minimum":0},"activeDays":{"type":"integer","minimum":0},"peakDayOfWeek":{"type":"integer","minimum":0,"maximum":6},"peakHour":{"type":"integer","minimum":0,"maximum":23},"dailyMinutes":{"type":"array","items":{"type":"integer","minimum":0}}},"required":["sessions","focusMinutes","activeDays","peakDayOfWeek","peakHour","dailyMinutes"]},"generatedAt":{"type":"string","format":"date-time"},"viewedAt":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","userId","workspaceId","periodYear","periodMonth","pngUrl","stats","generatedAt","viewedAt"]}}},"required":["traces"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/traces/latest":{"get":{"tags":["Traces"],"operationId":"getLatest","summary":"Get the current user's most recent unviewed Trace, or null","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Latest trace","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"trace":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"workspaceId":{"type":"string","format":"uuid"},"periodYear":{"type":"integer"},"periodMonth":{"type":"integer","minimum":1,"maximum":12},"pngUrl":{"type":"string","format":"uri"},"stats":{"type":"object","properties":{"sessions":{"type":"integer","minimum":0},"focusMinutes":{"type":"integer","minimum":0},"activeDays":{"type":"integer","minimum":0},"peakDayOfWeek":{"type":"integer","minimum":0,"maximum":6},"peakHour":{"type":"integer","minimum":0,"maximum":23},"dailyMinutes":{"type":"array","items":{"type":"integer","minimum":0}}},"required":["sessions","focusMinutes","activeDays","peakDayOfWeek","peakHour","dailyMinutes"]},"generatedAt":{"type":"string","format":"date-time"},"viewedAt":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","userId","workspaceId","periodYear","periodMonth","pngUrl","stats","generatedAt","viewedAt"]}},"required":["trace"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/traces/{trace_id}/viewed":{"post":{"tags":["Traces"],"operationId":"markViewed","summary":"Mark a Trace as viewed","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"trace_id","in":"path"}],"responses":{"200":{"description":"Marked viewed","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"trace":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string"},"workspaceId":{"type":"string","format":"uuid"},"periodYear":{"type":"integer"},"periodMonth":{"type":"integer","minimum":1,"maximum":12},"pngUrl":{"type":"string","format":"uri"},"stats":{"type":"object","properties":{"sessions":{"type":"integer","minimum":0},"focusMinutes":{"type":"integer","minimum":0},"activeDays":{"type":"integer","minimum":0},"peakDayOfWeek":{"type":"integer","minimum":0,"maximum":6},"peakHour":{"type":"integer","minimum":0,"maximum":23},"dailyMinutes":{"type":"array","items":{"type":"integer","minimum":0}}},"required":["sessions","focusMinutes","activeDays","peakDayOfWeek","peakHour","dailyMinutes"]},"generatedAt":{"type":"string","format":"date-time"},"viewedAt":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","userId","workspaceId","periodYear","periodMonth","pngUrl","stats","generatedAt","viewedAt"]}},"required":["trace"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-chat/messages":{"post":{"tags":["AI Chat"],"operationId":"sendChatMessage","summary":"Send a message and stream AI response","parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thread_id":{"type":"string","nullable":true,"format":"uuid"},"message":{"type":"object","properties":{"id":{"type":"string","minLength":1},"role":{"type":"string","enum":["user"]},"parts":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["text"]},"text":{"type":"string","minLength":1}},"required":["type","text"],"additionalProperties":{"nullable":true}},"minItems":1}},"required":["id","role","parts"]},"context":{"type":"object","properties":{"surface":{"type":"string","enum":["global_page","sidebar"]},"current_route":{"type":"string"},"page_kind":{"type":"string","enum":["dashboard","reports","entries","clients","client_detail","projects","project_detail","members","ai_usage","ai_attributions","settings"]},"page_entity_ids":{"type":"object","properties":{"client_id":{"type":"string"},"project_id":{"type":"string"},"entry_id":{"type":"string"},"report_id":{"type":"string"},"member_user_id":{"type":"string"}}},"visible_filters":{"type":"object","additionalProperties":{"nullable":true}},"visible_columns":{"type":"array","items":{"type":"string"}},"selected_row_ids":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["client","project","member"]},"id":{"type":"string"},"label":{"type":"string"}},"required":["kind","id","label"]},"maxItems":10}},"required":["surface"]}},"required":["message","context"]}}}},"responses":{"200":{"description":"Streaming AI response","content":{"text/event-stream":{"schema":{"nullable":true}}}}}}},"/v1/workspaces/{workspace_id}/ai-chat/threads":{"get":{"tags":["AI Chat"],"operationId":"listChatThreads","summary":"List chat threads for the authenticated user","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"List of chat threads","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"surface":{"type":"string","enum":["global_page","sidebar"]},"page_kind":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"created_by":{"type":"string"},"last_message_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","surface","page_kind","title","created_by","last_message_at","created_at","updated_at"]}},"has_more":{"type":"boolean"}},"required":["data","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/ai-chat/threads/:thread_id":{"get":{"tags":["AI Chat"],"operationId":"getChatThread","summary":"Get a chat thread and its messages","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"thread_id","in":"path"}],"responses":{"200":{"description":"Chat thread with messages","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"thread":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"surface":{"type":"string","enum":["global_page","sidebar"]},"page_kind":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"created_by":{"type":"string"},"last_message_at":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","surface","page_kind","title","created_by","last_message_at","created_at","updated_at"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"thread_id":{"type":"string","format":"uuid"},"role":{"type":"string","enum":["user","assistant","system"]},"parts":{"type":"array","items":{"nullable":true}},"model":{"type":"string","nullable":true},"input_tokens":{"type":"number","nullable":true},"output_tokens":{"type":"number","nullable":true},"created_at":{"type":"string"}},"required":["id","thread_id","role","parts","model","input_tokens","output_tokens","created_at"]}},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["runtime_changed","history_compacted"]},"payload":{"type":"object","additionalProperties":{"nullable":true}},"created_at":{"type":"string"}},"required":["id","type","payload","created_at"]}}},"required":["thread","messages","events"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["AI Chat"],"operationId":"deleteChatThread","summary":"Delete a chat thread and all its messages","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"thread_id","in":"path"}],"responses":{"200":{"description":"Thread deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/anomaly-settings":{"get":{"tags":["Anomaly Settings"],"operationId":"get","summary":"Get anomaly settings","description":"Returns the workspace anomaly detection settings, or defaults if none have been saved yet.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"Anomaly settings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AnomalySettings"},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Anomaly Settings"],"operationId":"update","summary":"Update anomaly settings","description":"Persists the workspace anomaly detection settings. Resets ai_evaluated_at on entries from the last 24h so the next nightly cron re-evaluates them under the new rules.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalySettings"}}}},"responses":{"200":{"description":"Anomaly settings updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AnomalySettings"},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks":{"get":{"tags":["Webhooks"],"operationId":"listWebhookEndpoints","summary":"List webhook endpoints","description":"Returns every webhook endpoint in the workspace. The signing secret is never included.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"List of webhook endpoints","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Webhooks"],"operationId":"createWebhookEndpoint","summary":"Create a webhook endpoint","description":"Creates a webhook endpoint and returns its signing secret. The secret can be read again from the reveal endpoint.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"type":"string","maxLength":500},"event_types":{"type":"array","items":{"type":"string","enum":["entry.created","entry.updated","entry.deleted","project.created","project.updated","project.deleted","client.created","client.updated","client.deleted","member.created","member.updated","member.deleted"]},"minItems":1}},"required":["url","event_types"]}}}},"responses":{"201":{"description":"Webhook endpoint created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret (whsec_): shown on create, reveal and rotate"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at","secret"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}":{"get":{"tags":["Webhooks"],"operationId":"getWebhookEndpoint","summary":"Get a webhook endpoint","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"responses":{"200":{"description":"Webhook endpoint","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"patch":{"tags":["Webhooks"],"operationId":"updateWebhookEndpoint","summary":"Update a webhook endpoint","description":"Updates the URL, description, subscribed events or status. Re-enabling an auto-disabled endpoint resets its consecutive failure counter.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"type":"string","nullable":true,"maxLength":500},"event_types":{"type":"array","items":{"type":"string","enum":["entry.created","entry.updated","entry.deleted","project.created","project.updated","project.deleted","client.created","client.updated","client.deleted","member.created","member.updated","member.deleted"]},"minItems":1},"status":{"type":"string","enum":["enabled","disabled"]}}}}}},"responses":{"200":{"description":"Webhook endpoint updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Webhooks"],"operationId":"deleteWebhookEndpoint","summary":"Delete a webhook endpoint","description":"Soft-deletes the endpoint. Pending deliveries stop immediately.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"responses":{"204":{"description":"Webhook endpoint deleted"}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/secret":{"get":{"tags":["Webhooks"],"operationId":"revealWebhookSecret","summary":"Reveal a webhook signing secret","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"responses":{"200":{"description":"Webhook endpoint with its signing secret","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret (whsec_): shown on create, reveal and rotate"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at","secret"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/rotate-secret":{"post":{"tags":["Webhooks"],"operationId":"rotateWebhookSecret","summary":"Rotate a webhook signing secret","description":"Replaces the signing secret. Deliveries already in flight keep using the previous secret.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"responses":{"200":{"description":"Webhook endpoint with its new signing secret","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"url":{"type":"string"},"description":{"type":"string","nullable":true},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled","auto_disabled"]},"consecutive_failures":{"type":"number"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"secret":{"type":"string","description":"Signing secret (whsec_): shown on create, reveal and rotate"}},"required":["id","workspace_id","url","description","event_types","status","consecutive_failures","created_at","updated_at","secret"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/deliveries":{"get":{"tags":["Webhooks"],"operationId":"listWebhookDeliveries","summary":"List webhook deliveries","description":"Returns the delivery log for an endpoint, newest first. Pass `since` to poll forward for new rows: that flips the page to oldest first and returns only rows created after the given instant. `since` and `cursor` cannot be combined, because they page in opposite directions.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"},{"schema":{"type":"string","enum":["pending","processing","sent","failed","dead"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","enum":["entry.created","entry.updated","entry.deleted","project.created","project.updated","project.deleted","client.created","client.updated","client.deleted","member.created","member.updated","member.deleted","webhook.test"]},"required":false,"name":"event_type","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"since","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Page of webhook deliveries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Delivery ID (whd_)"},"endpoint_id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","processing","sent","failed","dead"]},"attempts":{"type":"number"},"max_attempts":{"type":"number"},"http_status":{"type":"number","nullable":true},"last_error":{"type":"string","nullable":true},"next_attempt_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","endpoint_id","event_type","status","attempts","max_attempts","http_status","last_error","next_attempt_at","created_at","completed_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/deliveries/{delivery_id}":{"get":{"tags":["Webhooks"],"operationId":"getWebhookDelivery","summary":"Get a webhook delivery","description":"Returns one delivery including the exact request body sent and the response excerpt received.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"},{"schema":{"type":"string","description":"Webhook delivery ID","example":"whd_7f2b8a41-..."},"required":true,"description":"Webhook delivery ID","name":"delivery_id","in":"path"}],"responses":{"200":{"description":"Webhook delivery","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Delivery ID (whd_)"},"endpoint_id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","processing","sent","failed","dead"]},"attempts":{"type":"number"},"max_attempts":{"type":"number"},"http_status":{"type":"number","nullable":true},"last_error":{"type":"string","nullable":true},"next_attempt_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","nullable":true,"format":"date-time"},"request_body":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"Exact JSON body sent, or null before the first attempt"},"response_body":{"type":"string","nullable":true,"description":"Response body excerpt, capped at 4 KB"}},"required":["id","endpoint_id","event_type","status","attempts","max_attempts","http_status","last_error","next_attempt_at","created_at","completed_at","request_body","response_body"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/deliveries/{delivery_id}/retry":{"post":{"tags":["Webhooks"],"operationId":"retryWebhookDelivery","summary":"Retry a webhook delivery","description":"Queues a failed or dead delivery for another attempt: the attempt counter resets and the dispatcher picks it up immediately. Deliveries in any other state return 409.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"},{"schema":{"type":"string","description":"Webhook delivery ID","example":"whd_7f2b8a41-..."},"required":true,"description":"Webhook delivery ID","name":"delivery_id","in":"path"}],"responses":{"200":{"description":"Webhook delivery queued for retry","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Delivery ID (whd_)"},"endpoint_id":{"type":"string","description":"Webhook endpoint ID (whe_)"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","processing","sent","failed","dead"]},"attempts":{"type":"number"},"max_attempts":{"type":"number"},"http_status":{"type":"number","nullable":true},"last_error":{"type":"string","nullable":true},"next_attempt_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","nullable":true,"format":"date-time"},"request_body":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"Exact JSON body sent, or null before the first attempt"},"response_body":{"type":"string","nullable":true,"description":"Response body excerpt, capped at 4 KB"}},"required":["id","endpoint_id","event_type","status","attempts","max_attempts","http_status","last_error","next_attempt_at","created_at","completed_at","request_body","response_body"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/webhooks/{endpoint_id}/test":{"post":{"tags":["Webhooks"],"operationId":"testWebhookEndpoint","summary":"Send a test event","description":"Sends a signed `webhook.test` event to the endpoint and waits for the response. Works while the endpoint is disabled, so an integration can be verified before it goes live. The attempt is recorded in the delivery log and is never retried automatically.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"},{"schema":{"type":"string","description":"Webhook endpoint ID","example":"whe_0d3a1c9e-..."},"required":true,"description":"Webhook endpoint ID","name":"endpoint_id","in":"path"}],"responses":{"200":{"description":"Result of the test send","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"delivery_id":{"type":"string","description":"Delivery ID (whd_)"},"http_status":{"type":"number","nullable":true},"ok":{"type":"boolean"},"response_excerpt":{"type":"string","nullable":true}},"required":["delivery_id","http_status","ok","response_excerpt"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/custom-domains":{"get":{"tags":["Custom Domains"],"operationId":"list","summary":"List custom domains","description":"Returns all custom domains configured for the workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"responses":{"200":{"description":"List of custom domains.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending_dns","dns_verified","provisioning","active","failed","removing"]},"dns_record_type":{"type":"string","nullable":true},"dns_record_value":{"type":"string","nullable":true},"dns_verified_at":{"type":"string","nullable":true},"ssl_provisioned_at":{"type":"string","nullable":true},"last_dns_check_at":{"type":"string","nullable":true},"dns_check_error":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","domain","status","dns_record_type","dns_record_value","dns_verified_at","ssl_provisioned_at","last_dns_check_at","dns_check_error","created_at","updated_at"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}},"post":{"tags":["Custom Domains"],"operationId":"create","summary":"Add custom domain","description":"Registers a custom domain for the workspace and returns DNS configuration instructions.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":255,"pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/i"}},"required":["domain"]}}}},"responses":{"201":{"description":"Custom domain created.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending_dns","dns_verified","provisioning","active","failed","removing"]},"dns_record_type":{"type":"string","nullable":true},"dns_record_value":{"type":"string","nullable":true},"dns_verified_at":{"type":"string","nullable":true},"ssl_provisioned_at":{"type":"string","nullable":true},"last_dns_check_at":{"type":"string","nullable":true},"dns_check_error":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","domain","status","dns_record_type","dns_record_value","dns_verified_at","ssl_provisioned_at","last_dns_check_at","dns_check_error","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"400":{"description":"Invalid domain format.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Custom domains not enabled.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Domain limit reached.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/custom-domains/:domain_id":{"get":{"tags":["Custom Domains"],"operationId":"get","summary":"Get custom domain","description":"Returns details for a specific custom domain.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"domain_id","in":"path"}],"responses":{"200":{"description":"Custom domain details.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending_dns","dns_verified","provisioning","active","failed","removing"]},"dns_record_type":{"type":"string","nullable":true},"dns_record_value":{"type":"string","nullable":true},"dns_verified_at":{"type":"string","nullable":true},"ssl_provisioned_at":{"type":"string","nullable":true},"last_dns_check_at":{"type":"string","nullable":true},"dns_check_error":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","domain","status","dns_record_type","dns_record_value","dns_verified_at","ssl_provisioned_at","last_dns_check_at","dns_check_error","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Domain not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}},"delete":{"tags":["Custom Domains"],"operationId":"delete","summary":"Remove custom domain","description":"Removes a custom domain, cleaning up Vercel DNS and WorkOS redirect URIs.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"domain_id","in":"path"}],"responses":{"200":{"description":"Domain removed.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending_dns","dns_verified","provisioning","active","failed","removing"]},"dns_record_type":{"type":"string","nullable":true},"dns_record_value":{"type":"string","nullable":true},"dns_verified_at":{"type":"string","nullable":true},"ssl_provisioned_at":{"type":"string","nullable":true},"last_dns_check_at":{"type":"string","nullable":true},"dns_check_error":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","domain","status","dns_record_type","dns_record_value","dns_verified_at","ssl_provisioned_at","last_dns_check_at","dns_check_error","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Domain not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/custom-domains/:domain_id/verify":{"post":{"tags":["Custom Domains"],"operationId":"verify","summary":"Verify domain DNS","description":"Triggers a DNS verification check. If DNS is correctly configured, the domain becomes active.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"workspace_id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"domain_id","in":"path"}],"responses":{"200":{"description":"Verification result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"domain":{"type":"string"},"status":{"type":"string","enum":["pending_dns","dns_verified","provisioning","active","failed","removing"]},"dns_record_type":{"type":"string","nullable":true},"dns_record_value":{"type":"string","nullable":true},"dns_verified_at":{"type":"string","nullable":true},"ssl_provisioned_at":{"type":"string","nullable":true},"last_dns_check_at":{"type":"string","nullable":true},"dns_check_error":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","domain","status","dns_record_type","dns_record_value","dns_verified_at","ssl_provisioned_at","last_dns_check_at","dns_check_error","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Domain not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs_url":{"type":"string"}},"required":["code","message","docs_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["error","meta"]}}}}}}},"/v1/workspaces/{workspace_id}/integrations/slack/installations":{"post":{"tags":["Integrations"],"operationId":"bindInstallation","summary":"Bind a Slack team to this workspace","description":"Creates or confirms the binding between a Slack team and this workspace. Admin only. A Slack team can be bound to exactly one workspace.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Workspace ID","example":"wsp_01HQXYZ..."},"required":true,"description":"Workspace ID","name":"workspace_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slack_team_id":{"type":"string","minLength":1},"connector_uid":{"type":"string","minLength":1}},"required":["slack_team_id"]}}}},"responses":{"201":{"description":"Slack team bound to the workspace","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"slack_team_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"installed_by":{"type":"string"},"connector_uid":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["slack_team_id","workspace_id","installed_by","connector_uid","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/integrations/slack/links/resolve":{"get":{"tags":["Integrations"],"operationId":"resolveSlackLink","summary":"Resolve a Slack user to a WhoWorked identity","description":"Service-to-service. Resolves a Slack (team, user) pair to the linked WhoWorked workspace, user, and granted scopes. 404 if the user is not linked.","parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"team_id","in":"query"},{"schema":{"type":"string","minLength":1},"required":true,"name":"slack_user_id","in":"query"}],"responses":{"200":{"description":"Resolved identity","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"ww_user_id":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["workspace_id","ww_user_id","scopes"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Slack user is not linked"}}}},"/v1/integrations/slack/links":{"post":{"tags":["Integrations"],"operationId":"storeSlackLink","summary":"Store a per-user Slack link","description":"Service-to-service. Persists a Slack↔WhoWorked user link after OAuth. The refresh token is encrypted at rest and never returned.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slack_team_id":{"type":"string","minLength":1},"slack_user_id":{"type":"string","minLength":1},"workspace_id":{"type":"string","minLength":1,"description":"Workspace ID (wsp_)"},"ww_user_id":{"type":"string","minLength":1},"refresh_token":{"type":"string","minLength":1,"description":"Plaintext OAuth refresh token; encrypted at rest"},"scopes":{"type":"array","items":{"type":"string"},"default":[]}},"required":["slack_team_id","slack_user_id","workspace_id","ww_user_id","refresh_token"]}}}},"responses":{"201":{"description":"Link stored","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"slack_team_id":{"type":"string"},"slack_user_id":{"type":"string"},"workspace_id":{"type":"string","description":"Workspace ID (wsp_)"},"ww_user_id":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["slack_team_id","slack_user_id","workspace_id","ww_user_id","scopes","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["Integrations"],"operationId":"deleteSlackLink","summary":"Remove a per-user Slack link","description":"Service-to-service. Removes a Slack↔WhoWorked user link. The caller should revoke the OAuth token before calling this.","parameters":[{"schema":{"type":"string","minLength":1},"required":true,"name":"team_id","in":"query"},{"schema":{"type":"string","minLength":1},"required":true,"name":"slack_user_id","in":"query"}],"responses":{"204":{"description":"Link removed"},"404":{"description":"No link found"}}}},"/v1/integrations/slack/links/access-token":{"post":{"tags":["Integrations"],"operationId":"mintSlackAccessToken","summary":"Mint a fresh access token for a linked Slack user","description":"Service-to-service. Returns a short-lived WhoWorked access token for the linked user, rotating the stored refresh token. The refresh token never leaves the API.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string","minLength":1},"slack_user_id":{"type":"string","minLength":1}},"required":["team_id","slack_user_id"]}}}},"responses":{"200":{"description":"Fresh access token","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"number"},"scope":{"type":"string"}},"required":["access_token","token_type","expires_in","scope"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"404":{"description":"Slack user is not linked"}}}},"/v1/integrations/slack/links/start":{"post":{"tags":["Integrations"],"operationId":"startSlackLink","summary":"Begin Willy account linking","description":"Service-to-service. Verifies the Slack team is installed, mints PKCE + state, and returns the consent-page authorize URL to DM to the user.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"team_id":{"type":"string","minLength":1},"slack_user_id":{"type":"string","minLength":1}},"required":["team_id","slack_user_id"]}}}},"responses":{"200":{"description":"Authorize URL","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri"}},"required":["authorize_url"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}},"409":{"description":"Slack team is not installed"}}}},"/v1/invitations/me":{"get":{"tags":["Invitations"],"operationId":"listMine","summary":"Get my pending invitations","description":"Returns all pending invitations for the current user.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"List of pending invitations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"workspace_name":{"type":"string"},"workspace_slug":{"type":"string"},"inviter_name":{"type":"string","nullable":true}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at","workspace_name","workspace_slug","inviter_name"]}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}},"required":["next_cursor","has_more"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"as_of":{"type":"string","format":"date-time"}},"required":["request_id","as_of"]}},"required":["data","pagination","meta"]}}}}}}},"/v1/invitations/{token}":{"get":{"tags":["Invitations"],"operationId":"getByToken","summary":"Get invitation by token","description":"Returns invitation details for a given token.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Invitation token"},"required":true,"description":"Invitation token","name":"token","in":"path"}],"responses":{"200":{"description":"Invitation found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"},"invited_by":{"type":"string"},"invited_by_kind":{"type":"string","enum":["user","api_key"]},"status":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"accepted_at":{"type":"string","nullable":true,"format":"date-time"},"project_assignments":{"type":"array","nullable":true,"items":{"type":"object","properties":{"project_id":{"type":"string","minLength":1},"billable_rate":{"type":"integer","nullable":true},"cost_rate":{"type":"integer","nullable":true},"budget_weekly_hours":{"type":"integer","nullable":true}},"required":["project_id"]}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"deleted_at":{"type":"string","nullable":true,"format":"date-time"},"workspace_name":{"type":"string"},"workspace_slug":{"type":"string"},"inviter_name":{"type":"string","nullable":true}},"required":["id","workspace_id","email","role","invited_by","invited_by_kind","status","expires_at","accepted_at","project_assignments","created_at","updated_at","deleted","deleted_at","workspace_name","workspace_slug","inviter_name"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}}},"/v1/invitations/{token}/accept":{"post":{"tags":["Invitations"],"operationId":"accept","summary":"Accept an invitation","description":"Accepts a workspace invitation using the token.","security":[{"BearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Invitation token"},"required":true,"description":"Invitation token","name":"token","in":"path"}],"responses":{"200":{"description":"Invitation accepted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}}}}