{"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_...) 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"}}},"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","example":"user_01..."},"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":{"/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"},"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","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}},"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"},"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","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"},"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","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"},"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"},"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","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"},"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","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","tags:read","tags:write","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","ai_attributions:manage","ai_reporters:read","ai_reporters:write","external_id_mappings:read","external_id_mappings: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","tags:read","tags:write","agent_sessions:read","agent_sessions:write","ai_attributions:read","ai_attributions:write","ai_attributions:manage","ai_reporters:read","ai_reporters:write","external_id_mappings:read","external_id_mappings: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}/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":0}},"default":{"minAiShareToShow":0.05,"minCoverageToQuantify":0.7,"warmupReports":0}}}},"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":0}},"default":{"minAiShareToShow":0.05,"minCoverageToQuantify":0.7,"warmupReports":0}}}},"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"],"default":"public"},"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"},"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"]}},"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":1000},"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":1000},"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 or rejects a pending 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":{"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"}],"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":"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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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"}},"required":["id","timeEntryId","parentAttributionId","reviewStatus","matched"]},"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"},"ok":{"type":"boolean","enum":[true]}},"required":["id","timeEntryId","parentAttributionId","reviewStatus","matched","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/{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":["auto_draft","unreviewed","reviewed","verified","dismissed"]}}}}}},"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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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 AI attribution as reviewed.","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 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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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":"Dismisses an AI attribution as reviewed.","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 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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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},"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"]},"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","reporterId","source","captureMode","capturePolicyVersion","contentRef","reviewStatus","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","format":"date-time"},"required":false,"name":"date_from","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"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","format":"date-time"},"required":false,"name":"date_from","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"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}}}}}},"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}/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/{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},"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","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},"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","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 current user's membership 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"}],"responses":{"200":{"description":"Current member info","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"user_id":{"type":"string"},"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","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},"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","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},"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","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}/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"]},"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"}},"task_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month"]},"sub_group_by":{"type":"string","enum":["project","client","user","agent","tag","task","day","week","month"]}},"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"]},"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"}},"task_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"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"]},"group_by":{"type":"string","enum":["project","client","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_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":{"nullable":true},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["meta"]}}}}}}},"/v1/workspaces/{workspace_id}/reports/export":{"post":{"tags":["Reports"],"operationId":"exportCsv","summary":"Export report as CSV","description":"Exports a detailed report as a CSV 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"]},"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"}},"task_ids":{"type":"array","items":{"type":"string"}},"billable":{"type":"boolean"},"description_contains":{"type":"string"},"include_running":{"type":"boolean","default":false},"format":{"type":"string","enum":["csv"],"default":"csv"},"lock_period_id":{"type":"string"}},"required":["date_range"]}}}},"responses":{"200":{"description":"CSV 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}/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}/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-config":{"get":{"tags":["AI Config"],"operationId":"get","summary":"Get workspace AI configuration","description":"Returns the current AI configuration for the workspace, or defaults if none exists.","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":"AI configuration","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string","nullable":true},"has_custom_key":{"type":"boolean"},"api_key_hint":{"type":"string","nullable":true},"max_tokens_per_request":{"type":"number"},"timeout_ms":{"type":"number"},"enabled":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","provider","model","has_custom_key","api_key_hint","max_tokens_per_request","timeout_ms","enabled","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"put":{"tags":["AI Config"],"operationId":"replace","summary":"Create or update workspace AI configuration","description":"Sets the AI provider, model, and optionally a custom API key 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":{"provider":{"type":"string","enum":["anthropic"]},"model":{"type":"string","minLength":1,"maxLength":200},"api_key":{"type":"string","minLength":1,"maxLength":500},"clear_api_key":{"type":"boolean"},"max_tokens_per_request":{"type":"integer","minimum":64,"maximum":4096},"timeout_ms":{"type":"integer","minimum":1000,"maximum":30000},"enabled":{"type":"boolean"}}}}}},"responses":{"200":{"description":"AI configuration updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"workspace_id":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string","nullable":true},"has_custom_key":{"type":"boolean"},"api_key_hint":{"type":"string","nullable":true},"max_tokens_per_request":{"type":"number"},"timeout_ms":{"type":"number"},"enabled":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","workspace_id","provider","model","has_custom_key","api_key_hint","max_tokens_per_request","timeout_ms","enabled","created_at","updated_at"]},"meta":{"type":"object","properties":{"request_id":{"type":"string"}},"required":["request_id"]}},"required":["data","meta"]}}}}}},"delete":{"tags":["AI Config"],"operationId":"delete","summary":"Delete workspace AI configuration","description":"Removes the workspace AI configuration, reverting to platform defaults.","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":"AI configuration deleted"}}}},"/v1/workspaces/{workspace_id}/ai-config/test":{"post":{"tags":["AI Config"],"operationId":"validate","summary":"Test AI configuration","description":"Sends a test prompt to verify the AI provider is reachable with the current configuration.","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":"Test result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean"},"response_text":{"type":"string","nullable":true},"model":{"type":"string"},"provider":{"type":"string"},"duration_ms":{"type":"number"},"error":{"type":"string","nullable":true}},"required":["success","response_text","model","provider","duration_ms","error"]},"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"}}},"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"]}}},"required":["thread","messages"]},"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}/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"]}}}}}}}}}