{"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"},"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},"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","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","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"},"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},"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","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","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"},"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},"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","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","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"},"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"},"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},"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","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","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"},"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},"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","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","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","projects:read","projects:write","tasks:read","tasks:write","clients:read","clients:write","tags:read","tags:write","agent_sessions:read","agent_sessions: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","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"}},"created_at":{"type":"string"},"last_used_at":{"type":"string","nullable":true},"expires_at":{"type":"string"}},"required":["id","app_name","scopes","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"}},"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","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}}},"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}}},"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}/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"},"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},"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"]}}},"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"}}}}}},"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},"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"]}}},"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},"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"]}},"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"}}}}}},"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},"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"]}}},"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},"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"]}}},"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},"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"]}}},"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-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"]},"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"]},"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 role or rate.","security":[{"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":{"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}/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},"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","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 a mandatory 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","minLength":5}},"required":["note"]}}}},"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},"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","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}/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/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"]}}}}}}}}}