{"openapi":"3.0.0","info":{"title":"Polylane API","description":"The API for programmatically interacting with Polylane","version":"0.0.1","contact":{"name":"Boris Tane","email":"me@boristane.com","url":"https://boristane.com"},"license":{"name":"MIT"}},"servers":[{"url":"https://api.polylane.com","description":"Live environment"}],"paths":{"/v1/auth/verify_email":{"post":{"operationId":"auth.verifyEmail","security":[],"tags":["Authentication"],"summary":"Email verification","requestBody":{"required":true,"description":"A JSON object containing the verification code.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":6},"email":{"type":"string","format":"email"}},"required":["code","email"]}}}},"responses":{"200":{"description":"Successful request","headers":{"Set-Cookie":{"type":"string","description":"Authentication cookie"}},"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/signup":{"post":{"operationId":"auth.signup","security":[],"tags":["Authentication"],"summary":"Email sign up","requestBody":{"required":true,"description":"Email and password.","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","minLength":1,"format":"email"},"password":{"type":"string","minLength":8,"pattern":"^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&])[A-Za-z\\d@$!%*?&]{8,}$"},"turnstileToken":{"type":"string"},"ref":{"type":"string","description":"Attribution ref captured at first touch, e.g. github.pr-comment. Invalid values are discarded, never rejected."},"inviteToken":{"type":"string","maxLength":128,"description":"Workspace invite token from an invite link. Unknown or revoked tokens are ignored, never rejected."}},"required":["email","password"]}}}},"responses":{"200":{"description":"Successful request","headers":{"Set-Cookie":{"type":"string","description":"Authentication cookie"}},"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/User"},"token":{"type":"string"}},"required":["user"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/logout":{"post":{"operationId":"auth.logout","security":[{"BearerAuth":[]},{"CookieAuth":[]}],"tags":["Authentication"],"summary":"Log out","responses":{"200":{"description":"Successful request","headers":{"Set-Cookie":{"type":"string","description":"Authentication cookie"}},"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/whoami":{"get":{"operationId":"auth.whoami","tags":["Authentication"],"summary":"Get current user","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/User"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/me":{"delete":{"operationId":"auth.del","tags":["Authentication"],"summary":"Delete current user","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"_object":{"type":"string","enum":["user"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"auth.patch","tags":["Authentication"],"summary":"Update the fields of the current user","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"forename":{"type":"string","example":"John"},"surname":{"type":"string","nullable":true,"example":"Doe"},"email":{"type":"string","nullable":true,"format":"email"},"username":{"type":"string","nullable":true,"example":"johndoe"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/User"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/generate_password_reset":{"post":{"operationId":"auth.generatePasswordResetCode","security":[],"tags":["Authentication"],"summary":"Generate password reset code","requestBody":{"required":true,"description":"A JSON object containing the email.","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]}}}},"responses":{"202":{"description":"Request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Request accepted"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/reset_password":{"post":{"operationId":"auth.resetPassword","security":[],"tags":["Authentication"],"summary":"Password reset","requestBody":{"required":true,"description":"A JSON object containing the reset code.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":6},"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":8,"pattern":"^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&])[A-Za-z\\d@$!%*?&]{8,}$"}},"required":["code","email","password"]}}}},"responses":{"202":{"description":"Request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Request accepted"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{}}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/auth/notifications":{"get":{"operationId":"auth.notification_settings.get","tags":["Authentication"],"summary":"Get the user notification settings","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Notification Settings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"auth.notification_settings.put","tags":["Authentication"],"summary":"Set the user notification settings","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Notification Settings"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Notification Settings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/api_keys/{workspaceId}/{id}":{"get":{"operationId":"api_keys.get","tags":["API Keys"],"summary":"Get an API key","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^(?:polylane|nominal)_[0-9a-z]{64}$","description":"ID of the api_key","example":"polylane_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the api_key","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Api Key"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"api_keys.del","tags":["API Keys"],"summary":"Delete an API key","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^(?:polylane|nominal)_[0-9a-z]{64}$","description":"ID of the api_key","example":"polylane_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the api_key","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^(?:polylane|nominal)_[0-9a-z]{64}$","description":"ID of the api_key","example":"polylane_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"_object":{"type":"string","enum":["api_key"]}},"required":["workspaceId","id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/api_keys/{workspaceId}":{"get":{"operationId":"api_keys.list","tags":["API Keys"],"summary":"List API keys","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","ownerId","name","lastActive","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Api Key"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/api_keys":{"post":{"operationId":"api_keys.post","tags":["API Keys"],"summary":"Create a new API key","requestBody":{"required":true,"description":"The API key to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the API key"},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"}}},"required":["workspaceId","name","scopes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^(?:polylane|nominal)_[0-9a-z]{64}$","description":"ID of the api_key","example":"polylane_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the API key"},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"}},"lastActive":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["api_key"]},"token":{"type":"string","pattern":"^sk_[0-9a-z]{64}$","description":"ID of the api_key_token","example":"sk_twz7duqh2vntphgam51681qxfgu5j21uvc31fi4g63kgu8ofbh1khzobzi3wwzdk"}},"required":["id","workspaceId","ownerId","name","scopes","lastActive","created","updated","_object","token"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/telemetry_tokens/{workspaceId}/{id}":{"get":{"operationId":"telemetry_tokens.get","tags":["Telemetry Tokens"],"summary":"Get a telemetry token","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the telemetry_token","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Telemetry Token"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"telemetry_tokens.del","tags":["Telemetry Tokens"],"summary":"Delete a telemetry token","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the telemetry_token","name":"id","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Force deletion of a managed token (e.g. one created by an integration)."},"required":false,"description":"Force deletion of a managed token (e.g. one created by an integration).","name":"force","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"_object":{"type":"string","enum":["telemetry_token"]}},"required":["workspaceId","id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"telemetry_tokens.put","tags":["Telemetry Tokens"],"summary":"Update a telemetry token","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the telemetry_token","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The telemetry token properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the telemetry token"}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Telemetry Token"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"telemetry_tokens.patch","tags":["Telemetry Tokens"],"summary":"Update a telemetry token","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"required":true,"description":"ID of the telemetry_token","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The telemetry token properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the telemetry token"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Telemetry Token"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/telemetry_tokens/{workspaceId}":{"get":{"operationId":"telemetry_tokens.list","tags":["Telemetry Tokens"],"summary":"List telemetry tokens","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","ownerId","token","name","source","sourceResourceId","provider","lastActive","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"token","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"source","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceResourceId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Telemetry Token"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/telemetry_tokens":{"post":{"operationId":"telemetry_tokens.post","tags":["Telemetry Tokens"],"summary":"Create a new telemetry token","requestBody":{"required":true,"description":"The telemetry token to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the telemetry token"}},"required":["workspaceId","name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"token":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the telemetry token"},"source":{"type":"string","nullable":true,"enum":["integration","cloud_account",null],"description":"Source that created this token","example":"integration"},"sourceResourceId":{"type":"string","nullable":true,"description":"ID of the resource that created this token","example":"integration_abc123"},"provider":{"type":"string","nullable":true,"enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","vercel",null],"description":"Integration provider that created this token","example":"sentry"},"lastActive":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["telemetry_token"]}},"required":["id","workspaceId","token","ownerId","name","source","sourceResourceId","provider","lastActive","created","updated","_object"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}":{"get":{"operationId":"workspaces.get","tags":["Workspaces"],"summary":"Get a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"workspaces.put","tags":["Workspaces"],"summary":"Update a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The workspace properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":128,"example":"Acme Inc"},"description":{"type":"string","maxLength":2000},"slug":{"type":"string","minLength":4,"maxLength":1024,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","example":"acme-inc"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"llmProvider":{"type":"string","enum":["recommended","openai","anthropic","gemini","deepseek","qwen","kimi","x","z","minimax","custom"]},"llmProviderApiKey":{"type":"string","nullable":true,"minLength":1,"maxLength":2000},"llmProviderBaseUrl":{"type":"string","nullable":true,"maxLength":500,"format":"uri"},"llmModelTiers":{"$ref":"#/components/schemas/CustomModelTiers"},"llmProviderAuthHeader":{"type":"string","nullable":true,"maxLength":100},"llmProviderModelsUrl":{"type":"string","nullable":true,"maxLength":500,"format":"uri"}},"required":["name","description","ownerId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.patch","tags":["Workspaces"],"summary":"Update the fields of a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The workspace properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":128,"example":"Acme Inc"},"description":{"type":"string","maxLength":2000},"slug":{"type":"string","minLength":4,"maxLength":1024,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","example":"acme-inc"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"llmProvider":{"type":"string","enum":["recommended","openai","anthropic","gemini","deepseek","qwen","kimi","x","z","minimax","custom"]},"llmProviderApiKey":{"type":"string","nullable":true,"minLength":1,"maxLength":2000},"llmProviderBaseUrl":{"type":"string","nullable":true,"maxLength":500,"format":"uri"},"llmModelTiers":{"$ref":"#/components/schemas/CustomModelTiers"},"llmProviderAuthHeader":{"type":"string","nullable":true,"maxLength":100},"llmProviderModelsUrl":{"type":"string","nullable":true,"maxLength":500,"format":"uri"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"workspaces.del","tags":["Workspaces"],"summary":"Delete a workspace","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"}},"required":["id"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces":{"get":{"operationId":"workspaces.list","tags":["Workspaces"],"summary":"List workspace","parameters":[{"schema":{"type":"string","enum":["slug","ownerId","name","domain","description","id","createdBy","lastEditedBy","created","updated","llmProvider","llmProviderApiKey","llmProviderBaseUrl","llmModelTiers","llmProviderAuthHeader","llmProviderModelsUrl"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"slug","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"domain","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmProvider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmProviderApiKey","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmProviderBaseUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmModelTiers","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmProviderAuthHeader","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"llmProviderModelsUrl","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Workspace"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"post":{"operationId":"workspaces.post","tags":["Workspaces"],"summary":"Create a new workspace","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"requestBody":{"required":true,"description":"The workspace to create","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":128,"example":"Acme Inc"},"description":{"type":"string","nullable":true,"maxLength":2000},"slug":{"type":"string","minLength":4,"maxLength":128,"example":"acme-inc"},"link":{"type":"boolean","default":false,"description":"Allow anyone with the user domain to automatically join the workspace"},"acceptTerms":{"type":"boolean","enum":[true]}},"required":["name","acceptTerms"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/data":{"delete":{"operationId":"workspaces.purge","tags":["Workspaces"],"summary":"Immediately purge a deleted workspace's data","description":"Short-circuits the 60-day retention window for an explicit customer data-deletion request. The workspace must already be deleted. Owner only.","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"202":{"description":"Request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Request accepted"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"}},"required":["id"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/slug/{slug}":{"get":{"operationId":"workspaces.slug","tags":["Workspaces"],"summary":"Check if a workspace slug already exists","parameters":[{"schema":{"type":"string"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"exists":{"type":"boolean"}},"required":["exists"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/domain/status":{"get":{"operationId":"workspaces.domain.status","tags":["Workspaces"],"summary":"Check the workspace linked to the authenticated user's email domain","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"exists":{"type":"boolean"},"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]},"member":{"type":"boolean"},"atCapacity":{"type":"boolean"},"memberCount":{"type":"number"},"limit":{"type":"number"},"plan":{"type":"string"}},"required":["exists"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/usage/{id}":{"get":{"operationId":"workspaces.usage.get","tags":["Workspaces"],"summary":"Get the monthly usage for a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"plan":{"type":"string"},"limits":{"type":"object","properties":{"maxCloudAccounts":{"type":"number","description":"Max connected cloud accounts"},"maxWorkspaceMembers":{"type":"number","description":"Max members in workspace"},"maxAutomations":{"type":"number","description":"Max automations per workspace"},"maxInvestigationsPerDay":{"type":"number","default":-1,"description":"Max investigations started per rolling 24h"},"includedAutofixesPerMonth":{"type":"number","default":-1,"description":"Autofixes included per billing month"},"maxPrAnalysesPerMonth":{"type":"number","default":-1,"description":"Max PR analyses per billing month"},"minAutomationRunIntervalMinutes":{"type":"number","default":0,"description":"Minimum minutes between two runs of the same automation"}},"required":["maxCloudAccounts","maxWorkspaceMembers","maxAutomations"],"additionalProperties":false},"usage":{"type":"object","properties":{"normalizedTokensPercentage":{"type":"number","description":"Percentage of normalized token budget used in the current billing period"}},"required":["normalizedTokensPercentage"]}},"required":["plan","limits","usage"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/plan/{id}":{"get":{"operationId":"workspaces.plan.get","tags":["Workspaces"],"summary":"Get the current plan and usage for a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"limits":{"type":"object","properties":{"maxCloudAccounts":{"type":"number","description":"Max connected cloud accounts"},"maxWorkspaceMembers":{"type":"number","description":"Max members in workspace"},"maxAutomations":{"type":"number","description":"Max automations per workspace"},"maxInvestigationsPerDay":{"type":"number","default":-1,"description":"Max investigations started per rolling 24h"},"includedAutofixesPerMonth":{"type":"number","default":-1,"description":"Autofixes included per billing month"},"maxPrAnalysesPerMonth":{"type":"number","default":-1,"description":"Max PR analyses per billing month"},"minAutomationRunIntervalMinutes":{"type":"number","default":0,"description":"Minimum minutes between two runs of the same automation"}},"required":["maxCloudAccounts","maxWorkspaceMembers","maxAutomations"],"additionalProperties":false}},"required":["id","name","limits"]},"usage":{"type":"object","properties":{"cloudAccounts":{"type":"object","properties":{"current":{"type":"number"},"limit":{"type":"number"}},"required":["current","limit"]},"normalizedTokens":{"type":"object","properties":{"percentage":{"type":"number"},"atLimit":{"type":"boolean"}},"required":["percentage","atLimit"]},"workspaceMembers":{"type":"object","properties":{"current":{"type":"number"},"limit":{"type":"number"}},"required":["current","limit"]},"automations":{"type":"object","properties":{"current":{"type":"number"},"limit":{"type":"number"}},"required":["current","limit"]},"autofixes":{"type":"object","properties":{"used":{"type":"number"},"included":{"type":"number"},"bundleBalance":{"type":"number"},"overagePolicy":{"type":"string","enum":["block","meter"]},"overageMonthlyCapCents":{"type":"number"}},"required":["used","included","bundleBalance","overagePolicy","overageMonthlyCapCents"]}},"required":["cloudAccounts","normalizedTokens","workspaceMembers","automations","autofixes"]}},"required":["plan","usage"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/workspaces/slug/{slug}":{"get":{"operationId":"workspaces.public.slug","security":[],"tags":["Workspaces"],"summary":"Get public details of a workspace by slug","parameters":[{"schema":{"type":"string"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Public Workspace"}},"required":["message","success","error","result"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/workspaces/{id}":{"get":{"operationId":"workspaces.public.get","security":[],"tags":["Workspaces"],"summary":"Get public details of a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Public Workspace"}},"required":["message","success","error","result"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/observability_settings":{"get":{"operationId":"workspaces.observability_settings.get","tags":["Workspaces"],"summary":"Get observability settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/ObservabilitySettings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.observability_settings.patch","tags":["Workspaces"],"summary":"Partially update observability settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The observability settings fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"nativeObservability":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether native observability (ClickHouse telemetry) is enabled for this workspace"}},"additionalProperties":false}},"required":["nativeObservability"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/ObservabilitySettings"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/investigations_settings":{"get":{"operationId":"workspaces.investigations_settings.get","tags":["Workspaces"],"summary":"Get investigations settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigationsSettings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.investigations_settings.patch","tags":["Workspaces"],"summary":"Partially update investigations settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The investigations settings fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"investigations":{"type":"object","properties":{"passesPerHypothesis":{"type":"integer","minimum":1,"maximum":12,"description":"Number of parallel analysis passes run per hypothesis during an investigation"}},"additionalProperties":false}},"required":["investigations"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigationsSettings"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/digest_settings":{"get":{"operationId":"workspaces.digest_settings.get","tags":["Workspaces"],"summary":"Get weekly digest settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/DigestSettings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.digest_settings.patch","tags":["Workspaces"],"summary":"Enable or disable the weekly digest for a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The digest settings fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether the weekly digest is sent for this workspace"}},"required":["enabled"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/DigestSettings"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/investigation_limits_settings":{"get":{"operationId":"workspaces.investigation_limits_settings.get","tags":["Workspaces"],"summary":"Get investigation limit settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigationLimitsSettings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.investigation_limits_settings.patch","tags":["Workspaces"],"summary":"Update investigation limit settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The investigation limit settings to update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigationLimitsConfig"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigationLimitsSettings"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/investigation_usage":{"get":{"operationId":"workspaces.investigation_usage.get","tags":["Workspaces"],"summary":"Get incident usage for the rolling 24h window","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigationUsage"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/pr_review_settings":{"get":{"operationId":"workspaces.pr_review_settings.get","tags":["Workspaces"],"summary":"Get pull request review settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PrReviewsSettings"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspaces.pr_review_settings.patch","tags":["Workspaces"],"summary":"Update pull request review settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The pull request review settings to update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchPrReviewsConfig"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PrReviewsSettings"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{id}/export":{"post":{"operationId":"workspaces.export","tags":["Workspaces"],"summary":"Start a workspace export","description":"Starts an asynchronous export of the workspace's scan reports, pull request review records, settings, and threads into a downloadable JSON archive. The requester is emailed a download link when the archive is ready. Available to workspace admins and the owner, including for 60 days after the workspace is deleted.","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"id","in":"path"}],"responses":{"202":{"description":"Request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Request accepted"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^file_[0-9a-z]{24}$","description":"ID of the file","example":"file_38mg3o4ibc92h8t2efn8csrh"}},"required":["id"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{workspaceId}/exports/{exportId}":{"get":{"operationId":"workspaces.export.get","tags":["Workspaces"],"summary":"Get the status of a workspace export","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^file_[0-9a-z]{24}$","description":"ID of the file","example":"file_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the file","name":"exportId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^file_[0-9a-z]{24}$","description":"ID of the file","example":"file_38mg3o4ibc92h8t2efn8csrh"},"status":{"type":"string","enum":["pending","ready"]},"size":{"type":"number","nullable":true},"created":{"type":"string","nullable":true},"shareUrl":{"type":"string","nullable":true},"shareExpiresAt":{"type":"string","nullable":true}},"required":["id","status","size","created","shareUrl","shareExpiresAt"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspaces/{workspaceId}/exports/{exportId}/download":{"get":{"operationId":"workspaces.export.download","tags":["Workspaces"],"summary":"Download a workspace export archive","description":"Streams the JSON archive produced by a workspace export. Available to workspace admins and the owner, including for 60 days after the workspace is deleted.","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^file_[0-9a-z]{24}$","description":"ID of the file","example":"file_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the file","name":"exportId","in":"path"}],"responses":{"200":{"description":"The export archive","content":{"application/json":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthenticated"},"403":{"description":"Not authorized for this export"},"404":{"description":"Export not found"}}}},"/v1/workspaces/{workspaceId}/exports/{exportId}/download/{token}":{"get":{"operationId":"workspaces.export.download.shared","security":[],"tags":["Workspaces"],"summary":"Download a workspace export archive with a signed link","description":"Streams the JSON archive produced by a workspace export. The signed time-limited token in the path is the authorization, so the link works from an email or curl without signing in — including for 60 days after the workspace is deleted.","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^file_[0-9a-z]{24}$","description":"ID of the file","example":"file_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the file","name":"exportId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"token","in":"path"}],"responses":{"200":{"description":"The export archive","content":{"application/json":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Unauthenticated"},"403":{"description":"Not authorized for this export"},"404":{"description":"Export not found"}}}},"/v1/invites/{workspaceId}/{id}":{"get":{"operationId":"invites.get","tags":["Invites"],"summary":"Get an invite","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^inv_[0-9a-z]{64}$","description":"ID of the invite","example":"inv_gepzgu225yzyyv9mp485wbjwwrhwgvjwkammgcv5uzm1jorkgeqezkxz7x5ad1ha"},"required":true,"description":"ID of the invite","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Invite"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"invites.del","tags":["Invites"],"summary":"Delete an invite","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^inv_[0-9a-z]{64}$","description":"ID of the invite","example":"inv_gepzgu225yzyyv9mp485wbjwwrhwgvjwkammgcv5uzm1jorkgeqezkxz7x5ad1ha"},"required":true,"description":"ID of the invite","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^inv_[0-9a-z]{64}$","description":"ID of the invite","example":"inv_gepzgu225yzyyv9mp485wbjwwrhwgvjwkammgcv5uzm1jorkgeqezkxz7x5ad1ha"},"_object":{"type":"string","enum":["invite"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/invites/{workspaceId}":{"get":{"operationId":"invites.list","tags":["Invites"],"summary":"List invites","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["email","createdBy","id","acceptedBy","acceptedAt","position","status","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"acceptedAt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"position","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Invite"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/invites":{"post":{"operationId":"invites.post","tags":["Invites"],"summary":"Create an invite","requestBody":{"required":true,"description":"The invite to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"email":{"type":"string","format":"email"},"position":{"type":"string","enum":["admin","member","read-only"]}},"required":["workspaceId","email","position"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Invite"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/invites/{id}":{"put":{"operationId":"invites.put","tags":["Invites"],"summary":"Accept an invite","parameters":[{"schema":{"type":"string","pattern":"^inv_[0-9a-z]{64}$","description":"ID of the invite","example":"inv_gepzgu225yzyyv9mp485wbjwwrhwgvjwkammgcv5uzm1jorkgeqezkxz7x5ad1ha"},"required":true,"description":"ID of the invite","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The email accepting the invite","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Invite"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspace_members/{workspaceId}/{id}":{"get":{"operationId":"workspace_members.get","tags":["Workspace Members"],"summary":"Get a workspace member","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the user","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace Member"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"workspace_member.patch","tags":["Workspace Members"],"summary":"Update the fields of a workspace member","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the user","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The workspace member properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"position":{"type":"string","enum":["owner","admin","member","read-only"]},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"}}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace Member"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"workspace_members.del","tags":["Workspace Members"],"summary":"Delete a workspace member","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the user","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"_object":{"type":"string","enum":["workspace_member"]}},"required":["workspaceId","id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspace_members/{workspaceId}":{"get":{"operationId":"workspace_members.list","tags":["Workspace Members"],"summary":"List workspace members","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["userId","invitedBy","position","lastActive","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"userId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"invitedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"position","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Workspace Member"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/workspace_members/{workspaceId}/guest-link":{"post":{"operationId":"workspace_members.join_via_guest_link","tags":["Workspace Members"],"summary":"Join a workspace as a member using a private-repository PR guest link","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"requestBody":{"required":true,"description":"The signed PR guest link token proving private-repository access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Join Via Guest Link"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace Member"}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Workspace Member"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/scopes":{"get":{"operationId":"scopes.list","tags":["Permission Scopes"],"summary":"List permission scopes","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"description":{"type":"string"},"resource":{"type":"string"},"label":{"type":"string"}},"required":["scope","description","resource","label"]}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/visibilities":{"get":{"operationId":"visibilities.list","tags":["Visibilities"],"summary":"List visibilities","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"description":{"type":"string"},"label":{"type":"string"}},"required":["value","description","label"]}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/sessions/{id}":{"get":{"operationId":"sessions.get","tags":["Sessions"],"summary":"Get a user session","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9]+$","description":"ID of the session","example":""},"required":true,"description":"ID of the session","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Session"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"sessions.del","tags":["Sessions"],"summary":"Delete a user session","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9]+$","description":"ID of the session","example":""},"required":true,"description":"ID of the session","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9]+$","description":"ID of the session","example":""},"_object":{"type":"string","enum":["session"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/sessions":{"get":{"operationId":"sessions.list","tags":["Sessions"],"summary":"List user sessions","parameters":[{"schema":{"type":"string","enum":["id","impersonator","created","updated","expiresAt"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"impersonator","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Session"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/notifications/{id}":{"get":{"operationId":"notifications.get","tags":["Notifications"],"summary":"Get a notification","parameters":[{"schema":{"type":"string","pattern":"^notif_[0-9a-z]{32}$","description":"ID of the notification","example":"notif_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the notification","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Notification"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"notifications.put","tags":["Notifications"],"summary":"Mark a notification as seen","parameters":[{"schema":{"type":"string","pattern":"^notif_[0-9a-z]{32}$","description":"ID of the notification","example":"notif_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the notification","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Notification"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"notifications.del","tags":["Notifications"],"summary":"Delete a notification","parameters":[{"schema":{"type":"string","pattern":"^notif_[0-9a-z]{32}$","description":"ID of the notification","example":"notif_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the notification","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^notif_[0-9a-z]{32}$","description":"ID of the notification","example":"notif_d18564pxsvozx979j3532mii2kk7pmw6"},"_object":{"type":"string","enum":["notification"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/notifications":{"get":{"operationId":"notifications.list","tags":["Notifications"],"summary":"List notifications","parameters":[{"schema":{"type":"string","enum":["id","workspaceId","category","triggerId","title","body","action","ctaUrl","cta","priority","metadata","updated","created","seen","deleted"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"workspaceId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"category","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"triggerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"body","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"priority","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"metadata","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"updated","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"seen","in":"query"},{"schema":{"type":"string","enum":["new","all"]},"required":true,"name":"status","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Notification"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/oauth_clients/{id}":{"get":{"operationId":"oauth_clients.public.get","security":[],"tags":["OAuth Clients"],"summary":"Get an OAuth client","parameters":[{"schema":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"required":true,"description":"ID of the oauth_client","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client"}},"required":["message","success","error","result"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/oauth_clients/{workspaceId}":{"get":{"operationId":"oauth_clients.public.list","security":[],"tags":["OAuth Clients"],"summary":"List OAuth clients","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","description","email","logoUrl","websiteUrl","privacyPolicyUrl","termsOfServiceUrl","isActive","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"email","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"logoUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"websiteUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"privacyPolicyUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"termsOfServiceUrl","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OAuth Client"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/oauth_clients":{"post":{"operationId":"oauth_clients.create","tags":["OAuth Clients"],"summary":"Create an OAuth client","requestBody":{"required":true,"description":"The client to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"name":{"type":"string","minLength":4,"maxLength":256},"description":{"type":"string"},"email":{"type":"string","format":"email"},"redirectUris":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"},"minItems":1},"logoUrl":{"type":"string","format":"uri"},"websiteUrl":{"type":"string","format":"uri"},"privacyPolicyUrl":{"type":"string","format":"uri"},"termsOfServiceUrl":{"type":"string","format":"uri"}},"required":["workspaceId","name","email","redirectUris","scopes"]}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/oauth_clients/{workspaceId}/{id}":{"get":{"operationId":"oauth_clients.get","tags":["OAuth Clients"],"summary":"Get an OAuth client","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"required":true,"description":"ID of the oauth_client","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"oauth_clients.update","tags":["OAuth Clients"],"summary":"Update an OAuth client","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"required":true,"description":"ID of the oauth_client","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The client to edit","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256},"description":{"type":"string"},"email":{"type":"string","format":"email"},"redirectUris":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"},"minItems":1},"logoUrl":{"type":"string","format":"uri"},"websiteUrl":{"type":"string","format":"uri"},"privacyPolicyUrl":{"type":"string","format":"uri"},"termsOfServiceUrl":{"type":"string","format":"uri"},"isActive":{"type":"boolean"}},"required":["name","description","email","redirectUris","scopes"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"oauth_clients.patch","tags":["OAuth Clients"],"summary":"Update the fields of an OAuth client","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"required":true,"description":"ID of the oauth_client","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The OAuth client properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256},"description":{"type":"string"},"email":{"type":"string","format":"email"},"redirectUris":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"},"minItems":1},"logoUrl":{"type":"string","format":"uri"},"websiteUrl":{"type":"string","format":"uri"},"privacyPolicyUrl":{"type":"string","format":"uri"},"termsOfServiceUrl":{"type":"string","format":"uri"},"isActive":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"oauth_clients.delete","tags":["OAuth Clients"],"summary":"Delete an OAuth client","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"required":true,"description":"ID of the oauth_client","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"_object":{"type":"string","enum":["oauth_client"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/oauth_clients/{workspaceId}":{"get":{"operationId":"oauth_clients.list","tags":["OAuth Clients"],"summary":"List OAuth clients","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","description","email","logoUrl","websiteUrl","privacyPolicyUrl","termsOfServiceUrl","isActive","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"email","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"logoUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"websiteUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"privacyPolicyUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"termsOfServiceUrl","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OAuth Client"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/oauth_clients/rotate_secret":{"post":{"operationId":"oauth_clients.rotate_secret","tags":["OAuth Clients"],"summary":"Rotate the secret of an OAuth client","description":"Generates a new client secret and invalidates the previous one immediately.","x-polylane-banned-from":["private","hypothesis","investigation","automation","autofix"],"requestBody":{"required":true,"description":"The OAuth client whose secret to rotate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^oauth_client_[0-9a-z]{24}$","description":"ID of the oauth_client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/OAuth Client With Secret"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/oauth/authorize":{"post":{"operationId":"oauth.authorizeConsent","tags":["OAuth"],"summary":"OAuth authorization consent","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string","description":"The client identifier issued to the client during registration","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"redirect_uri":{"type":"string","format":"uri","description":"The absolute URI to which the authorization server will redirect the user-agent after authorization is granted or denied. Must match one of the registered redirect URIs.","example":"https://app.example.com/oauth/callback"},"scope":{"type":"string","description":"Space-delimited list of scopes that identify the resources that the client is requesting access to","example":"read:user read:email write:repo"},"state":{"type":"string","description":"An opaque value used by the client to maintain state between the request and callback. The authorization server includes this value when redirecting back to the client. Used to prevent CSRF attacks.","example":"af0ifjsldkj3423ljasdf3"},"code_challenge":{"type":"string","description":"PKCE (RFC 7636) code challenge. Required for all clients.","example":"E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM"},"code_challenge_method":{"type":"string","enum":["plain","S256"],"default":"S256","description":"PKCE code challenge method. Defaults to 'S256'.","example":"S256"},"approved":{"type":"boolean","description":"Indicates whether the user has approved the authorization request. Set to true when the user clicks 'Allow' or 'Approve', false when they click 'Deny'.","example":true}},"required":["client_id","redirect_uri","scope","code_challenge","approved"],"description":"OAuth 2.0 authorization request parameters. Used when redirecting the user to the authorization endpoint or processing the user's authorization decision."}}}},"responses":{"200":{"description":"Returns redirect URI with authorization code","content":{"application/json":{"schema":{"type":"object","properties":{"redirect_uri":{"type":"string"}},"required":["redirect_uri"]}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"}}}},"/v1/oauth/token":{"post":{"operationId":"oauth.token","security":[],"tags":["OAuth"],"summary":"OAuth token endpoint","requestBody":{"required":true,"description":"The token request","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"grant_type":{"type":"string","enum":["authorization_code"],"description":"The grant type for the token request. Use 'authorization_code' for initial authentication.","example":"authorization_code"},"code":{"type":"string","description":"The authorization code received from the authorization server","example":"oauth_code_9b2l4opxmvjk6wy7f3dg8szn"},"redirect_uri":{"type":"string","description":"The redirect URI that was used in the authorization request. Must match exactly.","example":"https://app.example.com/oauth/callback"},"client_id":{"type":"string","description":"The client identifier issued to the client during registration","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"client_secret":{"type":"string","description":"The client secret. Required for confidential clients."},"code_verifier":{"type":"string","description":"The PKCE code verifier. Required for all token requests.","example":"dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"}},"required":["grant_type","code","redirect_uri","client_id","client_secret","code_verifier"],"description":"Token request using authorization code grant type"},{"type":"object","properties":{"grant_type":{"type":"string","enum":["refresh_token"],"description":"The grant type for the token request. Use 'refresh_token' to refresh an access token.","example":"refresh_token"},"refresh_token":{"type":"string","description":"The refresh token issued to the client","example":"oauth_refresh_m4k8sz2nwp9l3x6v7jbgqfth"},"client_id":{"type":"string","description":"The client identifier issued to the client during registration","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"client_secret":{"type":"string","description":"The client secret. Required for confidential clients."},"scope":{"type":"string","description":"The requested scope of the access token. If omitted, the scope is unchanged from the original authorization.","example":"read:user read:email"}},"required":["grant_type","refresh_token","client_id","client_secret"],"description":"Token request using refresh token grant type"}],"discriminator":{"propertyName":"grant_type","mapping":{"authorization_code":"AuthorizationCodeRequest","refresh_token":"RefreshTokenRequest"}},"description":"OAuth 2.0 token request. Supports authorization code and refresh token grant types."}}}},"responses":{"200":{"description":"Token issued successfully","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string","description":"The access token issued by the authorization server"},"token_type":{"type":"string","enum":["Bearer"],"description":"The type of token issued. Always 'Bearer' for OAuth 2.0.","example":"Bearer"},"expires_in":{"type":"number","description":"The lifetime in seconds of the access token","example":3600},"refresh_token":{"type":"string","description":"The refresh token, which can be used to obtain new access tokens","example":"oauth_refresh_m4k8sz2nwp9l3x6v7jbgqfth"},"scope":{"type":"string","description":"The scope of the access token. Space-delimited list of granted scopes.","example":"read:user read:email"}},"required":["access_token","token_type","expires_in","refresh_token","scope"],"description":"Successful OAuth 2.0 token response"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid client credentials"}}}},"/v1/oauth/introspect":{"post":{"operationId":"oauth.introspect","tags":["OAuth"],"summary":"OAuth token introspection","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"token_type_hint":{"type":"string","enum":["access_token"]},"client_id":{"type":"string"},"client_secret":{"type":"string"}},"required":["token","client_id","client_secret"]}}}},"responses":{"200":{"description":"Token introspection result","content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"scope":{"type":"string"},"client_id":{"type":"string"},"username":{"type":"string"},"exp":{"type":"number"},"iat":{"type":"number"},"sub":{"type":"string"}},"required":["active"]}}}},"401":{"description":"Invalid client credentials"}}}},"/v1/oauth/userinfo":{"get":{"operationId":"oauth.userinfo","security":[{"Bearer":[]}],"tags":["OAuth"],"summary":"OAuth user info","responses":{"200":{"description":"User information","content":{"application/json":{"schema":{"type":"object","properties":{"sub":{"type":"string"},"name":{"type":"string"},"given_name":{"type":"string"},"family_name":{"type":"string"},"email":{"type":"string"},"email_verified":{"type":"boolean"},"username":{"type":"string"},"created_at":{"type":"number"},"updated_at":{"type":"number"}},"required":["sub"]}}}},"401":{"description":"Invalid or expired access token"}}}},"/v1/oauth/revoke":{"post":{"operationId":"oauth.revoke","security":[],"tags":["OAuth"],"summary":"OAuth token revocation","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"The token to revoke"},"token_type_hint":{"type":"string","enum":["access_token","refresh_token"],"description":"A hint about the type of the token submitted for revocation"},"client_id":{"type":"string","description":"The client identifier"},"client_secret":{"type":"string","description":"The client secret"}},"required":["token","client_id","client_secret"]}}}},"responses":{"200":{"description":"Token revoked successfully (or was already invalid)"},"401":{"description":"Invalid client credentials"}}}},"/v1/.well-known/openid-configuration":{"get":{"operationId":"oauth.wellKnown","tags":["OAuth"],"summary":"OpenID Connect discovery endpoint","responses":{"200":{"description":"OpenID configuration","content":{"application/json":{"schema":{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"jwks_uri":{"type":"string"},"response_types_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"scopes_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"claims_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"introspection_endpoint":{"type":"string"},"revocation_endpoint":{"type":"string"},"revocation_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}}},"required":["issuer","authorization_endpoint","token_endpoint","userinfo_endpoint","response_types_supported","subject_types_supported","scopes_supported","token_endpoint_auth_methods_supported","claims_supported","code_challenge_methods_supported","grant_types_supported","introspection_endpoint"]}}}}}}},"/v1/.well-known/oauth-authorization-server":{"get":{"operationId":"oauth.wellKnownRFC8414","tags":["OAuth"],"summary":"OAuth authorization server metadata (RFC 8414)","responses":{"200":{"description":"OAuth authorization server metadata (RFC 8414)","content":{"application/json":{"schema":{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"jwks_uri":{"type":"string"},"response_types_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"scopes_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"claims_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"introspection_endpoint":{"type":"string"},"revocation_endpoint":{"type":"string"},"revocation_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}}},"required":["issuer","authorization_endpoint","token_endpoint","userinfo_endpoint","response_types_supported","subject_types_supported","scopes_supported","token_endpoint_auth_methods_supported","claims_supported","code_challenge_methods_supported","grant_types_supported","introspection_endpoint"]}}}}}}},"/v1/public/llm_providers":{"get":{"operationId":"llmProviders.list","tags":["LlmProviders"],"summary":"List LLM providers","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"icon":{"type":"string"}},"required":["value","label","icon"]}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/plans":{"get":{"operationId":"plans.get","tags":["Plans"],"summary":"Get all available plans","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"limits":{"type":"object","properties":{"maxCloudAccounts":{"type":"number","description":"Max connected cloud accounts"},"maxWorkspaceMembers":{"type":"number","description":"Max members in workspace"},"maxAutomations":{"type":"number","description":"Max automations per workspace"},"maxInvestigationsPerDay":{"type":"number","default":-1,"description":"Max investigations started per rolling 24h"},"includedAutofixesPerMonth":{"type":"number","default":-1,"description":"Autofixes included per billing month"},"maxPrAnalysesPerMonth":{"type":"number","default":-1,"description":"Max PR analyses per billing month"},"minAutomationRunIntervalMinutes":{"type":"number","default":0,"description":"Minimum minutes between two runs of the same automation"}},"required":["maxCloudAccounts","maxWorkspaceMembers","maxAutomations"],"additionalProperties":false}},"required":["id","name","limits"]}}},"required":["plans"]}},"required":["message","success","error","result"]}}}}}}},"/v1/teams":{"post":{"operationId":"teams.post","tags":["Teams"],"summary":"Create a team","requestBody":{"required":true,"description":"The team to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Team name"},"slug":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","description":"URL-friendly identifier. Auto-generated from name if not provided."},"description":{"type":"string","maxLength":2000,"description":"Team description"},"color":{"type":"string","maxLength":32,"description":"Hex color for UI badges"},"icon":{"type":"string","maxLength":64,"description":"Icon identifier"}},"required":["workspaceId","name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Team"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/{workspaceId}":{"get":{"operationId":"teams.list","tags":["Teams"],"summary":"List teams","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","slug","description","color","icon","createdBy","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"slug","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"color","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"icon","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Team"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/{workspaceId}/mine":{"get":{"operationId":"teams.mine","tags":["Teams"],"summary":"List teams the current user belongs to","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Team"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/{workspaceId}/{teamId}":{"get":{"operationId":"teams.get","tags":["Teams"],"summary":"Get a team","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the team","name":"teamId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Team"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"teams.del","tags":["Teams"],"summary":"Delete a team","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the team","name":"teamId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Team"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/{teamId}":{"patch":{"operationId":"teams.patch","tags":["Teams"],"summary":"Update a team","parameters":[{"schema":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the team","name":"teamId","in":"path"}],"requestBody":{"required":true,"description":"The team fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Team name"},"slug":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","description":"URL-friendly identifier"},"description":{"type":"string","nullable":true,"maxLength":2000,"description":"Team description"},"color":{"type":"string","nullable":true,"maxLength":32,"description":"Hex color"},"icon":{"type":"string","nullable":true,"maxLength":64,"description":"Icon identifier"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Team"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/members":{"post":{"operationId":"team_members.post","tags":["Teams"],"summary":"Add a member to a team","requestBody":{"required":true,"description":"The user to add to the team","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"teamId":{"type":"string","pattern":"^team_[0-9a-z]{24}$","example":"team_38mg3o4ibc92h8t2efn8csrh","description":"Team ID"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"User to add"}},"required":["workspaceId","teamId","userId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/TeamMember"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/{workspaceId}/{teamId}/members":{"get":{"operationId":"team_members.list","tags":["Teams"],"summary":"List members of a team","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the team","name":"teamId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TeamMember"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/teams/members/remove":{"post":{"operationId":"team_members.del","tags":["Teams"],"summary":"Remove a member from a team","requestBody":{"required":true,"description":"The user to remove from the team","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"teamId":{"type":"string","pattern":"^team_[0-9a-z]{24}$","example":"team_38mg3o4ibc92h8t2efn8csrh","description":"Team ID"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"User to remove"}},"required":["workspaceId","teamId","userId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/labels":{"post":{"operationId":"labels.post","tags":["Labels"],"summary":"Create a label","requestBody":{"required":true,"description":"The label to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Label name"},"color":{"type":"string","maxLength":32,"description":"Hex color code"},"description":{"type":"string","maxLength":500,"description":"Label description"}},"required":["workspaceId","name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Label"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/labels/{workspaceId}":{"get":{"operationId":"labels.list","tags":["Labels"],"summary":"List labels","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","color","description","createdBy","created","updated"],"default":"name"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"color","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Label"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/labels/{workspaceId}/{labelId}":{"get":{"operationId":"labels.get","tags":["Labels"],"summary":"Get a label","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the label"},"required":true,"description":"ID of the label","name":"labelId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Label"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"labels.del","tags":["Labels"],"summary":"Delete a label","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the label"},"required":true,"description":"ID of the label","name":"labelId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Label"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/labels/{labelId}":{"patch":{"operationId":"labels.patch","tags":["Labels"],"summary":"Update a label","parameters":[{"schema":{"type":"string","description":"ID of the label"},"required":true,"description":"ID of the label","name":"labelId","in":"path"}],"requestBody":{"required":true,"description":"The label fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Label name"},"color":{"type":"string","maxLength":32,"description":"Hex color code"},"description":{"type":"string","nullable":true,"maxLength":500,"description":"Label description"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Label"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/terminal/reset":{"post":{"operationId":"terminal.reset","tags":["Repositories"],"summary":"Reset terminal sandbox environment","requestBody":{"required":true,"description":"Reset terminal sandbox","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace ID"},"repositoryId":{"type":"string","description":"Repository ID"}},"required":["workspaceId","repositoryId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"reset":{"type":"boolean"}},"required":["reset"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/environment":{"get":{"operationId":"repositories.environment.get","tags":["Repositories"],"summary":"Get repository environment configuration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryEnvironment"}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryEnvironment"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"repositories.environment.put","tags":["Repositories"],"summary":"Create or update repository environment configuration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The environment configuration to create or update","content":{"application/json":{"schema":{"type":"object","properties":{"containerImage":{"type":"string","default":"universal","description":"Container base image name"},"preinstalledPackages":{"allOf":[{"$ref":"#/components/schemas/PreinstalledPackages"},{"description":"Runtime versions to pre-install"}]},"setupScriptMode":{"type":"string","enum":["automatic","manual"],"default":"automatic","description":"Automatic or manual dependency installation"},"setupScript":{"type":"string","nullable":true,"default":null,"description":"Manual bash setup script"},"maintenanceScript":{"type":"string","nullable":true,"default":null,"description":"Bash script for cached container resumption"},"prReviewInstructions":{"type":"string","nullable":true,"default":null,"description":"Repository-specific instructions for the pull request production-impact review"},"prReviewCheckDisabledAt":{"type":"string","nullable":true,"format":"date-time","default":null,"description":"When null, the pull request review posts a GitHub check that fails on production concerns, so branch protection can block merging; set to disable the check"},"prReviewsDisabledAt":{"type":"string","nullable":true,"format":"date-time","default":null,"description":"When set, pull requests on this repository are not reviewed for production impact"},"envVars":{"type":"object","additionalProperties":{"type":"string"},"default":{},"description":"Environment variables for sandbox"},"secrets":{"type":"object","additionalProperties":{"type":"string"},"default":{},"description":"Secrets (encrypted at rest, available only during setup)"},"cachingEnabled":{"type":"boolean","default":true,"description":"Enable container state caching"},"internetAccess":{"type":"string","enum":["off","on"],"default":"off","description":"Agent internet access mode"},"domainAllowlistPreset":{"type":"string","enum":["none","common_dependencies","all"],"default":"none","description":"Preset domain allowlist"},"domainAllowlistCustom":{"type":"array","items":{"type":"string"},"default":[],"description":"Custom allowed domains"},"allowedHttpMethods":{"type":"array","items":{"type":"string"},"default":["GET","HEAD","OPTIONS"],"description":"Allowed HTTP methods for outbound requests"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryEnvironment"}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryEnvironment"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"repositories.environment.delete","tags":["Repositories"],"summary":"Delete repository environment configuration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/environment/reset-cache":{"post":{"operationId":"repositories.environment.resetCache","tags":["Repositories"],"summary":"Reset repository environment cache","requestBody":{"required":true,"description":"Reset cache request","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace ID"},"repositoryId":{"type":"string","description":"Repository ID"}},"required":["workspaceId","repositoryId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"reset":{"type":"boolean"}},"required":["reset"]}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"reset":{"type":"boolean"}},"required":["reset"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/environment/detect":{"post":{"operationId":"repositories.environment.detect","tags":["Repositories"],"summary":"Detect repository environment configuration from codebase","requestBody":{"required":true,"description":"Detect environment request","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace ID"},"repositoryId":{"type":"string","description":"Repository ID"}},"required":["workspaceId","repositoryId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"packageManager":{"type":"string","nullable":true,"description":"Detected package manager"},"installCommand":{"type":"string","nullable":true,"description":"Generated install command"},"lockFile":{"type":"string","nullable":true,"description":"Detected lock file"},"runtimeHints":{"allOf":[{"$ref":"#/components/schemas/PreinstalledPackages"},{"description":"Suggested runtime versions"}]}},"required":["packageManager","installCommand","lockFile","runtimeHints"]}},"required":["message","success","error","result"]}}}},"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"packageManager":{"type":"string","nullable":true,"description":"Detected package manager"},"installCommand":{"type":"string","nullable":true,"description":"Generated install command"},"lockFile":{"type":"string","nullable":true,"description":"Detected lock file"},"runtimeHints":{"allOf":[{"$ref":"#/components/schemas/PreinstalledPackages"},{"description":"Suggested runtime versions"}]}},"required":["packageManager","installCommand","lockFile","runtimeHints"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}":{"get":{"operationId":"repositories.get","tags":["Repositories"],"summary":"Get a repository","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Repository"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"repositories.put","tags":["Repositories"],"summary":"Update a repository","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The repository properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Description of the repository"},"keywords":{"type":"array","items":{"type":"string"},"description":"Key topics of the repository"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"disabled":{"type":"boolean","nullable":true},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"required":["keywords","disabled"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Repository"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"repositories.patch","tags":["Repositories"],"summary":"Update the fields of a repository","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The repository properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Description of the repository"},"keywords":{"type":"array","items":{"type":"string"},"description":"Key topics of the repository"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"disabled":{"type":"boolean","nullable":true},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Repository"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"repositories.del","tags":["Repositories"],"summary":"Delete a repository","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["repository"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/instrumentation":{"get":{"operationId":"repositories.instrumentation","tags":["Repositories"],"summary":"Observability instrumentation report for a repository: route coverage plus the open findings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryInstrumentationReport"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/advisories/{advisoryId}/dismissal":{"post":{"operationId":"repositories.advisory_dismissal","tags":["Repositories"],"summary":"Ignore or restore an observability finding for a repository","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the repository"},"required":true,"description":"ID of the repository","name":"id","in":"path"},{"schema":{"type":"string","description":"ID of the finding"},"required":true,"description":"ID of the finding","name":"advisoryId","in":"path"}],"requestBody":{"required":true,"description":"The desired dismissal state","content":{"application/json":{"schema":{"type":"object","properties":{"dismissed":{"type":"boolean","description":"true ignores this finding; false restores it"}},"required":["dismissed"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RepositoryAdvisoryDismissal"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/changes":{"get":{"operationId":"repositories.changes.list","tags":["Repositories"],"summary":"List pull request change intelligence records for a repository","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the repository"},"required":true,"description":"ID of the repository","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PrChangeRecord"}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/changes/{changeId}":{"get":{"operationId":"repositories.changes.get","tags":["Repositories"],"summary":"Get a pull request change intelligence record","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the repository"},"required":true,"description":"ID of the repository","name":"id","in":"path"},{"schema":{"type":"string","description":"ID of the pull request change record"},"required":true,"description":"ID of the pull request change record","name":"changeId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PrChangeRecordDetail"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/changes/{changeId}/dismissal":{"post":{"operationId":"repositories.changes.dismiss","tags":["Repositories"],"summary":"Ignore or restore a pull request change intelligence record","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the repository"},"required":true,"description":"ID of the repository","name":"id","in":"path"},{"schema":{"type":"string","description":"ID of the pull request change record"},"required":true,"description":"ID of the pull request change record","name":"changeId","in":"path"}],"requestBody":{"required":true,"description":"The desired dismissal state","content":{"application/json":{"schema":{"type":"object","properties":{"dismissed":{"type":"boolean","description":"true ignores this analysis and stops comments on the pull request; false restores it"}},"required":["dismissed"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PrChangeRecordDismissal"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}/{id}/changes/{changeId}/fix":{"post":{"operationId":"repositories.changes.fix","tags":["Repositories"],"summary":"Start an autofix that addresses a failed pull request review","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the repository"},"required":true,"description":"ID of the repository","name":"id","in":"path"},{"schema":{"type":"string","description":"ID of the pull request change record"},"required":true,"description":"ID of the pull request change record","name":"changeId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PrChangeRecordFix"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/{workspaceId}":{"get":{"operationId":"repositories.list","tags":["Repositories"],"summary":"List repositories","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["remoteId","id","name","description","createdBy","lastEditedBy","integrationId","owner","provider","status","lastSync","created","updated","disabled","pendingSyncs","pendingChildWorkflows"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"remoteId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"integrationId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"owner","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastSync","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"pendingSyncs","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"pendingChildWorkflows","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Repository"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/search":{"post":{"operationId":"repositories.search","tags":["Repositories"],"summary":"Search repositories","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"remoteId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"integrationId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"owner","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastSync","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"pendingSyncs","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"pendingChildWorkflows","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search repositories","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"prompt":{"type":"string","nullable":true}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Repository"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories":{"post":{"operationId":"repositories.post","tags":["Repositories"],"summary":"Add a new repository","requestBody":{"required":true,"description":"The repository to add","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"url":{"type":"string","format":"uri","description":"The URL of the public repository to index"},"provider":{"type":"string","enum":["github"]}},"required":["workspaceId","url","provider"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Repository"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/search":{"post":{"operationId":"repositories.codefiles.search","tags":["Repositories"],"summary":"Search a codebase","parameters":[{"schema":{"type":"string","enum":["id","path","sha","symbol","type","language","start","end","branch","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":1000,"default":1000},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"path","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"symbol","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"language","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"branch","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"created","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"updated","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search a codebase","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"prompt":{"type":"string","nullable":true}},"required":["workspaceId","id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Code Chunk"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/sync":{"post":{"operationId":"repositories.codefiles.sync","tags":["Repositories"],"summary":"Sync a repository codebase","requestBody":{"required":true,"description":"The repository to sync","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string"}},"required":["workspaceId","id"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/contents":{"post":{"operationId":"repositories.codefiles.contents","tags":["Repositories"],"summary":"Get the contents of a code file","requestBody":{"required":true,"description":"The document to fetch","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"repositoryId":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"path":{"type":"string"}},"required":["workspaceId","repositoryId","path"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"codefile":{"$ref":"#/components/schemas/Code File"},"contents":{"type":"string"}},"required":["codefile","contents"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/{workspaceId}/{repositoryId}":{"get":{"operationId":"repositories.codefiles.list","tags":["Repositories"],"summary":"List indexed code files","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"repositoryId","in":"path"},{"schema":{"type":"string","enum":["path","branch","sha","language","lastSync","status","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":500,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"path","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"branch","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sha","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"language","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastSync","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Code File"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/{workspaceId}/{repositoryId}/tree":{"get":{"operationId":"repositories.codefiles.tree","tags":["Repositories"],"summary":"Get file tree for a directory","description":"Returns immediate children (files and directories) of a given directory path, similar to GitHub's tree API.","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the repository","name":"repositoryId","in":"path"},{"schema":{"type":"string","default":"","description":"Directory path to list children of. Empty string for root.","example":"src/components"},"required":false,"description":"Directory path to list children of. Empty string for root.","name":"path","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the file or directory","example":"src"},"path":{"type":"string","description":"Full path to the file or directory","example":"packages/api/src"},"type":{"type":"string","enum":["file","directory"],"description":"Type of the item","example":"directory"},"language":{"type":"string","nullable":true,"description":"Programming language for files","example":"typescript"},"status":{"type":"string","nullable":true,"enum":["ready","syncing","new","failed",null],"description":"Sync status for files. Null for directories.","example":"ready"}},"required":["name","path","type","language","status"]}},"totalCount":{"type":"number"}},"required":["items","totalCount"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/repositories/codefiles/sync-file":{"post":{"operationId":"repositories.codefiles.syncFile","tags":["Repositories"],"summary":"Sync a single code file","description":"Triggers syncing of a specific file in the repository. Useful when file indexing has issues.","requestBody":{"required":true,"description":"The file to sync","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"repositoryId":{"type":"string","description":"ID of the repository"},"path":{"type":"string","description":"Path of the file to sync"}},"required":["workspaceId","repositoryId","path"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"path":{"type":"string"},"status":{"type":"string"}},"required":["path","status"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/maps":{"post":{"operationId":"maps.public.publish","security":[],"tags":["Maps"],"summary":"Publish or update a public map","description":"Create a public map by posting a map document, or update an existing one by posting { data, editToken }. Contract violations return 422 with error.metadata.violations.","responses":{"200":{"description":"Map updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapPublishResponse"}}}},"201":{"description":"Map created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapPublishResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"422":{"description":"Unprocessable content","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unprocessable content"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"get":{"operationId":"maps.public.list","security":[],"tags":["Maps"],"summary":"List published maps","parameters":[{"schema":{"type":"string","enum":["score","recent"],"default":"score"},"required":false,"name":"sort","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PublicMapList"}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/maps/{slug}":{"get":{"operationId":"maps.public.get","security":[],"tags":["Maps"],"summary":"Get a public map","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,47}-[a-z0-9]{6}$","example":"acme-x7k2p9"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/PublicMap"}},"required":["message","success","error","result"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"maps.public.delete","security":[],"tags":["Maps"],"summary":"Delete a public map","description":"Requires the map's edit token, passed as an x-edit-token header or a JSON body { editToken }.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,47}-[a-z0-9]{6}$","example":"acme-x7k2p9"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/MapDeleteResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/maps/{slug}/claim":{"post":{"operationId":"maps.claim","tags":["Maps"],"summary":"Claim a public map for a workspace","description":"Binds the map to the workspace and removes its expiry. Claimed maps stay updatable only through the edit token.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,47}-[a-z0-9]{6}$","example":"acme-x7k2p9"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"description":"The workspace claiming the map","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapClaimBody"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/MapClaimResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/integrations/catalog":{"get":{"operationId":"integrations.public.catalog","security":[],"tags":["Integrations"],"summary":"Get the public integrations and cloud providers catalog","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"category":{"type":"string","enum":["tool","cloud"]},"subcategory":{"type":"string","enum":["git","observability","communication","knowledge-base","issue-tracking","incident-management","ci-cd","product-analytics","cloud","protocol","code-agent"]},"name":{"type":"string"},"description":{"type":"string"},"longDescription":{"type":"string"},"icon":{"type":"string"},"comingSoon":{"type":"boolean"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"summary":{"type":"string"}},"required":["name","summary"]}},"supportedResources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"}},"required":["type","name","icon"]}},"triggers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"}},"required":["type","name","description","icon"]}},"automationTemplates":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"triggerTypes":{"type":"array","items":{"type":"string"}}},"required":["slug","name","description","triggerTypes"]}},"automationActions":{"type":"array","items":{"type":"object","properties":{"actionType":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"}},"required":["actionType","name","description","icon"]}},"recommendedTemplateSlug":{"type":"string"},"marketing":{"type":"object","properties":{"whatPolylaneDoes":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"body":{"type":"string"}},"required":["title","body"]}},"howItWorks":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"body":{"type":"string"}},"required":["title","body"]}}},"required":["whatPolylaneDoes","howItWorks"],"description":"Marketing content for polylane.com/integrations: what Polylane does with this integration and how it works."},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["integration_catalog_item"]}},"required":["type","category","subcategory","name","description","longDescription","icon","comingSoon","tools","supportedResources","triggers","automationTemplates","automationActions","_object"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/slack/generate":{"post":{"operationId":"integrations.slack.generate","tags":["Integrations"],"summary":"Generate Slack OAuth install URL","requestBody":{"required":true,"description":"Workspace to connect Slack to","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"url":{"type":"string"},"state":{"type":"string"}},"required":["url","state"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/{workspaceId}/slack/{id}/channels":{"get":{"operationId":"integrations.slack.channels","tags":["Integrations"],"summary":"List Slack channels the bot can post in","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"channels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"isPrivate":{"type":"boolean"},"isMember":{"type":"boolean"},"numMembers":{"type":"number"}},"required":["id","name","isPrivate","isMember"]}},"nextCursor":{"type":"string"}},"required":["channels"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/{workspaceId}/recommended":{"get":{"operationId":"integrations.recommended","tags":["Integrations"],"summary":"Get the recommended automation template for a provider","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","aws","vercel","cloudflare","fly","render","sentry","cloudwatch","devin","cursor","factory"]},"required":true,"name":"provider","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"longDescription":{"type":"string"},"category":{"type":"string","enum":["observability","ci-cd","infrastructure","scheduled","platform"]},"subcategory":{"type":"string","enum":["alert-triage","code-review","deployment","workflow-analysis","release","security","reporting","infrastructure-monitoring","cron","webhook","platform-events"]},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]}},"instructions":{"type":"string"},"providers":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","aws","vercel","cloudflare","fly","render","sentry","cloudwatch","devin","cursor","factory"]}},"tags":{"type":"array","items":{"type":"string","enum":["alerts","triage","incident-response","code-review","security","quality","deployment","health-check","metrics","audit","observability","coverage","digest","reporting","code-changes","on-call","handoff","incident-summary","automation","labeling","code-ownership","error-rate","correlation","dora","deployment-frequency","infrastructure","cost","traffic","anomaly-detection","weekly","staging","validation","smoke-tests","slo","sla","error-budget","change-management","risk-assessment","drift-detection","compliance","investigation","follow-up","discovery","sync","summary","onboarding","security-audit","documentation","rollback","canary","feature-flags","dependency","vulnerability","cve","latency","performance","capacity","dns","ssl","certificates","release-notes","changelog","permissions","iam","access-control","database","migration","schema","logging","log-analysis","toil","cleanup","hygiene","budget","spend","optimization","runbook","playbook","postmortem","retrospective","workflow","ci-cd","pipeline","api","breaking-changes","versioning","monitoring","alerting","dashboards","secrets","rotation","credentials","backup","disaster-recovery","tagging","governance","noise-reduction","deduplication","escalation","routing","babysit"]}},"delayMs":{"type":"number"},"passCount":{"type":"number"},"cronExpression":{"type":"string"},"cronTimezone":{"type":"string"},"icons":{"type":"array","items":{"type":"string"}}},"required":["slug","name","description","longDescription","category","subcategory","triggerTypes","instructions","providers","tags","delayMs","icons"]}},"connectedProviders":{"type":"array","items":{"type":"string"}},"alternativeCount":{"type":"number"}},"required":["templates","connectedProviders","alternativeCount"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/github/generate":{"post":{"operationId":"integrations.github.generate","tags":["Integrations"],"summary":"Generate GitHub app integration url","requestBody":{"required":true,"description":"The params to generate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"}},"required":["workspaceId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/mcp/connect":{"post":{"operationId":"integrations.mcp.connect","tags":["Integrations"],"summary":"Connect an MCP server","requestBody":{"required":true,"description":"MCP server connection details","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["mcp"]},"workspaceId":{"type":"string"},"url":{"type":"string","format":"uri"},"name":{"type":"string","minLength":1,"maxLength":64},"transport":{"type":"string","enum":["http","sse"],"default":"http"},"bearerToken":{"type":"string"},"extraHeaders":{"type":"object","additionalProperties":{"type":"string"}}},"required":["type","workspaceId","url","name"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/mcp/validate":{"post":{"operationId":"integrations.mcp.validate","tags":["Integrations"],"summary":"Validate an MCP server connection without persisting it","requestBody":{"required":true,"description":"MCP server credentials to validate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"url":{"type":"string","format":"uri"},"transport":{"type":"string","enum":["http","sse"],"default":"http"},"bearerToken":{"type":"string"},"extraHeaders":{"type":"object","additionalProperties":{"type":"string"}}},"required":["workspaceId","url"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"serverInfo":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"protocolVersion":{"type":"string"}}},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{"nullable":true}}},"required":["name"]}}},"required":["serverInfo","tools"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/mcp/refresh-tools":{"post":{"operationId":"integrations.mcp.refreshTools","tags":["Integrations"],"summary":"Re-fetch the tool list from a connected MCP server","requestBody":{"required":true,"description":"MCP integration to refresh","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/mcp/oauth/start":{"post":{"operationId":"integrations.mcp.oauthStart","tags":["Integrations"],"summary":"Begin OAuth authorization for an MCP server","requestBody":{"required":true,"description":"MCP server to begin OAuth authorization with","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"url":{"type":"string","format":"uri"},"name":{"type":"string","minLength":1,"maxLength":64},"transport":{"type":"string","enum":["http","sse"],"default":"http"},"scope":{"type":"string"},"extraHeaders":{"type":"object","additionalProperties":{"type":"string"}}},"required":["workspaceId","url","name"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"pendingId":{"type":"string"},"authorizeUrl":{"type":"string"}},"required":["pendingId","authorizeUrl"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/mcp/oauth/callback":{"get":{"operationId":"integrations.mcp.oauthCallback","tags":["Integrations"],"summary":"OAuth callback for MCP server authorization","parameters":[{"schema":{"type":"string"},"required":false,"name":"code","in":"query"},{"schema":{"type":"string"},"required":true,"name":"state","in":"query"},{"schema":{"type":"string"},"required":false,"name":"error","in":"query"},{"schema":{"type":"string"},"required":false,"name":"error_description","in":"query"}],"responses":{"200":{"description":"HTML redirect or error page","content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"Bad request","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/v1/integrations/sentry/generate":{"post":{"operationId":"integrations.sentry.generate","tags":["Integrations"],"summary":"Generate Sentry integration install URL","requestBody":{"required":true,"description":"Workspace to connect Sentry to","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"}},"required":["workspaceId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"url":{"type":"string"},"state":{"type":"string"}},"required":["url","state"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/connect":{"post":{"operationId":"integrations.connect","tags":["Integrations"],"summary":"Connect an integration","requestBody":{"required":true,"description":"The integration to connect","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["datadog"]},"workspaceId":{"type":"string"},"site":{"type":"string"},"apiKey":{"type":"string"},"appKey":{"type":"string"}},"required":["type","workspaceId","site","apiKey","appKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb"]},"workspaceId":{"type":"string"},"region":{"type":"string","enum":["us","eu"]},"apiKey":{"type":"string"}},"required":["type","workspaceId","region","apiKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom"]},"workspaceId":{"type":"string"},"region":{"type":"string","enum":["us-east-1","eu-central-1"]},"apiToken":{"type":"string"}},"required":["type","workspaceId","region","apiToken"]},{"type":"object","properties":{"type":{"type":"string","enum":["betterstack"]},"workspaceId":{"type":"string"},"apiToken":{"type":"string","minLength":1},"uptimeApiToken":{"type":"string","minLength":1},"telemetryApiToken":{"type":"string","minLength":1}},"required":["type","workspaceId","apiToken","uptimeApiToken","telemetryApiToken"]},{"type":"object","properties":{"type":{"type":"string","enum":["devin"]},"workspaceId":{"type":"string"},"apiKey":{"type":"string","minLength":1},"useAsDefaultExecutor":{"type":"boolean","default":true}},"required":["type","workspaceId","apiKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["cursor"]},"workspaceId":{"type":"string"},"apiKey":{"type":"string","minLength":1},"useAsDefaultExecutor":{"type":"boolean","default":true}},"required":["type","workspaceId","apiKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["factory"]},"workspaceId":{"type":"string"},"apiKey":{"type":"string","minLength":1},"useAsDefaultExecutor":{"type":"boolean","default":true}},"required":["type","workspaceId","apiKey"]}]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/rotate-credentials":{"post":{"operationId":"integrations.rotate_credentials","tags":["Integrations"],"summary":"Rotate the API key or token for an integration","requestBody":{"required":true,"description":"The new credentials or configuration for the integration","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"apiKey":{"type":"string","description":"New API key (for Datadog or Honeycomb)"},"appKey":{"type":"string","description":"New application key (for Datadog)"},"apiToken":{"type":"string","description":"New API token (for Axiom or Better Stack)"},"uptimeApiToken":{"type":"string","description":"New Uptime API token (for Better Stack)"},"telemetryApiToken":{"type":"string","description":"New Telemetry API token (for Better Stack)"},"bearerToken":{"type":"string","nullable":true,"description":"New bearer token (for MCP); null to clear"},"extraHeaders":{"type":"object","additionalProperties":{"type":"string"},"description":"Replacement extra headers (for MCP)"},"enabledTools":{"type":"array","items":{"type":"string"},"description":"Tool allow-list (for MCP); empty to expose all"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/validate-credentials":{"post":{"operationId":"integrations.validate_credentials","tags":["Integrations"],"summary":"Validate the saved credentials for an integration","requestBody":{"required":true,"description":"The integration whose saved credentials to validate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/{workspaceId}/{id}":{"delete":{"operationId":"integrations.delete","tags":["Integrations"],"summary":"Delete an integration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the integration","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["integration"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"integrations.put","tags":["Integrations"],"summary":"Update a configured integration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the integration","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The integration properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the integration"},"disabled":{"type":"boolean","nullable":true},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Visibility level"},"guests":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Guest email addresses"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Integration labels"},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"required":["name","disabled","ownerId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"integrations.patch","tags":["Integrations"],"summary":"Update the fields of a configured integration","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the integration","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The integration properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the integration"},"disabled":{"type":"boolean","nullable":true},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Visibility level"},"guests":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Guest email addresses"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Integration labels"},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"},"notificationsEnabled":{"type":"boolean","description":"Slack only: enable or disable Polylane notifications to this workspace's notifications channel"},"anomalyChecksDisabled":{"type":"string","nullable":true,"format":"date-time","description":"Timestamp to disable anomaly checks, or null to enable. Omit to leave unchanged. Independent of `disabled`."},"anomalyCheckIntervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this integration, in minutes. Null resets to the default interval. Omit to leave unchanged."}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Integration"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/integrations/{workspaceId}":{"get":{"operationId":"integrations.list","tags":["Integrations"],"summary":"List configured integrations","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","installationId","externalId","createdBy","ownerId","visibility","guests","lastEditedBy","type","created","disabled","updated","initialised","lastFailureAt","anomalyChecksDisabled","anomalyCheckIntervalMinutes"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"installationId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"externalId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"guests","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"initialised","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastFailureAt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyChecksDisabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyCheckIntervalMinutes","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Integration"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/{workspaceId}/stats":{"get":{"operationId":"cloud_infra.stats","tags":["Cloud Infrastructure"],"summary":"Get stats about the cloud infra","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"predicate":{"type":"string","enum":["=","!=",">","<","<=",">=","LIKE"],"default":"="},"joiner":{"type":"string","enum":["AND","OR"],"default":"AND"},"tree":{"type":"boolean","description":"Flag to signal a deep tree search on the JSON object"}},"required":["field","value"],"additionalProperties":false},"description":"Query clauses to filter nodes"},"required":false,"description":"Query clauses to filter nodes","name":"clauses","in":"query"},{"schema":{"type":"object","properties":{"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"additionalProperties":false,"description":"Filters to apply to the stats query"},"required":false,"description":"Filters to apply to the stats query","name":"filters","in":"query"},{"schema":{"type":"object","properties":{"groupBy":{"type":"array","items":{"type":"string","enum":["provider","account","region","type","created_by","last_edited_by","id"]},"description":"Fields to group statistics by"},"orderBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"The field to order by"},"direction":{"type":"string","enum":["ASC","DESC"],"description":"The sort direction (ASC or DESC)"}},"required":["field","direction"],"additionalProperties":false},"description":"Fields to order the results by"},"limit":{"type":"number","description":"Maximum number of results to return"},"offset":{"type":"number","description":"Number of results to skip"}},"additionalProperties":false,"description":"Options for grouping and ordering stats"},"required":false,"description":"Options for grouping and ordering stats","name":"options","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"anyOf":[{"type":"object","properties":{"nodes":{"type":"number"},"edges":{"type":"number"}},"required":["nodes","edges"],"additionalProperties":false},{"type":"array","items":{"$ref":"#/components/schemas/Grouped Infrastructure Statistics"}}]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/{workspaceId}/advisories":{"get":{"operationId":"cloud_infra.advisories","tags":["Cloud Infrastructure"],"summary":"Best-practice advisories aggregated across every resource in the workspace, with monitoring coverage counts","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["resource","repository"],"description":"What the group's targets are: cloud resources or code repositories"},"category":{"type":"string","enum":["observability","resilience","security","data-protection","lifecycle"]},"severity":{"type":"string","enum":["warning","info"]},"fixability":{"type":"string","enum":["in-place","guidance"]},"title":{"type":"string"},"message":{"type":"string","description":"Representative explanation of the rule, from the first affected resource's advisory"},"count":{"type":"number"},"resources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]}},"required":["provider","account","region","type","id","name","title","severity"]}},"repositories":{"type":"array","items":{"type":"object","properties":{"repositoryId":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["repositoryId","owner","name","provider","url"]}}},"required":["id","kind","category","severity","fixability","title","message","count","resources"]}},"coverage":{"type":"object","properties":{"totalNodes":{"type":"number"},"monitorableNodes":{"type":"number"},"monitoredNodes":{"type":"number"},"minimalNodes":{"type":"number"},"observabilityGapNodes":{"type":"number"}},"required":["totalNodes","monitorableNodes","monitoredNodes","minimalNodes","observabilityGapNodes"]},"dismissed":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"title":{"type":"string"},"category":{"type":"string","enum":["observability","resilience","security","data-protection","lifecycle"]},"severity":{"type":"string","enum":["warning","info"]},"resource":{"type":"object","properties":{"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]}},"required":["provider","account","region","type","id","name","title","severity"]},"dismissedAtMs":{"type":"number"},"dismissedBy":{"type":"string"}},"required":["ruleId","title","category","severity","resource","dismissedAtMs","dismissedBy"]},"description":"Advisories the user chose to ignore, shown collapsed with a restore action"}},"required":["groups","coverage","dismissed"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/alternate_names":{"post":{"operationId":"cloud_infra.nodes.update_alternate_names","tags":["Cloud Infrastructure"],"summary":"Set the alternate names for a cloud infrastructure node","requestBody":{"required":true,"description":"Set the alternate names for a node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"alternateNames":{"type":"array","items":{"type":"string"},"description":"The complete list of alternate names for this node"}},"required":["workspaceId","id","provider","account","region","type","alternateNames"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Node"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/list":{"post":{"operationId":"cloud_infra.nodes.list","tags":["Cloud Infrastructure"],"summary":"List cloud infrastructure nodes","requestBody":{"required":true,"description":"The list query","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"clauses":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"predicate":{"type":"string","enum":["=","!=",">","<","<=",">=","LIKE"],"default":"="},"joiner":{"type":"string","enum":["AND","OR"],"default":"AND"},"tree":{"type":"boolean","description":"Flag to signal a deep tree search on the JSON object"}},"required":["field","value"],"additionalProperties":false}},"filters":{"type":"object","properties":{"ids":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"description":"The IDs of the nodes in the cloud account. If present, only this filter is applied"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"category":{"type":"string","enum":["compute","storage","database","networking","messaging","security","observability","code","identity","other"],"description":"Broad functional category; matches every resource type in that category"}},"additionalProperties":false},"options":{"type":"object","properties":{"tree":{"type":"boolean","description":"Flag to signal a deep tree search on the JSON object"},"key":{"type":"string","description":"Key of the root field to do the deep JSON search on, if tree is true"},"limit":{"type":"number"},"offset":{"type":"number"},"orderBy":{"type":"string","enum":["provider","account","region","type","id","created_by","last_edited_by","created","updated","tier","tier_source","tier_updated_at"],"description":"Column to order results by"},"orderDirection":{"type":"string","enum":["ASC","DESC"],"description":"Sort direction"}},"additionalProperties":false}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/get":{"post":{"operationId":"cloud_infra.nodes.get","tags":["Cloud Infrastructure"],"summary":"Get a cloud infrastructure node","requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"allOf":[{"$ref":"#/components/schemas/Infrastructure Node"},{"type":"object","properties":{"wiki":{"$ref":"#/components/schemas/ResourceWiki"},"monitoring":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true,"description":"When anomaly monitoring was disabled for this resource, or null if enabled"},"tier":{"type":"number","description":"Effective monitoring tier (1-4) for this resource"},"tierSource":{"type":"string","enum":["agent","manual"],"description":"Whether the tier was assigned automatically or set manually"},"tierReason":{"type":"string","nullable":true,"description":"Why this tier was assigned"},"tierUpdatedAt":{"type":"string","nullable":true,"description":"When the tier was last updated"},"tierInputs":{"type":"object","nullable":true,"properties":{"collectedAt":{"type":"number"},"subgraphNodeCount":{"type":"number"},"neighbourCount":{"type":"number"},"metrics":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"unit":{"type":"string","nullable":true},"avg":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"last":{"type":"number"}},"required":["label","unit","avg","min","max","last"]}},"changeCount":{"type":"number"},"changeTitles":{"type":"array","items":{"type":"string"}},"cohortSummary":{"type":"string","nullable":true}},"required":["collectedAt","subgraphNodeCount","neighbourCount","metrics","changeCount","changeTitles"],"description":"The data used by the automatic classification"},"anomalySupported":{"type":"boolean","description":"Whether this resource type is eligible for anomaly detection (has metrics, logs, traces, or invocations)"},"lastRunAt":{"type":"number","nullable":true,"description":"When the last anomaly check ran for this resource (epoch ms), or null if none has run yet"},"intervalMinutes":{"type":"number","description":"How often this resource is checked for anomalies, derived from its tier"}},"required":["disabledAt","tier","tierSource","tierReason","tierUpdatedAt","tierInputs","anomalySupported","lastRunAt","intervalMinutes"]},"capabilities":{"type":"object","properties":{"wiki":{"type":"boolean","description":"Whether wikis can be generated for this node type"},"alternateNames":{"type":"boolean","description":"Whether alternate names apply to this node type"},"issues":{"type":"boolean","description":"Whether issues can be associated with this node type"},"tier":{"type":"boolean","description":"Whether the resource tier applies to this node type"}},"required":["wiki","alternateNames","issues","tier"],"description":"Which per-resource features apply to this node type; context-only nodes such as repositories support none of them"},"advisories":{"type":"array","items":{"$ref":"#/components/schemas/ResourceAdvisory"},"description":"Best-practice advisories derived from this resource's configuration"}},"required":["wiki","monitoring","capabilities","advisories"],"additionalProperties":false}]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes":{"post":{"operationId":"cloud_infra.nodes.post","tags":["Cloud Infrastructure"],"summary":"Create a new infra node","requestBody":{"required":true,"description":"The infra node to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"data":{"type":"object","additionalProperties":{"nullable":true}},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","data","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Node"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"cloud_infra.nodes.put","tags":["Cloud Infrastructure"],"summary":"Update a cloud infra node","requestBody":{"required":true,"description":"The infra node properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"nullable":true}},"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["data","workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Node"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"cloud_infra.nodes.patch","tags":["Cloud Infrastructure"],"summary":"Update the fields of a cloud infra node","requestBody":{"required":true,"description":"The infra node properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"nullable":true}},"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["data","workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Node"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"cloud_infra.nodes.del","tags":["Cloud Infrastructure"],"summary":"Delete a cloud infra node","requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"_object":{"type":"string","enum":["infra_node"]}},"required":["id","provider","account","region","type","_object"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/edges":{"get":{"operationId":"cloud_infra.nodes.list_edges","tags":["Cloud Infrastructure"],"summary":"List the edges of a cloud infrastructure node","requestBody":{"required":true,"description":"Parameters for getting node edges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Get Node Edges Parameters"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Edge"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/edges/list":{"post":{"operationId":"cloud_infra.edges.list","tags":["Cloud Infrastructure"],"summary":"List cloud infrastructure edges","requestBody":{"required":true,"description":"The edges list query","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"nodes":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"}}},"required":["workspaceId","nodes"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Edge"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/neighbours":{"post":{"operationId":"cloud_infra.nodes.list_neighbours","tags":["Cloud Infrastructure"],"summary":"List neighbours of a cloud infrastructure node","requestBody":{"required":true,"description":"The list neighbours query","content":{"application/json":{"schema":{"type":"object","properties":{"params":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"neighborsFn":{"type":"string","enum":["inbound","outbound","both"]},"filters":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"additionalProperties":false}},"required":["params","workspaceId","neighborsFn","filters"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/count":{"post":{"operationId":"cloud_infra.nodes.count","tags":["Cloud Infrastructure"],"summary":"Count cloud infrastructure node","requestBody":{"required":true,"description":"The list query","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"clauses":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"predicate":{"type":"string","enum":["=","!=",">","<","<=",">=","LIKE"],"default":"="},"joiner":{"type":"string","enum":["AND","OR"],"default":"AND"},"tree":{"type":"boolean","description":"Flag to signal a deep tree search on the JSON object"}},"required":["field","value"],"additionalProperties":false}},"filters":{"type":"object","properties":{"ids":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"description":"The IDs of the nodes in the cloud account. If present, only this filter is applied"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"category":{"type":"string","enum":["compute","storage","database","networking","messaging","security","observability","code","identity","other"],"description":"Broad functional category; matches every resource type in that category"}},"additionalProperties":false},"options":{"type":"object","properties":{"tree":{"type":"boolean","description":"Flag to signal a deep tree search on the JSON object"},"key":{"type":"string","description":"Key of the root field to do the deep JSON search on, if tree is true"},"limit":{"type":"number"},"offset":{"type":"number"},"orderBy":{"type":"string","enum":["provider","account","region","type","id","created_by","last_edited_by","created","updated","tier","tier_source","tier_updated_at"],"description":"Column to order results by"},"orderDirection":{"type":"string","enum":["ASC","DESC"],"description":"Sort direction"}},"additionalProperties":false}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"count":{"type":"number"}},"required":["count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/traverse":{"post":{"operationId":"cloud_infra.nodes.traverse","tags":["Cloud Infrastructure"],"summary":"Traverse the architecture starting from a cloud infrastructure node","requestBody":{"required":true,"description":"The traverse query","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"start":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"neighborsFn":{"type":"string","enum":["inbound","outbound","both"]},"maxDepth":{"type":"number","minimum":0},"end":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"}},"required":["workspaceId","start"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/edges":{"post":{"operationId":"cloud_infra.edges.post","tags":["Cloud Infrastructure"],"summary":"Create a new infra edge","requestBody":{"required":true,"description":"The infra edge to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"source":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"target":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"relationship":{"type":"string","enum":["connects_to","publishes_to","contains","is_tailed","uses","defines","encrypts","serves","invokes","triggers","assumes","accesses","manages","runs_on","controls","deploys_to","owns"]},"properties":{"type":"object","additionalProperties":{"nullable":true}}},"required":["workspaceId","source","target","relationship","properties"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Edge"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/edges/{workspaceId}":{"delete":{"operationId":"cloud_infra.edges.del","tags":["Cloud Infrastructure"],"summary":"Delete a cloud infra edge","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"source","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"target","in":"query"},{"schema":{"type":"string","enum":["connects_to","publishes_to","contains","is_tailed","uses","defines","encrypts","serves","invokes","triggers","assumes","accesses","manages","runs_on","controls","deploys_to","owns"]},"required":true,"name":"relationship","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"target":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"relationship":{"type":"string"},"_object":{"type":"string","enum":["infra_edge"]}},"required":["source","target","relationship","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"get":{"operationId":"cloud_infra.edges.get","tags":["Cloud Infrastructure"],"summary":"Get a cloud infra edge","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"source","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"target","in":"query"},{"schema":{"type":"string","enum":["connects_to","publishes_to","contains","is_tailed","uses","defines","encrypts","serves","invokes","triggers","assumes","accesses","manages","runs_on","controls","deploys_to","owns"]},"required":true,"name":"relationship","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Edge"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/{workspaceId}":{"put":{"operationId":"cloud_infra.edges.put","tags":["Cloud Infrastructure"],"summary":"Update a cloud infra edge","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"source","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$"},"required":true,"name":"target","in":"query"},{"schema":{"type":"string","enum":["connects_to","publishes_to","contains","is_tailed","uses","defines","encrypts","serves","invokes","triggers","assumes","accesses","manages","runs_on","controls","deploys_to","owns"]},"required":true,"name":"relationship","in":"query"}],"requestBody":{"required":true,"description":"The infra edge properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"properties":{"type":"object","additionalProperties":{"nullable":true}}},"required":["properties"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Infrastructure Edge"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/metrics":{"post":{"operationId":"cloud_infra.nodes.metrics","tags":["Cloud Infrastructure"],"summary":"Get the metrics of a cloud infrastructure node","parameters":[{"schema":{"type":"string"},"required":true,"name":"from","in":"query"},{"schema":{"type":"string"},"required":true,"name":"to","in":"query"}],"requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"unit":{"type":"string"},"stack":{"type":"string"},"render":{"type":"string","enum":["line","table"]},"metrics":{"type":"object","properties":{"calculations":{"type":"array","items":{"$ref":"#/components/schemas/Calculation"}}},"required":["calculations"]}},"required":["id","label","description","metrics"],"additionalProperties":false}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/logs":{"post":{"operationId":"cloud_infra.nodes.logs","tags":["Cloud Infrastructure"],"summary":"Get the logs of a cloud infrastructure node","requestBody":{"required":true,"description":"Logs request parameters including node identification and query options","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"from":{"type":"number","description":"Unix timestamp in seconds"},"to":{"type":"number","description":"Unix timestamp in seconds"},"limit":{"type":"number","description":"Maximum number of log events to return"},"offset":{"type":"string","description":"Pagination token (ID of last log event)"},"filters":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"operation":{"type":"string","enum":["includes","not_includes","starts_with","regex","exists","is_null","in","not_in","eq","neq","gt","gte","lt","lte"]},"type":{"type":"string","enum":["string","number","boolean"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"required":["key","operation","type","value"]},"description":"Array of filters to apply to log events"},"needle":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]},"isRegex":{"type":"boolean"},"matchCase":{"type":"boolean"}},"required":["value","matchCase"],"description":"Full-text search configuration"}},"required":["workspaceId","id","provider","account","region","type","from","to"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"number"},"event":{"type":"object","additionalProperties":{"nullable":true}}},"required":["timestamp","event"]}},"nextOffset":{"type":"string"}},"required":["events"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/log_templates":{"post":{"operationId":"cloud_infra.nodes.log_templates","tags":["Cloud Infrastructure"],"summary":"Cross-run log template ledger for a resource: recurring log patterns with their historical rates","requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/NodeLogTemplates"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/summary":{"post":{"operationId":"cloud_infra.nodes.metrics.summary","tags":["Cloud Infrastructure"],"summary":"Get the metrics of a cloud infrastructure node","parameters":[{"schema":{"type":"string"},"required":true,"name":"from","in":"query"},{"schema":{"type":"string"},"required":true,"name":"to","in":"query"}],"requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"description":{"type":"string"},"current":{"type":"number"},"previous":{"type":"number"},"unit":{"type":"string"},"id":{"type":"string"},"direction":{"type":"string","enum":["positive","negative"]}},"required":["label","current","previous","direction"]}}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/wiki/refresh":{"post":{"operationId":"cloud_infra.nodes.refresh_wiki","tags":["Cloud Infrastructure"],"summary":"Trigger an on-demand refresh of the resource wiki + anomaly check for a cloud infrastructure node","requestBody":{"required":true,"description":"The infra node","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"queued":{"type":"boolean"}},"required":["queued"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/monitoring":{"post":{"operationId":"cloud_infra.nodes.monitoring","tags":["Cloud Infrastructure"],"summary":"Enable or disable anomaly monitoring for a cloud infrastructure node","requestBody":{"required":true,"description":"The infra node and desired monitoring state","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"disabledAt":{"type":"string","nullable":true,"format":"date-time","description":"Timestamp to disable anomaly monitoring for this resource, or null to enable. Omit to leave unchanged."},"tier":{"type":"number","nullable":true,"description":"Monitoring tier (1-4) to set manually for this resource. Null reverts to automatic classification. Omit to leave unchanged."}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true},"tier":{"type":"number","description":"Effective monitoring tier (1-4) for this resource"},"tierSource":{"type":"string","enum":["agent","manual"],"description":"Whether the tier was assigned automatically or set manually"},"tierReason":{"type":"string","nullable":true,"description":"Why this tier was assigned"}},"required":["disabledAt","tier","tierSource","tierReason"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/advisory_dismissal":{"post":{"operationId":"cloud_infra.nodes.advisory_dismissal","tags":["Cloud Infrastructure"],"summary":"Ignore or restore a best-practice advisory for a specific resource, across the home page, the resource panel, and the weekly digest","requestBody":{"required":true,"description":"The infra node, the advisory rule id, and the desired dismissal state","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"advisoryId":{"type":"string","minLength":1,"description":"The advisory rule id to ignore or restore for this resource"},"dismissed":{"type":"boolean","description":"true ignores this advisory for this resource everywhere it surfaces; false restores it"}},"required":["workspaceId","id","provider","account","region","type","advisoryId","dismissed"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AdvisoryDismissal"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_infra/nodes/search":{"post":{"operationId":"cloud_infra.nodes.search","tags":["Cloud Infrastructure"],"summary":"Search cloud infra nodes","parameters":[{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"account","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"region","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search nodes","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"prompt":{"type":"string","nullable":true}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Infrastructure Node"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{id}/repositories":{"get":{"operationId":"cloud_account_repositories.list","tags":["Cloud Account Repositories"],"summary":"List repositories connected to a cloud account","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account Repository"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/repositories":{"post":{"operationId":"cloud_account_repositories.post","tags":["Cloud Account Repositories"],"summary":"Create a connection between a cloud account and a repository","requestBody":{"required":true,"description":"The cloud account repository connection to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"cloudAccountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"repositoryId":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"reasoning":{"type":"string","default":"","description":"Why this repository is connected"}},"required":["workspaceId","cloudAccountId","repositoryId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account Repository"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{cloudAccountId}/repositories/{id}":{"patch":{"operationId":"cloud_account_repositories.patch","tags":["Cloud Account Repositories"],"summary":"Update a cloud account repository connection","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud account","name":"cloudAccountId","in":"path"},{"schema":{"type":"string","pattern":"^car_[0-9a-z]{24}$","description":"ID of the cloud account repository connection","example":"car_7xk9m2p4qw8n5j3v6h1t0y9r"},"required":true,"description":"ID of the cloud account repository connection","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The cloud account repository properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"reasoning":{"type":"string","description":"Updated reasoning"},"confidence":{"type":"string","enum":["definitive","strong","moderate","weak","speculative"]},"confirmed":{"type":"boolean","description":"Set to true to confirm an auto-discovered connection"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account Repository"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"cloud_account_repositories.del","tags":["Cloud Account Repositories"],"summary":"Delete a cloud account repository connection","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud account","name":"cloudAccountId","in":"path"},{"schema":{"type":"string","pattern":"^car_[0-9a-z]{24}$","description":"ID of the cloud account repository connection","example":"car_7xk9m2p4qw8n5j3v6h1t0y9r"},"required":true,"description":"ID of the cloud account repository connection","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^car_[0-9a-z]{24}$","description":"ID of the cloud_account_repo","example":"car_7xk9m2p4qw8n5j3v6h1t0y9r"},"_object":{"type":"string","enum":["cloud_account_repo"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/changes/{workspaceId}/top-resources":{"get":{"operationId":"cloud_accounts.change_records.top_resources","tags":["Cloud Accounts"],"summary":"Rank the infra resources changed the most over a window across the workspace","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"number","nullable":true},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"to","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":50,"default":8},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"topResources":{"type":"array","items":{"type":"object","properties":{"resourceKind":{"type":"string","enum":["infra_node"]},"resourceId":{"type":"string"},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"count":{"type":"number"},"worstImpact":{"type":"string"}},"required":["resourceKind","resourceId","provider","account","region","nodeType","count","worstImpact"]}}},"required":["topResources"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/changes/{workspaceId}/{accountId}/by-node":{"get":{"operationId":"cloud_accounts.change_records.by_node","tags":["Cloud Accounts"],"summary":"List change records that touched a specific infra node","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"The cloud account ID"},"required":true,"description":"The cloud account ID","name":"accountId","in":"path"},{"schema":{"type":"string","description":"The infra-graph node composite ID"},"required":true,"description":"The infra-graph node composite ID","name":"compositeId","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":200,"default":50},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"compositeId":{"type":"string"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"nodeId":{"type":"string"},"changeRecordId":{"type":"string"},"changeKind":{"type":"string","enum":["added","modified","removed"]},"impactLevel":{"type":"string","nullable":true,"enum":["none","low","moderate","high",null]},"category":{"type":"string","nullable":true,"enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed",null]},"title":{"type":"string"},"at":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","compositeId","provider","account","region","type","nodeId","changeRecordId","changeKind","impactLevel","category","title","at"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/changes/{workspaceId}/{accountId}":{"get":{"operationId":"cloud_accounts.change_records.list","tags":["Cloud Accounts"],"summary":"List infrastructure change records","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"The cloud account ID"},"required":true,"description":"The cloud account ID","name":"accountId","in":"path"},{"schema":{"type":"string","enum":["id","title","tldr","impactLevel","category","previousSyncTimestamp","updated","syncTimestamp","createdBy","lastEditedBy","visibility","ownerId","guests","nodesAdded","nodesRemoved","nodesModified","edgesAdded","edgesRemoved","edgesModified","created"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"tldr","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"impactLevel","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"category","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"guests","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"nodesAdded","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"nodesRemoved","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"nodesModified","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"edgesAdded","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"edgesRemoved","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"edgesModified","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"title":{"type":"string"},"tldr":{"type":"string","nullable":true},"impactLevel":{"type":"string","nullable":true,"enum":["none","low","moderate","high",null]},"category":{"type":"string","nullable":true,"enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed",null]},"syncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"previousSyncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"nodesAdded":{"type":"number"},"nodesRemoved":{"type":"number"},"nodesModified":{"type":"number"},"edgesAdded":{"type":"number"},"edgesRemoved":{"type":"number"},"edgesModified":{"type":"number"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"ownerId":{"type":"string"},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"createdBy":{"type":"string"},"lastEditedBy":{"type":"string"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["change_record"]}},"required":["workspaceId","id","accountId","title","tldr","impactLevel","category","syncTimestamp","previousSyncTimestamp","nodesAdded","nodesRemoved","nodesModified","edgesAdded","edgesRemoved","edgesModified","visibility","ownerId","guests","createdBy","lastEditedBy","created","updated","_object"],"additionalProperties":false}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/changes/{workspaceId}/{accountId}/{id}":{"get":{"operationId":"cloud_accounts.change_records.get","tags":["Cloud Accounts"],"summary":"Get infrastructure change record","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"The cloud account ID"},"required":true,"description":"The cloud account ID","name":"accountId","in":"path"},{"schema":{"type":"string","description":"The change record ID"},"required":true,"description":"The change record ID","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Change Record"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"cloud_accounts.change_records.patch","tags":["Cloud Accounts"],"summary":"Update the fields of a change record","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"required":true,"description":"ID of the change_record","name":"id","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"accountId","in":"path"}],"requestBody":{"required":true,"description":"The cloud change record to update","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":4,"maxLength":256,"description":"Title of the change record"},"summary":{"type":"string","description":"Summary of the change record"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"guests":{"type":"array","nullable":true,"items":{"type":"string"}}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Change Record"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"cloud_accounts.change_records.delete","tags":["Cloud Accounts"],"summary":"Delete an infrastructure change record","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"The cloud account ID"},"required":true,"description":"The cloud account ID","name":"accountId","in":"path"},{"schema":{"type":"string","description":"The change record ID"},"required":true,"description":"The change record ID","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"_object":{"type":"string","enum":["change_record"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/cloud_accounts/changes/{workspaceId}/{accountId}/{id}":{"get":{"operationId":"cloud_accounts.change_records.public.get","security":[],"tags":["Cloud Accounts"],"summary":"Get public infrastructure change record","parameters":[{"schema":{"type":"string","description":"The workspace ID"},"required":true,"description":"The workspace ID","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"The cloud account ID"},"required":true,"description":"The cloud account ID","name":"accountId","in":"path"},{"schema":{"type":"string","description":"The change record ID"},"required":true,"description":"The change record ID","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Public Extended Change Record"}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/cloud_accounts/changes/report":{"post":{"operationId":"cloud_accounts.change_records.public.report","security":[],"tags":["Cloud Accounts"],"summary":"Report a change record","requestBody":{"required":true,"description":"The change record to report","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"message":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"reason":{"type":"string","enum":["copyright","trademark","child_safety","fraud","adult_content","hate","illegal_goods","court_order","confidential","unlawful","other"]}},"required":["workspaceId","accountId","id","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"message":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"reason":{"type":"string","enum":["copyright","trademark","child_safety","fraud","adult_content","hate","illegal_goods","court_order","confidential","unlawful","other"]}},"required":["workspaceId","accountId","id","reason"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{id}/settings":{"get":{"operationId":"cloud_accounts.settings.get","tags":["Cloud Accounts"],"summary":"Get cloud account settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"settings":{"type":"object","properties":{"anomalyChecks":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true,"description":"When anomaly checks were disabled, or null if enabled"},"intervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this account, in minutes. Null means the default interval."}},"required":["disabledAt","intervalMinutes"]},"previewEnvironments":{"type":"object","properties":{"enabledAt":{"type":"string","nullable":true,"description":"When monitoring of preview/non-production environments was enabled, or null if disabled (the default: production only)."}},"required":["enabledAt"]},"readOnly":{"type":"object","properties":{"enabledAt":{"type":"string","nullable":true,"description":"When this account was set to read-only, or null if writes are allowed. While set, all write calls against the provider API are refused."}},"required":["enabledAt"]}},"required":["anomalyChecks","previewEnvironments","readOnly"]}},"required":["settings"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"cloud_accounts.settings.patch","tags":["Cloud Accounts"],"summary":"Update cloud account settings","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"anomalyChecksDisabled":{"type":"string","nullable":true,"format":"date-time","description":"Timestamp to disable anomaly checks, or null to enable. Omit to leave unchanged."},"anomalyCheckIntervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this account, in minutes. Null resets to the default interval. Omit to leave unchanged."},"previewEnvironmentsEnabled":{"type":"string","nullable":true,"format":"date-time","description":"Timestamp to enable monitoring of preview/non-production environments, or null to disable (production only). Omit to leave unchanged."},"readOnly":{"type":"string","nullable":true,"format":"date-time","description":"Timestamp to set this account read-only, or null to allow writes. Omit to leave unchanged."}}}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"settings":{"type":"object","properties":{"anomalyChecks":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true,"description":"When anomaly checks were disabled, or null if enabled"},"intervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this account, in minutes. Null means the default interval."}},"required":["disabledAt","intervalMinutes"]},"previewEnvironments":{"type":"object","properties":{"enabledAt":{"type":"string","nullable":true,"description":"When monitoring of preview/non-production environments was enabled, or null if disabled (the default: production only)."}},"required":["enabledAt"]},"readOnly":{"type":"object","properties":{"enabledAt":{"type":"string","nullable":true,"description":"When this account was set to read-only, or null if writes are allowed. While set, all write calls against the provider API are refused."}},"required":["enabledAt"]}},"required":["anomalyChecks","previewEnvironments","readOnly"]}},"required":["settings"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/tiers/reclassify":{"post":{"operationId":"cloud_accounts.tiers.reclassify","tags":["Cloud Accounts"],"summary":"Re-run automatic priority classification for every resource in a cloud account","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"id":{"type":"string","description":"ID of the cloud account"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"scheduled":{"type":"number","description":"Number of resources scheduled for re-classification"}},"required":["scheduled"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}":{"get":{"operationId":"cloud_accounts.list","tags":["Cloud Accounts"],"summary":"List cloud accounts","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","alias","account","region","createdBy","ownerId","visibility","guests","lastEditedBy","provider","status","workflowId","lastSync","created","updated","initialised","lastFailureAt","anomalyChecksDisabled","anomalyCheckIntervalMinutes","readOnly","resyncRequestedAt"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"alias","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"account","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"region","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"guests","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"workflowId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastSync","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"initialised","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastFailureAt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyChecksDisabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyCheckIntervalMinutes","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"readOnly","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"resyncRequestedAt","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{id}":{"get":{"operationId":"cloud_accounts.get","tags":["Cloud Accounts"],"summary":"Get a cloud account","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"cloud_accounts.patch","tags":["Cloud Accounts"],"summary":"Update the fields of a cloud account","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The cloud account properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":4,"maxLength":256,"description":"Alias of the cloud account"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Visibility level"},"guests":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Guest email addresses"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Cloud account labels"},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"cloud_accounts.disconnect","tags":["Cloud Accounts"],"summary":"Disconnect a cloud account","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["cloud_account"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{provider}/{account}/{region}":{"get":{"operationId":"cloud_accounts.get_by_account_and_region","tags":["Cloud Accounts"],"summary":"Get a cloud account by account and region","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]},"required":true,"name":"provider","in":"path"},{"schema":{"type":"string"},"required":true,"name":"account","in":"path"},{"schema":{"type":"string"},"required":true,"name":"region","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts":{"post":{"operationId":"cloud_accounts.connect","tags":["Cloud Accounts"],"summary":"Connect cloud accounts","requestBody":{"required":true,"description":"The cloud account to connect","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["cloudflare"]},"token":{"type":"string","description":"Cloudflare authentication token"},"readOnly":{"type":"boolean","default":false,"description":"Whether the token was created with read-only access"},"createMonitoringAlarms":{"type":"boolean","default":true,"description":"Whether to create default Workers observability alerts for this account"}},"required":["workspaceId","provider","token"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["aws"]},"account":{"type":"string","description":"AWS account ID"},"region":{"type":"string","description":"AWS account region"},"createMonitoringAlarms":{"type":"boolean","default":true,"description":"Whether to create CloudWatch monitoring alarms for this account"},"subscribeToAlarms":{"type":"boolean","default":true,"description":"Whether to subscribe to existing and new CloudWatch alarms in this account"}},"required":["workspaceId","provider","account","region"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["vercel"]},"code":{"type":"string","description":"OAuth authorization code from Vercel"},"configurationId":{"type":"string","description":"Vercel integration configuration ID"},"next":{"type":"string","description":"Redirect URL after connection"}},"required":["workspaceId","provider","code","configurationId"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["fly"]},"token":{"type":"string","description":"Fly.io organization API token"}},"required":["workspaceId","provider","token"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["render"]},"apiKey":{"type":"string","description":"Render API key"},"ownerId":{"type":"string","description":"Render owner id (usr-… or tea-…) to connect. When omitted, every owner reachable by the API key is connected."}},"required":["workspaceId","provider","apiKey"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["planetscale"]},"code":{"type":"string","description":"OAuth authorization code from PlanetScale. Provide this or a service token pair."},"tokenId":{"type":"string","description":"PlanetScale service token ID. Required with `token` when no OAuth code is provided."},"token":{"type":"string","description":"PlanetScale service token. Required with `tokenId` when no OAuth code is provided."},"organization":{"type":"string","description":"PlanetScale organization to connect. When omitted, every organization reachable by the credentials is connected."}},"required":["workspaceId","provider"],"additionalProperties":false},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["kubernetes"]},"kubeconfig":{"type":"string","description":"A kubeconfig YAML. When provided, the API server URL, CA certificate and token are parsed from its current context."},"apiServerUrl":{"type":"string","format":"uri","description":"Kubernetes API server URL, e.g. https://my-cluster.example.com. Required unless a kubeconfig is provided."},"token":{"type":"string","description":"ServiceAccount bearer token with read access. Required unless a kubeconfig with an embedded token is provided."},"caCert":{"type":"string","description":"PEM or base64-encoded cluster CA certificate. Optional for clusters with a publicly trusted certificate."},"clusterName":{"type":"string","description":"Display name for the cluster. Defaults to the kubeconfig context/cluster name or the API server host."},"namespace":{"type":"string","description":"Restrict discovery and monitoring to a single namespace. When omitted, all namespaces are included."}},"required":["workspaceId","provider"],"additionalProperties":false}]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"anyOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["cloudflare"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]},{"type":"object","properties":{"provider":{"type":"string","enum":["aws"]},"url":{"type":"string"},"s3Url":{"type":"string"}},"required":["provider","url","s3Url"]},{"type":"object","properties":{"provider":{"type":"string","enum":["vercel"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]},{"type":"object","properties":{"provider":{"type":"string","enum":["fly"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]},{"type":"object","properties":{"provider":{"type":"string","enum":["render"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]},{"type":"object","properties":{"provider":{"type":"string","enum":["planetscale"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]},{"type":"object","properties":{"provider":{"type":"string","enum":["kubernetes"]},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}},"failures":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"account":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"response":{"type":"string"}},"required":["message","account","name","type"]}}},"required":["provider","accounts","failures"]}]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/kubernetes/agent/register":{"post":{"operationId":"cloud_accounts.kubernetes.agent_register","tags":["Cloud Accounts"],"summary":"Register an in-cluster polylane-k8s agent","requestBody":{"required":true,"description":"The polylane-k8s agent registration payload. Registration is idempotent per cluster UID and never rotates credentials.","content":{"application/json":{"schema":{"type":"object","properties":{"clusterUid":{"type":"string","minLength":1,"maxLength":256,"description":"Stable cluster identity (the kube-system namespace UID). Registration is idempotent per cluster UID."},"clusterName":{"type":"string","maxLength":256,"description":"Display name for the cluster. When omitted, the platform derives one from the cluster UID."},"kubernetesVersion":{"type":"string","minLength":1,"maxLength":128,"description":"Kubernetes server version reported by the cluster, e.g. v1.30.2."},"agentVersion":{"type":"string","minLength":1,"maxLength":128,"description":"Version of the polylane-k8s agent performing the registration."},"distribution":{"type":"string","maxLength":128,"description":"Detected Kubernetes distribution, e.g. eks, gke, k3s."},"namespace":{"type":"string","minLength":1,"maxLength":253,"description":"Namespace the agent is deployed in."},"chartVersion":{"type":"string","maxLength":128,"description":"Helm chart version the agent was installed from."}},"required":["clusterUid","kubernetesVersion","agentVersion","namespace"],"additionalProperties":false}}}},"responses":{"200":{"description":"Registration result. Flat body (no platform envelope): the in-cluster agent decodes it directly.","content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string"},"agentId":{"type":"string"},"tunnelId":{"type":"string"},"tunnelToken":{"type":"string"},"tunnelHostname":{"type":"string"},"shimSecret":{"type":"string"},"_object":{"type":"string","enum":["kubernetes_agent_registration"]}},"required":["accountId","agentId","tunnelId","tunnelToken","tunnelHostname","shimSecret","_object"]}}}},"400":{"description":"Invalid request, agent connections not configured on this stage, or the cluster is already connected in direct mode. Terminal for the agent.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Missing or invalid credentials, or a non-API-key authentication method. Terminal for the agent.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"The API key is not authorized for cloud_accounts:write. Terminal for the agent.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"426":{"description":"Plan limit exceeded. Terminal for the agent.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Rate limited. The agent retries with backoff, honoring Retry-After.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal error. The agent retries with backoff.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/cloud_accounts/vercel/generate":{"post":{"operationId":"cloud_accounts.connect.vercel.generate","tags":["Cloud Accounts"],"summary":"Generate Vercel app integration url","requestBody":{"required":true,"description":"The params to generate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"}},"required":["workspaceId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/rotate-credentials":{"post":{"operationId":"cloud_accounts.rotate_credentials","tags":["Cloud Accounts"],"summary":"Rotate the API key or token for a cloud account","requestBody":{"required":true,"description":"The new credentials for the cloud account","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"token":{"type":"string","description":"New API token (for Cloudflare or Fly.io)"},"apiKey":{"type":"string","description":"New API key (for Render)"},"tokenId":{"type":"string","description":"New service token ID (for PlanetScale, alongside token)"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/validate-credentials":{"post":{"operationId":"cloud_accounts.validate_credentials","tags":["Cloud Accounts"],"summary":"Validate the saved credentials for a cloud account","requestBody":{"required":true,"description":"The cloud account whose saved credentials to validate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"status":{"type":"string"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","status"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/sync":{"post":{"operationId":"cloud_accounts.sync","tags":["Cloud Accounts"],"summary":"Sync a cloud account","requestBody":{"required":true,"description":"The cloud account to sync","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"}},"required":["workspaceId","id"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/{workspaceId}/{id}/api_key":{"put":{"operationId":"cloud_accounts.vercel.api_key.update","tags":["Cloud Accounts"],"summary":"Set or remove the Vercel access token used for metrics and logs","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"required":true,"description":"ID of the cloud_account","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The Vercel access token to store on the account","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","nullable":true,"description":"The Vercel personal access token to store, or null to remove the stored token"}},"required":["token"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Cloud Account"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/suggest":{"post":{"operationId":"cloud_accounts.suggest","tags":["Cloud Accounts"],"summary":"Suggest a cloud provider","requestBody":{"required":true,"description":"Suggest cloud provider","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"details":{"type":"string"}},"required":["workspaceId","name","url"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{}}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/cloud_accounts/search":{"post":{"operationId":"cloud_accounts.search","tags":["Cloud Accounts"],"summary":"Search cloud accounts","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"alias","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"account","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"region","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"guests","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"workflowId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastSync","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"initialised","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastFailureAt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyChecksDisabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"anomalyCheckIntervalMinutes","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"readOnly","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"resyncRequestedAt","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search cloud accounts","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"prompt":{"type":"string","nullable":true}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Cloud Account"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/automations/stats":{"get":{"operationId":"public.automationInstallStats","security":[],"tags":["Automation Templates"],"summary":"Get install counts and trending status for all automation templates","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TemplateInstallStatsItem"}},"fetchedAt":{"type":"integer","description":"Epoch ms when the stats were fetched from WAE"}},"required":["items","fetchedAt"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/stats":{"get":{"operationId":"public.skillInstallStats","security":[],"tags":["Skills"],"summary":"Get install counts and trending status for all skill templates","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SkillInstallStatsItem"}},"fetchedAt":{"type":"integer","description":"Epoch ms when the stats were fetched from WAE"}},"required":["items","fetchedAt"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/feedbacks":{"post":{"operationId":"feedbacks.post","tags":["Feedbacks"],"summary":"Submit feedback about the platform","requestBody":{"required":true,"description":"The feedback to submit","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"text":{"type":"string","description":"Feedback"},"title":{"type":"string","description":"Title"},"context":{"type":"string","description":"The context from the feedback, usually the web page the feedback is submitted from"},"environment":{"type":"object","additionalProperties":{"nullable":true},"description":"Details about the environment the feedback is submitted from"},"screenshotFileId":{"type":"string","nullable":true,"pattern":"^file_[0-9a-z]{24}$","description":"The ID of an uploaded screenshot attached to the feedback"}},"required":["workspaceId","text","title","context","environment"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Feedback"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/ratings":{"post":{"operationId":"ratings.post","tags":["Ratings"],"summary":"Create a rating","requestBody":{"required":true,"description":"The rating to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"version":{"type":"string"},"wikiId":{"type":"string"},"resource":{"type":"string","enum":["message","wiki_outline","wiki_doc","change_record","incident"]},"type":{"type":"string","enum":["implicit","explicit"]},"score":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[-1]}],"description":"The score to give to the message, 1 for postitive response, -1 for negative"},"details":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true,"enum":["ui","overactive_refusal","not_grounded","not_follow_instruction","not_factual","incomplete",null]}},"required":["workspaceId","id","resource","type","score"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Rating"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/ratings/{workspaceId}/{id}":{"patch":{"operationId":"ratings.patch","tags":["Ratings"],"summary":"Update a rating","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^rating_[0-9a-z]{32}$","description":"ID of the rating","example":"rating_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the rating","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The rating to update","content":{"application/json":{"schema":{"type":"object","properties":{"details":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true,"enum":["ui","overactive_refusal","not_grounded","not_follow_instruction","not_factual","incomplete",null]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Rating"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/ratings":{"post":{"operationId":"ratings.public.post","tags":["Ratings"],"summary":"Create a rating","requestBody":{"required":true,"description":"The rating to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"version":{"type":"string"},"wikiId":{"type":"string"},"resource":{"type":"string","enum":["message","wiki_outline","wiki_doc","change_record","incident"]},"type":{"type":"string","enum":["implicit","explicit"]},"score":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[-1]}],"description":"The score to give to the message, 1 for postitive response, -1 for negative"},"details":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true,"enum":["ui","overactive_refusal","not_grounded","not_follow_instruction","not_factual","incomplete",null]}},"required":["workspaceId","id","resource","type","score"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Rating"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/ratings/{workspaceId}/{id}":{"patch":{"operationId":"public.ratings.patch","tags":["Ratings"],"summary":"Update a rating","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^rating_[0-9a-z]{32}$","description":"ID of the rating","example":"rating_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the rating","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The rating to update","content":{"application/json":{"schema":{"type":"object","properties":{"details":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true,"enum":["ui","overactive_refusal","not_grounded","not_follow_instruction","not_factual","incomplete",null]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Rating"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/datasets/{workspaceId}/{id}":{"get":{"operationId":"datasets.get","tags":["Datasets"],"summary":"Get a dataset","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the dataset","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Dataset"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"datasets.del","tags":["Datasets"],"summary":"Delete a dataset","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the dataset","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"_object":{"type":"string","enum":["dataset"]}},"required":["workspaceId","id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"datasets.put","tags":["Datasets"],"summary":"Update a dataset","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the dataset","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The dataset properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","minLength":4,"maxLength":2000,"description":"Description of the dataset"},"disabled":{"type":"string","nullable":true,"format":"date-time"},"providerMetadata":{"type":"object","nullable":true,"properties":{"vercel":{"type":"object","properties":{"disablePreview":{"type":"string","nullable":true,"format":"date-time"}},"required":["disablePreview"]},"aws":{"type":"object","properties":{"disableLambdaStartEndLogs":{"type":"string","nullable":true,"format":"date-time"}},"required":["disableLambdaStartEndLogs"]}}},"keys":{"type":"object","properties":{"scrub":{"type":"string","nullable":true,"format":"date-time"},"obfuscate":{"type":"array","items":{"type":"string"}},"exclude":{"type":"array","items":{"type":"string"}}},"required":["scrub","obfuscate","exclude"]},"services":{"type":"object","properties":{"exclude":{"type":"array","items":{"type":"string"}}},"required":["exclude"]},"sampling":{"type":"object","properties":{"enabled":{"type":"string","nullable":true,"format":"date-time"},"rate":{"type":"number","minimum":0,"maximum":1}},"required":["enabled","rate"]}},"required":["description","disabled","providerMetadata","keys","services","sampling"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Dataset"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"datasets.patch","tags":["Datasets"],"summary":"Update a dataset","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"required":true,"description":"ID of the dataset","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The dataset properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","minLength":4,"maxLength":2000,"description":"Description of the dataset"},"disabled":{"type":"string","nullable":true,"format":"date-time"},"providerMetadata":{"type":"object","nullable":true,"properties":{"vercel":{"type":"object","properties":{"disablePreview":{"type":"string","nullable":true,"format":"date-time"}},"required":["disablePreview"]},"aws":{"type":"object","properties":{"disableLambdaStartEndLogs":{"type":"string","nullable":true,"format":"date-time"}},"required":["disableLambdaStartEndLogs"]}}},"keys":{"type":"object","properties":{"scrub":{"type":"string","nullable":true,"format":"date-time"},"obfuscate":{"type":"array","items":{"type":"string"}},"exclude":{"type":"array","items":{"type":"string"}}},"required":["scrub","obfuscate","exclude"]},"services":{"type":"object","properties":{"exclude":{"type":"array","items":{"type":"string"}}},"required":["exclude"]},"sampling":{"type":"object","properties":{"enabled":{"type":"string","nullable":true,"format":"date-time"},"rate":{"type":"number","minimum":0,"maximum":1}},"required":["enabled","rate"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Dataset"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/datasets/{workspaceId}":{"get":{"operationId":"datasets.list","tags":["Datasets"],"summary":"List datasets","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["slug","id","ownerId","description","createdBy","lastEditedBy","keys","services","providerMetadata","disabled","blocked","sampling","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"slug","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"blocked","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Dataset"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/datasets":{"post":{"operationId":"datasets.post","tags":["Datasets"],"summary":"Create a new dataset","requestBody":{"required":true,"description":"The dataset to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"slug":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the dataset"},"description":{"type":"string","nullable":true,"maxLength":2000}},"required":["workspaceId","slug"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Dataset"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/analytics":{"post":{"operationId":"analytics.query","tags":["Analytics"],"summary":"Query analytics time series data","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"from":{"type":"number"},"to":{"type":"number"},"event":{"type":"string"},"operation":{"type":"string","enum":["count","sum"]},"sumField":{"type":"string"},"granularity":{"type":"string","enum":["hourly","daily"]},"groupBy":{"type":"string"},"filters":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["field","values"]}}},"required":["workspaceId","from","to","event","operation"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"total":{"type":"number"},"series":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"value":{"type":"number"},"group":{"type":"string"}},"required":["bucket","value"]}}},"required":["total","series"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills/{workspaceId}":{"get":{"operationId":"skills.list","tags":["Skills"],"summary":"List workspace skills","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["created","updated","name"],"default":"name"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"required":false,"name":"order","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"string","enum":["template","manual","generated"],"description":"Filter by skill source"},"required":false,"description":"Filter by skill source","name":"source","in":"query"},{"schema":{"type":"string","description":"Filter by label ID (prefix with ! to exclude)"},"required":false,"description":"Filter by label ID (prefix with ! to exclude)","name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Skill"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills/{workspaceId}/{id}":{"get":{"operationId":"skills.get","tags":["Skills"],"summary":"Get a skill by ID","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the skill","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"skill":{"$ref":"#/components/schemas/Skill"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/SkillDocument"}}},"required":["skill","documents"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"skills.update","tags":["Skills"],"summary":"Update a skill","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the skill","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditSkill"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"allOf":[{"$ref":"#/components/schemas/Skill"},{"type":"object","properties":{"authoringWarnings":{"type":"array","items":{"$ref":"#/components/schemas/SkillAuthoringWarning"},"description":"Advisory authoring-quality warnings; the skill is saved regardless"}},"additionalProperties":false}]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"skills.delete","tags":["Skills"],"summary":"Delete a skill","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the skill","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["skill"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills":{"post":{"operationId":"skills.create","tags":["Skills"],"summary":"Create a workspace skill","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSkill"}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"allOf":[{"$ref":"#/components/schemas/Skill"},{"type":"object","properties":{"authoringWarnings":{"type":"array","items":{"$ref":"#/components/schemas/SkillAuthoringWarning"},"description":"Advisory authoring-quality warnings; the skill is saved regardless"}},"additionalProperties":false}]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/catalog":{"get":{"operationId":"skills.catalog","tags":["Skills"],"summary":"Get built-in skills catalog","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SkillCatalogItem"}}},"required":["items"]}},"required":["message","success","error","result"]}}}}}}},"/v1/skills/from-template":{"post":{"operationId":"skills.createFromTemplate","tags":["Skills"],"summary":"Create a skill from a catalog template","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSkillFromTemplate"}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Skill"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills/{workspaceId}/{id}/documents":{"get":{"operationId":"skills.documents.list","tags":["Skills"],"summary":"List skill documents","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SkillDocument"}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills/{workspaceId}/{id}/documents/{docId}":{"get":{"operationId":"skills.documents.get","tags":["Skills"],"summary":"Get skill document with content","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"docId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"document":{"$ref":"#/components/schemas/SkillDocument"},"content":{"type":"string"}},"required":["document","content"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"skills.documents.delete","tags":["Skills"],"summary":"Delete a skill document","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"docId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^skld_[0-9a-z]{24}$","description":"ID of the skilldoc","example":"skld_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["skilldoc"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/skills/documents":{"post":{"operationId":"skills.documents.upload","tags":["Skills"],"summary":"Upload a document to a skill","requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CreateSkillDocument"},{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"skillId":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"content":{"type":"string","minLength":1,"description":"Document content"}},"required":["workspaceId","skillId","content"],"additionalProperties":false}]}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/SkillDocument"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/{workspaceId}/{id}":{"get":{"operationId":"skills.public.get","security":[],"tags":["Skills"],"summary":"Get public details of a skill","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the skill","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"skill":{"$ref":"#/components/schemas/PublicSkill"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/PublicSkillDocument"}}},"required":["skill","documents"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/{workspaceId}":{"get":{"operationId":"skills.public.list","security":[],"tags":["Skills"],"summary":"List public skills in a workspace","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["created","updated","name"],"default":"name"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"required":false,"name":"order","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"string","enum":["template","manual","generated"],"description":"Filter by skill source"},"required":false,"description":"Filter by skill source","name":"source","in":"query"},{"schema":{"type":"string","description":"Filter by label ID (prefix with ! to exclude)"},"required":false,"description":"Filter by label ID (prefix with ! to exclude)","name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicSkill"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/{workspaceId}/{id}/documents":{"get":{"operationId":"skills.public.documents.list","security":[],"tags":["Skills"],"summary":"List public skill documents","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicSkillDocument"}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/skills/{workspaceId}/{id}/documents/{docId}":{"get":{"operationId":"skills.public.documents.get","security":[],"tags":["Skills"],"summary":"Get public skill document with content","parameters":[{"schema":{"type":"string"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"docId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"document":{"$ref":"#/components/schemas/PublicSkillDocument"},"content":{"type":"string"}},"required":["document","content"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/pages/view/{id}":{"get":{"operationId":"pages.view","security":[],"tags":["Pages"],"summary":"Mint a short-lived signed viewing URL for a published page","description":"Authorized for authenticated workspace members with pages read access, and for holders of a pull request guest link token (Bearer header or `token` query parameter) minted for the pull request this page was published from.","parameters":[{"schema":{"type":"string","pattern":"^page_[0-9a-z]{40}$","description":"ID of the page","example":"page_38mg3o4ibc92h8t2efn8csrhd18564pxsvozx979"},"required":true,"description":"ID of the page","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"page":{"type":"object","properties":{"id":{"type":"string","pattern":"^page_[0-9a-z]{40}$","description":"ID of the page","example":"page_38mg3o4ibc92h8t2efn8csrhd18564pxsvozx979"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"kind":{"type":"string","enum":["pr_analysis","autofix_run"]},"title":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string","nullable":true},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspaceId","kind","title","source","sourceUrl","created","updated"],"additionalProperties":false},"url":{"type":"string","description":"Short-lived signed URL serving the page content, suitable for embedding in an iframe."},"expiresAt":{"type":"string","description":"When the signed URL stops working. Request a fresh one after this instant."}},"required":["page","url","expiresAt"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/pages/{workspaceId}":{"get":{"operationId":"pages.list","tags":["Pages"],"summary":"List the workspace's published pages","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["workspaceId","id","kind","title","source","sourceUrl","url","deletedBy","created","updated","deleted"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"type":"string","description":"Case-insensitive substring match against title and source."},"required":false,"description":"Case-insensitive substring match against title and source.","name":"search","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"kind","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"source","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"url","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"deletedBy","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Page"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/pages/{workspaceId}/{id}":{"delete":{"operationId":"pages.delete","tags":["Pages"],"summary":"Delete a published page","description":"Deletes the published page so its URL stops resolving. The row is kept in the backend and the page can be restored.","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^page_[0-9a-z]{40}$","description":"ID of the page","example":"page_38mg3o4ibc92h8t2efn8csrhd18564pxsvozx979"},"required":true,"description":"ID of the page","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Page"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/memories/{workspaceId}/{id}":{"get":{"operationId":"memories.get","tags":["Memories"],"summary":"Get a memory","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"required":true,"description":"ID of the memory","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"allOf":[{"$ref":"#/components/schemas/Memory"},{"type":"object","properties":{"markdown":{"type":"string","description":"Memory body in markdown"}},"required":["markdown"],"additionalProperties":false}]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"memories.put","tags":["Memories"],"summary":"Update a memory","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"required":true,"description":"ID of the memory","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The memory properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Title of the memory"},"markdown":{"type":"string","nullable":true,"description":"Markdown content of the memory"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"archived":{"type":"number","nullable":true,"description":"Timestamp of when the memory was archived"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"}},"required":["title","markdown","ownerId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Memory"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"memories.patch","tags":["Memories"],"summary":"Update the fields of a memory","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"required":true,"description":"ID of the memory","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The memory properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Title of the memory"},"markdown":{"type":"string","nullable":true,"description":"Markdown content of the memory"},"archived":{"type":"number","nullable":true,"description":"Timestamp of when the memory was archived"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Memory"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"memories.del","tags":["Memories"],"summary":"Delete a memory","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"required":true,"description":"ID of the memory","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"_object":{"type":"string","enum":["memory"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/memories/{workspaceId}":{"get":{"operationId":"memories.list","tags":["Memories"],"summary":"List memories","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","createdBy","title","contentStatus","archived","ownerId","lastEditedBy","sourceType","sourceId","sourceThreadId","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"contentStatus","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"archived","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceType","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceThreadId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Memory"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/memories":{"post":{"operationId":"memories.post","tags":["Memories"],"summary":"Create a new memory","requestBody":{"required":true,"description":"The memory to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"title":{"type":"string","nullable":true,"maxLength":1000,"description":"Title of the memory"},"markdown":{"type":"string","nullable":true,"description":"Markdown content of the memory"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"sourceType":{"type":"string","nullable":true,"enum":["investigation","change_analysis","observation","automation",null],"description":"How this learning was discovered"},"sourceId":{"type":"string","nullable":true,"description":"ID of the source (e.g. changeRecordId)"},"sourceThreadId":{"type":"string","nullable":true,"description":"Thread ID where the learning originated"}},"required":["workspaceId","markdown"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Memory"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/memories/search":{"post":{"operationId":"memories.search","tags":["Memories"],"summary":"Search memories","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"contentStatus","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"archived","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceType","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"sourceThreadId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search memories","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"prompt":{"type":"string","nullable":true},"timeframe":{"type":"object","nullable":true,"properties":{"from":{"type":"number","description":"Timestamp to filter memories from"},"to":{"type":"number","description":"Timestamp to filter memories to"}},"additionalProperties":false}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Memory"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/notes/{workspaceId}/global":{"get":{"operationId":"notes.global.get","tags":["Notes"],"summary":"Get the workspace's global note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/GlobalNote"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"notes.global.put","tags":["Notes"],"summary":"Replace the workspace's global note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"requestBody":{"required":true,"description":"Replacement content for the global note","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"Replacement content for the global note"}},"required":["content"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/GlobalNote"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"notes.global.patch","tags":["Notes"],"summary":"Update the fields of the global note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"requestBody":{"required":true,"description":"Partial update for the global note","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"}}}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/GlobalNote"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"notes.global.del","tags":["Notes"],"summary":"Delete the workspace's global note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"_object":{"type":"string","enum":["global_note"]}},"required":["_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/notes/{workspaceId}":{"get":{"operationId":"notes.list","tags":["Notes"],"summary":"List daily notes","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","date","content","threadCount","ownerId","createdBy","lastEditedBy","created","updated","deleted"],"default":"date"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"date","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"threadCount","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"created","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"updated","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DailyNote"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/notes/{workspaceId}/{id}":{"get":{"operationId":"notes.get","tags":["Notes"],"summary":"Get a daily note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the daily_note","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/DailyNote"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"notes.put","tags":["Notes"],"summary":"Replace a daily note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the daily_note","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The daily note properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"content":{"type":"string","description":"The note content"},"threadCount":{"type":"integer","minimum":0}},"required":["content"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/DailyNote"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"notes.patch","tags":["Notes"],"summary":"Update the fields of a daily note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the daily_note","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The daily note properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"content":{"type":"string"},"threadCount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/DailyNote"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"notes.del","tags":["Notes"],"summary":"Delete a daily note","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the daily_note","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["daily_note"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/search":{"post":{"operationId":"search.global","tags":["Search"],"summary":"Global search across all resource types","requestBody":{"required":true,"description":"Global search request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"The workspace ID to search within"},"prompt":{"type":"string","description":"The search query"},"searchMode":{"type":"string","enum":["vector","fts","hybrid"],"description":"Search mode (defaults to 'hybrid')"},"mode":{"type":"string","enum":["fast","full"],"description":"Ranking tier: 'fast' skips AI reranking for low-latency retrieval-only results, 'full' (default) reranks with AI"}},"required":["workspaceId","prompt"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["memory"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["infrastructure_node"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["repository"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["thread"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["cloud_account"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["automation"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]},{"type":"object","properties":{"type":{"type":"string","enum":["skill"]},"id":{"type":"string"},"score":{"type":"number"},"entity":{"nullable":true}},"required":["type","id","score"]}]}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/search/label/{workspaceId}/{labelId}":{"get":{"operationId":"search.labelResources","tags":["Search"],"summary":"List all resources with a specific label","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":true,"name":"labelId","in":"path"},{"schema":{"type":"number","minimum":1,"maximum":20,"default":5},"required":false,"name":"perPage","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"entity":{"type":"object","additionalProperties":{"nullable":true}}},"required":["type","id","entity"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/{workspaceId}/{id}/family":{"get":{"operationId":"threads.family","tags":["Threads"],"summary":"Get a thread's family (parent, siblings, children)","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/Thread"},"parent":{"allOf":[{"$ref":"#/components/schemas/Thread"},{"nullable":true}]},"siblings":{"type":"array","items":{"$ref":"#/components/schemas/Thread"}},"children":{"type":"array","items":{"$ref":"#/components/schemas/Thread"}}},"required":["self","parent","siblings","children"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/{workspaceId}/{id}/skills":{"get":{"operationId":"threads.skills","tags":["Threads"],"summary":"List the skills active on a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ThreadSkill"}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/{workspaceId}/{id}":{"get":{"operationId":"threads.get","tags":["Threads"],"summary":"Get a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"thread":{"$ref":"#/components/schemas/Thread"}},"required":["thread"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"threads.put","tags":["Threads"],"summary":"Update a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The thread properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the thread"},"context":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["repository","cloud_account","integration","thread","infrastructure_node","wiki_document","memory","anomaly","issue","change_record","pull_request"]}},"required":["id","type"]}},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"required":["name","context","ownerId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Thread"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"threads.patch","tags":["Threads"],"summary":"Update the fields of a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The thread properties to update","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the thread"},"context":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["repository","cloud_account","integration","thread","infrastructure_node","wiki_document","memory","anomaly","issue","change_record","pull_request"]}},"required":["id","type"]}},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"changeDescription":{"type":"string","nullable":true,"description":"Description of the change"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Thread"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"threads.del","tags":["Threads"],"summary":"Delete a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["thread"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/{workspaceId}":{"get":{"operationId":"threads.list","tags":["Threads"],"summary":"List threads","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","parentThreadId","agentName","name","createdBy","ownerId","externalId","lastEditedBy","visibility","origin","originVersion","mode","type","created","updated","runningSince"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"parentThreadId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"agentName","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"externalId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"summary","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"origin","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"originVersion","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"mode","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"Filter by run state: 'true' returns only threads with a turn in progress, 'false' only idle threads."},"required":false,"description":"Filter by run state: 'true' returns only threads with a turn in progress, 'false' only idle threads.","name":"running","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Thread"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads":{"post":{"operationId":"threads.post","tags":["Threads"],"summary":"Create a new thread","requestBody":{"required":true,"description":"The thread to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"parentThreadId":{"type":"string","nullable":true,"pattern":"^thrd_[0-9a-z]{24}$","description":"Parent thread ID if creating a sub-agent thread"},"name":{"type":"string","nullable":true,"minLength":4,"maxLength":256,"description":"Name of the thread"},"prompt":{"type":"string","nullable":true,"description":"Initial prompt to generate the thread name from"},"context":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["repository","cloud_account","integration","thread","infrastructure_node","wiki_document","memory","anomaly","issue","change_record","pull_request"]}},"required":["id","type"]}},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["image","pdf","text"]},"name":{"type":"string"},"thumbnailUrl":{"type":"string"},"size":{"type":"number","nullable":true}},"required":["id","kind","name","thumbnailUrl","size"]},"description":"Files attached to the initial message"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"},"maxItems":20}},"required":["workspaceId","visibility"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Thread"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/fork":{"post":{"operationId":"threads.fork","tags":["Threads"],"summary":"Fork a thread from a specific message","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"pivotMessageId":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"name":{"type":"string","minLength":1,"maxLength":256},"agentName":{"type":"string","minLength":1,"maxLength":128}},"required":["workspaceId","threadId","pivotMessageId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"childThreadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"copiedMessageCount":{"type":"number"}},"required":["childThreadId","copiedMessageCount"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/revert":{"post":{"operationId":"threads.revert","tags":["Threads"],"summary":"Revert a thread to a specific message, dropping all later messages","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"pivotMessageId":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"}},"required":["workspaceId","threadId","pivotMessageId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"deletedCount":{"type":"number"}},"required":["deletedCount"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/{workspaceId}/{id}/participants":{"get":{"operationId":"threads.participants.list","tags":["Threads"],"summary":"List participants of a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ThreadParticipant"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/search":{"post":{"operationId":"threads.search","tags":["Threads"],"summary":"Search threads","parameters":[{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"parentThreadId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"agentName","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"context","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"hypothesis","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"automation","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"investigation","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"externalId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"summary","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"origin","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"originVersion","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"mode","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search threads","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"prompt":{"type":"string","nullable":true}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Thread"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/threads/export":{"post":{"operationId":"threads.export","tags":["Threads"],"summary":"Export a thread","requestBody":{"required":true,"description":"The thread to export","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"format":{"type":"string","enum":["md","pdf"]}},"required":["workspaceId","id","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"filename":{"type":"string"},"base64":{"type":"string"}},"required":["id","filename","base64"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/threads/{workspaceId}/{id}":{"get":{"operationId":"threads.public.get","security":[],"tags":["Threads"],"summary":"Get public details of a thread","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"thread":{"$ref":"#/components/schemas/Public Thread"}},"required":["thread"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/threads/report":{"post":{"operationId":"threads.public.report","security":[],"tags":["Threads"],"summary":"Report a thread","requestBody":{"required":true,"description":"The thread to report","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"message":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"reason":{"type":"string","enum":["copyright","trademark","child_safety","fraud","adult_content","hate","illegal_goods","court_order","confidential","unlawful","other"]}},"required":["workspaceId","id","reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"message":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"reason":{"type":"string","enum":["copyright","trademark","child_safety","fraud","adult_content","hate","illegal_goods","court_order","confidential","unlawful","other"]}},"required":["workspaceId","id","reason"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/threads/export":{"post":{"operationId":"threads.public.export","security":[],"tags":["Threads"],"summary":"Export a public thread","requestBody":{"required":true,"description":"The thread to export","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"format":{"type":"string","enum":["md","pdf"]}},"required":["workspaceId","id","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"filename":{"type":"string"},"base64":{"type":"string"}},"required":["id","filename","base64"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/messages/{workspaceId}/{threadId}/{id}":{"get":{"operationId":"messages.get","tags":["Messages"],"summary":"Get a message","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the message","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Message"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/messages/{workspaceId}/{threadId}":{"get":{"operationId":"messages.list","tags":["Messages"],"summary":"List messages","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","enum":["id","role","createdAt"],"default":"createdAt"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"role","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdAt","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Message"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/messages":{"post":{"operationId":"messages.post","tags":["Messages"],"summary":"Send a message to a thread","requestBody":{"required":true,"description":"The message to send to the thread","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"prompt":{"type":"string"}},"required":["workspaceId","threadId","prompt"],"additionalProperties":false}}}},"responses":{"202":{"description":"Request accepted","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Request accepted"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"status":{"type":"string","enum":["accepted"]},"threadId":{"type":"string"},"url":{"type":"string","description":"Poll this URL (GET) for the thread's messages, including the agent's response once it is ready."}},"required":["status","threadId","url"],"additionalProperties":false}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/messages/{workspaceId}/{threadId}":{"get":{"operationId":"messages.public.list","security":[],"tags":["Messages"],"summary":"List public messages","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","enum":["id","role","createdAt"],"default":"createdAt"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"role","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdAt","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Public Message"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/messages/export":{"post":{"operationId":"messages.public.export","security":[],"tags":["Messages"],"summary":"Export a public message","requestBody":{"required":true,"description":"The message to export","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"format":{"type":"string","enum":["md","pdf"]}},"required":["workspaceId","threadId","id","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"filename":{"type":"string"},"base64":{"type":"string"}},"required":["id","filename","base64"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/messages/export":{"post":{"operationId":"messages.export","tags":["Messages"],"summary":"Export a message","requestBody":{"required":true,"description":"The message to export","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"format":{"type":"string","enum":["md","pdf"]}},"required":["workspaceId","threadId","id","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"filename":{"type":"string"},"base64":{"type":"string"}},"required":["id","filename","base64"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/artifacts/{workspaceId}/{threadId}":{"get":{"operationId":"artifacts.list","tags":["Artifacts"],"summary":"List artifacts","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","enum":["id","type","title","summary","status","currentVersion","created","updated","createdBy","messageId"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"summary","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"currentVersion","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"created","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"updated","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"messageId","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactListItem"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/artifacts/{workspaceId}/{threadId}/{id}":{"get":{"operationId":"artifacts.get","tags":["Artifacts"],"summary":"Get artifact","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Artifact"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"artifacts.delete","tags":["Artifacts"],"summary":"Delete artifact","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"_object":{"type":"string","enum":["artifact"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/artifacts/{workspaceId}/{threadId}/{artifactId}/versions/{version}":{"get":{"operationId":"artifacts.getVersion","tags":["Artifacts"],"summary":"Get artifact version","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"artifactId","in":"path"},{"schema":{"type":"number","nullable":true,"minimum":0,"default":0},"required":false,"name":"version","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/ArtifactVersion"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/artifacts/{workspaceId}/{threadId}/{artifactId}/versions":{"get":{"operationId":"artifacts.listVersions","tags":["Artifacts"],"summary":"List artifact versions","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"artifactId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactVersion"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/artifacts/{workspaceId}/{threadId}/{id}":{"get":{"operationId":"artifacts.public.get","security":[],"tags":["Artifacts"],"summary":"Get public artifact","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Artifact"}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/artifacts/{workspaceId}/{threadId}":{"get":{"operationId":"artifacts.public.list","security":[],"tags":["Artifacts"],"summary":"List public artifacts","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","enum":["id","type","title","summary","status","currentVersion","created","updated","createdBy","messageId"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":50},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"type","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"summary","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"currentVersion","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"created","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"updated","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"messageId","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactListItem"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/artifacts/{workspaceId}/{threadId}/{artifactId}/versions/{version}":{"get":{"operationId":"artifacts.public.getVersion","security":[],"tags":["Artifacts"],"summary":"Get public artifact version","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"artifactId","in":"path"},{"schema":{"type":"number","nullable":true,"minimum":0,"default":0},"required":false,"name":"version","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/ArtifactVersion"}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/artifacts/{workspaceId}/{threadId}/{artifactId}/versions":{"get":{"operationId":"artifacts.public.listVersions","security":[],"tags":["Artifacts"],"summary":"List public artifact versions","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the thread","name":"threadId","in":"path"},{"schema":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the artifact","name":"artifactId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactVersion"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/automations/catalog":{"get":{"operationId":"automations.public.catalog","security":[],"tags":["Automation Templates"],"summary":"Get the public automation templates catalog","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"longDescription":{"type":"string"},"category":{"type":"string","enum":["observability","ci-cd","infrastructure","scheduled","platform"]},"subcategory":{"type":"string","enum":["alert-triage","code-review","deployment","workflow-analysis","release","security","reporting","infrastructure-monitoring","cron","webhook","platform-events"]},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]}},"triggers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]},"filters":{"type":"object","additionalProperties":{"nullable":true}},"expression":{"type":"string"},"timezone":{"type":"string"},"token":{"type":"string"}},"required":["type"]}},"instructions":{"type":"string"},"providers":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","aws","vercel","cloudflare","fly","render","sentry","cloudwatch","devin","cursor","factory"]}},"tags":{"type":"array","items":{"type":"string","enum":["alerts","triage","incident-response","code-review","security","quality","deployment","health-check","metrics","audit","observability","coverage","digest","reporting","code-changes","on-call","handoff","incident-summary","automation","labeling","code-ownership","error-rate","correlation","dora","deployment-frequency","infrastructure","cost","traffic","anomaly-detection","weekly","staging","validation","smoke-tests","slo","sla","error-budget","change-management","risk-assessment","drift-detection","compliance","investigation","follow-up","discovery","sync","summary","onboarding","security-audit","documentation","rollback","canary","feature-flags","dependency","vulnerability","cve","latency","performance","capacity","dns","ssl","certificates","release-notes","changelog","permissions","iam","access-control","database","migration","schema","logging","log-analysis","toil","cleanup","hygiene","budget","spend","optimization","runbook","playbook","postmortem","retrospective","workflow","ci-cd","pipeline","api","breaking-changes","versioning","monitoring","alerting","dashboards","secrets","rotation","credentials","backup","disaster-recovery","tagging","governance","noise-reduction","deduplication","escalation","routing","babysit"]}},"delayMs":{"type":"number"},"passCount":{"type":"number"},"cronExpression":{"type":"string"},"cronTimezone":{"type":"string"},"icons":{"type":"array","items":{"type":"string"}},"skillSlugs":{"type":"array","items":{"type":"string"}},"actionsJson":{"type":"string","description":"JSON-encoded array of AutomationAction configs this template installs."},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_template"]}},"required":["slug","name","description","longDescription","category","subcategory","triggerTypes","triggers","instructions","providers","tags","delayMs","icons","actionsJson","_object"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/automations/actions/catalog":{"get":{"operationId":"automations.public.actions.catalog","security":[],"tags":["Automation Actions"],"summary":"Get the public automation actions catalog","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"actionType":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"]},"name":{"type":"string"},"description":{"type":"string"},"longDescription":{"type":"string"},"icon":{"type":"string"},"category":{"type":"string","enum":["code","issue_tracking","deployment","communication"]},"highImpact":{"type":"boolean"},"requiredIntegrations":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}},"compatibleTriggerTypes":{"type":"array","items":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]}},"crossRepoCapable":{"type":"boolean"},"configSchemaJson":{"type":"string","description":"JSON-encoded JSON Schema for the AutomationAction config for this type."},"inputSchemaJson":{"type":"string","description":"JSON-encoded JSON Schema for the action's artifact input payload."},"exampleInputJson":{"type":"string","description":"JSON-encoded example input."},"exampleConfigJson":{"type":"string","description":"JSON-encoded example config."},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_action_catalog_entry"]}},"required":["actionType","name","description","longDescription","icon","category","highImpact","requiredIntegrations","compatibleTriggerTypes","crossRepoCapable","configSchemaJson","inputSchemaJson","exampleInputJson","exampleConfigJson","_object"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/public/automations/triggers/catalog":{"get":{"operationId":"automations.public.triggers.catalog","security":[],"tags":["Automation Triggers"],"summary":"Get the public automation triggers catalog","responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_trigger_catalog_entry"]}},"required":["type","name","description","icon","_object"]}}},"required":["items"]}},"required":["message","success","error","result"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/search":{"post":{"operationId":"automations.search","tags":["Automations"],"summary":"Search automations","parameters":[{"schema":{"type":"string","enum":["id","name","description","destinations","actions","skills","delayMs","disabled","visibility","ownerId","createdBy","lastEditedBy","source","templateSlug","lastExecuted","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"destinations","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"actions","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"skills","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"delayMs","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"source","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"templateSlug","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"},{"schema":{"type":"string","description":"Filter automations that have at least one trigger of this type."},"required":false,"description":"Filter automations that have at least one trigger of this type.","name":"triggerType","in":"query"}],"requestBody":{"required":true,"description":"The prompt to search automations","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"prompt":{"type":"string"},"timeframe":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}}}},"required":["workspaceId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"array","items":{"$ref":"#/components/schemas/Automation"}}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"418":{"description":"I'm a Teapot","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["I'm a Teapot"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/trigger":{"post":{"operationId":"automations.trigger","tags":["Automations"],"summary":"Manually trigger an automation","requestBody":{"required":true,"description":"The automation to trigger","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerAutomationBody"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutomationExecution"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/regenerate-webhook-token":{"post":{"operationId":"automations.regenerateWebhookToken","tags":["Automations"],"summary":"Regenerate a webhook automation token","requestBody":{"required":true,"description":"The automation to regenerate the webhook token for","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateWebhookTokenBody"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/RegenerateWebhookTokenResponse"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/builder/{workspaceId}/{builderId}":{"get":{"operationId":"automations.builder.get","tags":["Automations"],"summary":"Get an automation builder session","parameters":[{"schema":{"type":"string","description":"ID of the workspace"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"ID of the builder session"},"required":true,"description":"ID of the builder session","name":"builderId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"builderId":{"type":"string"},"draft":{"type":"object","properties":{"name":{"type":"string","maxLength":256,"default":""},"description":{"type":"string","maxLength":2000,"default":""},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"maxItems":10,"default":[]},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"default":{},"additionalProperties":false},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"maxItems":5,"default":[]},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"maxItems":8,"default":[]},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false},"maxItems":10,"default":[]},"delayMs":{"type":"integer","minimum":0,"default":0},"disabled":{"type":"boolean","default":false},"source":{"type":"string","enum":["template","manual","generated","builder"],"default":"builder"},"templateSlug":{"type":"string","nullable":true,"default":null}},"additionalProperties":false},"version":{"type":"number"}},"required":["builderId","draft","version"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/generate":{"post":{"operationId":"automations.generate","tags":["Automations"],"summary":"Generate automation configuration from natural language","requestBody":{"required":true,"description":"Generate an automation configuration from a natural language description","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"prompt":{"type":"string","minLength":1,"maxLength":2000},"timezone":{"type":"string"}},"required":["workspaceId","prompt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"name":{"type":"string","minLength":1,"maxLength":256},"description":{"type":"string","maxLength":2000,"default":""},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"description":"At least one trigger, at most 10."},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000}},"default":{}},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"description":"One to ten email recipients."},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","pattern":"^https:\\/\\/\\S+$"},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"default":[],"description":"Up to five destinations."},"skills":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]},"default":[]},"delayMs":{"type":"integer","minimum":0,"default":0},"passCount":{"type":"integer","default":1},"actionTypes":{"type":"array","items":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"]},"maxItems":7,"default":[]},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"]},"mode":{"type":"string","enum":["always","smart"]}},"required":["type","mode"],"additionalProperties":{"nullable":true}},"default":[]},"resolvedSkills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["skillId","skillSlug","name"]}}},"required":["status","name","triggers"]},{"type":"object","properties":{"status":{"type":"string","enum":["error"]},"error":{"type":"string","maxLength":500}},"required":["status","error"]}]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations":{"post":{"operationId":"automations.post","tags":["Automations"],"summary":"Create an automation","requestBody":{"required":true,"description":"The automation to create","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":256,"description":"Automation name"},"description":{"type":"string","maxLength":2000,"default":"","description":"Description"},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"default":{},"additionalProperties":false},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"maxItems":5,"default":[]},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"maxItems":8,"default":[]},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false},"maxItems":10,"default":[]},"delayMs":{"type":"integer","minimum":0,"default":0},"disabled":{"type":"boolean","default":false},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"default":"workspace"},"source":{"type":"string","enum":["template","manual","generated","builder"],"default":"manual"},"templateSlug":{"type":"string","nullable":true,"default":null},"builderId":{"type":"string"}},"required":["workspaceId","name","triggers"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/builder":{"post":{"operationId":"automations.builder.create","tags":["Automations"],"summary":"Start a new automation builder session","requestBody":{"required":true,"description":"Start a new automation builder session","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string"},"initialPrompt":{"type":"string","minLength":1,"maxLength":2000},"templateSlug":{"type":"string"},"timezone":{"type":"string","maxLength":100},"automationId":{"type":"string"}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"builderId":{"type":"string"},"draft":{"type":"object","properties":{"name":{"type":"string","maxLength":256,"default":""},"description":{"type":"string","maxLength":2000,"default":""},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"maxItems":10,"default":[]},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"default":{},"additionalProperties":false},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"maxItems":5,"default":[]},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"maxItems":8,"default":[]},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false},"maxItems":10,"default":[]},"delayMs":{"type":"integer","minimum":0,"default":0},"disabled":{"type":"boolean","default":false},"source":{"type":"string","enum":["template","manual","generated","builder"],"default":"builder"},"templateSlug":{"type":"string","nullable":true,"default":null}},"additionalProperties":false},"version":{"type":"number"}},"required":["builderId","draft","version"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/from_template":{"post":{"operationId":"automations.postFromTemplate","tags":["Automations"],"summary":"Create an automation from a template","requestBody":{"required":true,"description":"The template to create the automation from","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAutomationFromTemplateBody"}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}/{id}":{"get":{"operationId":"automations.get","tags":["Automations"],"summary":"Get an automation","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"put":{"operationId":"automations.put","tags":["Automations"],"summary":"Replace an automation","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The automation to replace","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":256,"description":"Automation name"},"description":{"type":"string","maxLength":2000,"default":"","description":"Description"},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"default":{},"additionalProperties":false},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"maxItems":5,"default":[]},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"maxItems":8,"default":[]},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false},"maxItems":10,"default":[]},"delayMs":{"type":"integer","minimum":0,"default":0},"disabled":{"type":"boolean","default":false},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"default":"workspace"},"source":{"type":"string","enum":["template","manual","generated","builder"],"default":"manual"},"templateSlug":{"type":"string","nullable":true,"default":null}},"required":["workspaceId","name","triggers"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"automations.patch","tags":["Automations"],"summary":"Update the fields of an automation","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"id","in":"path"}],"requestBody":{"required":true,"description":"The automation fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":256,"description":"Automation name"},"description":{"type":"string","maxLength":2000,"description":"Description"},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"agentConfig":{"type":"object","properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"additionalProperties":false},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"maxItems":5},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"maxItems":7},"labels":{"type":"array","items":{"type":"string"},"maxItems":20},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false},"maxItems":10},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$"},"delayMs":{"type":"integer","minimum":0},"disabled":{"type":"boolean"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]}},"required":["workspaceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"426":{"description":"Upgrade Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Upgrade Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"automations.del","tags":["Automations"],"summary":"Delete an automation","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Automation"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}":{"get":{"operationId":"automations.list","tags":["Automations"],"summary":"List automations","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","name","description","destinations","actions","skills","delayMs","disabled","visibility","ownerId","createdBy","lastEditedBy","source","templateSlug","lastExecuted","created","updated"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"name","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"description","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"destinations","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"actions","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"skills","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"delayMs","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"disabled","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"visibility","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"ownerId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"createdBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"lastEditedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"source","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"templateSlug","in":"query"},{"schema":{"type":"string"},"required":false,"name":"labels","in":"query"},{"schema":{"type":"string","description":"Filter automations that have at least one trigger of this type."},"required":false,"description":"Filter automations that have at least one trigger of this type.","name":"triggerType","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Automation"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/executions/rerun":{"post":{"operationId":"automations.executions.rerun","tags":["Automations"],"summary":"Rerun an automation execution","requestBody":{"required":true,"description":"The execution to rerun","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerunExecutionBody"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutomationExecution"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}/{automationId}/executions/{executionId}":{"delete":{"operationId":"automations.executions.delete","tags":["Automations"],"summary":"Delete an automation execution","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"automationId","in":"path"},{"schema":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the execution","name":"executionId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutomationExecution"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"get":{"operationId":"automations.executions.get","tags":["Automations"],"summary":"Get an automation execution","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"automationId","in":"path"},{"schema":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the execution","name":"executionId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"allOf":[{"$ref":"#/components/schemas/AutomationExecution"},{"type":"object","properties":{"result":{"type":"string","description":"Full execution result document in markdown"}},"required":["result"],"additionalProperties":false}]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}/{automationId}/executions":{"get":{"operationId":"automations.executions.list","tags":["Automations"],"summary":"List executions for an automation","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"automationId","in":"path"},{"schema":{"type":"string","enum":["id","durationMs","matchedTriggerType","matchedTrigger","status","triggeredAt","created","updated","passThreadIds","passResults"],"default":"triggeredAt"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"durationMs","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"matchedTriggerType","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"matchedTrigger","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"triggeredAt","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AutomationExecution"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}/{automationId}/executions/{executionId}/notifications":{"get":{"operationId":"automations.executions.notifications.list","tags":["Automations"],"summary":"List notifications sent for an execution","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"automationId","in":"path"},{"schema":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the execution","name":"executionId","in":"path"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AutomationNotification"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/automations/{workspaceId}/{automationId}/executions/{executionId}/actions":{"get":{"operationId":"automations.executions.actions.list","tags":["Automations"],"summary":"List action executions for an automation execution","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation","name":"automationId","in":"path"},{"schema":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the automation_execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the automation_execution","name":"executionId","in":"path"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AutomationActionExecution"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/autofixes/{workspaceId}/{id}/timeline":{"get":{"operationId":"autofixes.timeline.list","tags":["Autofixes"],"summary":"List timeline events for an autofix","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the autofix","name":"id","in":"path"},{"schema":{"type":"number","nullable":true,"minimum":0},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true,"minimum":0},"required":false,"name":"to","in":"query"},{"schema":{"type":"string","description":"Comma-separated list of event types to filter by"},"required":false,"description":"Comma-separated list of event types to filter by","name":"types","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":200,"default":100},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"required":false,"name":"order","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutofixTimelineEventsList"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/autofixes/timeline":{"post":{"operationId":"autofixes.timeline.create","tags":["Autofixes"],"summary":"Append a user-authored timeline event to an autofix","requestBody":{"required":true,"description":"The timeline event to add to an autofix","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"autofixId":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["note"],"description":"User-authored event type"},"at":{"type":"string","nullable":true,"format":"date-time","description":"When the event happened (defaults to now)"},"title":{"type":"string","maxLength":200},"body":{"type":"string","maxLength":5000},"data":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]}}},"required":["workspaceId","autofixId","type"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutofixTimelineEvent"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/autofixes/{workspaceId}":{"get":{"operationId":"autofixes.list","tags":["Autofixes"],"summary":"List autofixes","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["id","provider","owner","repo","branch","status","origin","trigger","executor","commitSha","baseBranch","automationId","executionId","actionRowId","actionPlanId","hypothesisId","runId","investigationThreadId","pullNumber","threadId","parentThreadId","parentMessageId","artifactId","findingsCount","title","prompt","failureReason","skippedReason","coveringPrNumber","coveringPrUrl","submittedPrNumber","submittedPrUrl","submittedAt","mergedPrNumber","mergedPrUrl","mergedAt","mergedBy","closedAt","closedBy","closeReason","closeReasonDetail","closeEvidence","created"],"default":"created"},"required":false,"name":"orderBy","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":20},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"required":false,"name":"order","in":"query"},{"schema":{"type":"string","description":"Case-insensitive substring match against title, owner, repo, and branch."},"required":false,"description":"Case-insensitive substring match against title, owner, repo, and branch.","name":"search","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"id","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"provider","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"owner","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"repo","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"branch","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"status","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"origin","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"trigger","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"executor","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"commitSha","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"baseBranch","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"automationId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"executionId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"actionRowId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"actionPlanId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"hypothesisId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"runId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"investigationThreadId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"pullNumber","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"threadId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"parentThreadId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"parentMessageId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"artifactId","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"findingsCount","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"title","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"prompt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"failureReason","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"skippedReason","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"coveringPrNumber","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"coveringPrUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"submittedPrNumber","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"submittedPrUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"mergedPrNumber","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"mergedPrUrl","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"mergedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"closedAt","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"closedBy","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"closeReason","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"closeReasonDetail","in":"query"},{"schema":{"anyOf":[{"type":"string","description":"Filter by exact match. Prefix with '!' to negate (e.g. '!investigation' excludes that value)."},{"type":"array","items":{"type":"string"},"description":"Filter by any of the given values (OR). Prefix individual values with '!' to exclude them."}]},"required":false,"name":"closeEvidence","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Autofix"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/autofixes/{workspaceId}/{id}":{"get":{"operationId":"autofixes.get","tags":["Autofixes"],"summary":"Get an autofix","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the autofix","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Autofix"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"autofixes.del","tags":["Autofixes"],"summary":"Delete an autofix","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the autofix","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["autofix"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/autofixes/rerun":{"post":{"operationId":"autofixes.rerun","tags":["Autofixes"],"summary":"Run a skipped autofix again on the same autofix, bypassing the skip preflights","requestBody":{"required":true,"description":"The skipped autofix to run again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerunAutofixRequest"}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AutofixRerun"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/feed/{workspaceId}/summary":{"get":{"operationId":"feed.summary","tags":["Feed"],"summary":"Problems-over-time and activity aggregate for the feed summary header","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"number","nullable":true},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"autofixPrs":{"type":"number"},"autofixDaily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"]}},"alertsTriaged":{"type":"number"},"alertsTriagedDaily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"]}}},"required":["autofixPrs","autofixDaily","alertsTriaged","alertsTriagedDaily"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/feed/{workspaceId}/escalations":{"get":{"operationId":"feed.escalations.list","tags":["Feed"],"summary":"Open requests for human action, deduplicated across issues","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["true","false"],"description":"Include escalations that have already been cleared or dismissed"},"required":false,"description":"Include escalations that have already been cleared or dismissed","name":"includeCleared","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"escalations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["investigation","credentials","connect","autofix"]},"kind":{"type":"string"},"headline":{"type":"string"},"detail":{"type":"string","nullable":true},"refs":{"type":"array","items":{"type":"object","properties":{"issueId":{"type":"string"},"threadId":{"type":"string"},"integrationId":{"type":"string"}}}},"count":{"type":"number"},"firstAt":{"type":"string"},"lastAt":{"type":"string"},"clearedAt":{"type":"string","nullable":true}},"required":["id","source","kind","headline","detail","refs","count","firstAt","lastAt","clearedAt"]}}},"required":["escalations"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/feed/{workspaceId}/escalations/{id}":{"delete":{"operationId":"feed.escalations.dismiss","tags":["Feed"],"summary":"Dismiss an open escalation so it stops suppressing and disappears from the panel","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^ask_[0-9a-z]{24}$","description":"ID of the escalation","example":"ask_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the escalation","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"escalation":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["investigation","credentials","connect","autofix"]},"kind":{"type":"string"},"headline":{"type":"string"},"detail":{"type":"string","nullable":true},"refs":{"type":"array","items":{"type":"object","properties":{"issueId":{"type":"string"},"threadId":{"type":"string"},"integrationId":{"type":"string"}}}},"count":{"type":"number"},"firstAt":{"type":"string"},"lastAt":{"type":"string"},"clearedAt":{"type":"string","nullable":true}},"required":["id","source","kind","headline","detail","refs","count","firstAt","lastAt","clearedAt"]}},"required":["escalation"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/feed/{workspaceId}":{"get":{"operationId":"feed.list","tags":["Feed"],"summary":"Workspace agent activity feed","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["chat","investigation","autofix","automation","anomaly","deploy","change","release","alert","issue","digest","tier"]},"required":false,"name":"category","in":"query"},{"schema":{"type":"string","description":"Only entries from this cloud provider"},"required":false,"description":"Only entries from this cloud provider","name":"provider","in":"query"},{"schema":{"type":"string","description":"Only entries from this integration type"},"required":false,"description":"Only entries from this integration type","name":"integrationType","in":"query"},{"schema":{"type":"string","description":"Comma-separated cloud account IDs used to match provider-scoped entries that only carry an account reference"},"required":false,"description":"Comma-separated cloud account IDs used to match provider-scoped entries that only carry an account reference","name":"cloudAccountIds","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"to","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"sourceEventId":{"type":"string","nullable":true},"category":{"type":"string","enum":["chat","investigation","autofix","automation","anomaly","deploy","change","release","alert","issue","digest","tier"]},"action":{"type":"string","enum":["created","updated","deleted","started","completed","submitted","merged","failed","skipped","resolved","status_changed","expired","exported","investigated","detected","reopened","deployed","released","triaged","escalated"]},"resourceType":{"type":"string","enum":["thread","message","autofix","automation","automation_execution","anomaly","deployment","change_record","release","received_alert","issue","workspace","cloud_account"]},"resourceId":{"type":"string","nullable":true},"actorType":{"type":"string","enum":["user","agent","system","api_key","admin"]},"actorId":{"type":"string","nullable":true},"actorName":{"type":"string","nullable":true},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"groupKey":{"type":"string","nullable":true},"parentKey":{"type":"string","nullable":true},"metadata":{"oneOf":[{"type":"object","properties":{"category":{"type":"string","enum":["chat"]},"threadId":{"type":"string"},"threadName":{"type":"string"}},"required":["category","threadId"]},{"type":"object","properties":{"category":{"type":"string","enum":["investigation"]},"hypothesisId":{"type":"string"},"hypothesisName":{"type":"string"},"verdict":{"type":"string","enum":["confirmed","refuted","inconclusive"]},"confidence":{"type":"string","enum":["definitive","strong","moderate","weak","speculative"]},"summary":{"type":"string"},"passCount":{"type":"number"},"durationMs":{"type":"number"},"threadIds":{"type":"array","items":{"type":"string"}},"severity":{"type":"string"},"fromStatus":{"type":"string"},"toStatus":{"type":"string"}},"required":["category"]},{"type":"object","properties":{"category":{"type":"string","enum":["autofix"]},"autofixId":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"},"prNumber":{"type":"number"},"branch":{"type":"string"},"baseBranch":{"type":"string"},"findingsCount":{"type":"number"},"mergedBy":{"type":"string"},"failureReason":{"type":"string"}},"required":["category","autofixId"]},{"type":"object","properties":{"category":{"type":"string","enum":["automation"]},"executionId":{"type":"string"},"automationId":{"type":"string"},"automationName":{"type":"string"},"triggerType":{"type":"string"},"triggerTypes":{"type":"array","items":{"type":"string"}},"passCount":{"type":"number"},"noteworthy":{"type":"boolean"},"summary":{"type":"string"},"durationMs":{"type":"number"}},"required":["category"]},{"type":"object","properties":{"category":{"type":"string","enum":["anomaly"]},"issueId":{"type":"string"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"]},"resourceProvider":{"type":"string"},"resourceAccount":{"type":"string"},"resourceRegion":{"type":"string"},"resourceType":{"type":"string"},"resourceCloudId":{"type":"string"},"integrationType":{"type":"string"},"integrationId":{"type":"string"},"cloudAccountId":{"type":"string"},"checkId":{"type":"string"},"severity":{"type":"string"},"detectedAt":{"type":"number"},"resolvedAt":{"type":"number"},"durationMs":{"type":"number"},"summary":{"type":"string"}},"required":["category","issueId","resourceKind"]},{"type":"object","properties":{"category":{"type":"string","enum":["deploy"]},"provider":{"type":"string","enum":["vercel","cloudflare","render","fly"]},"deployId":{"type":"string"},"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"url":{"type":"string"},"status":{"type":"string"},"cloudAccountId":{"type":"string"}},"required":["category","provider","deployId"]},{"type":"object","properties":{"category":{"type":"string","enum":["change"]},"changeRecordId":{"type":"string"},"cloudAccountId":{"type":"string"},"provider":{"type":"string"},"tldr":{"type":"string"},"impactLevel":{"type":"string","enum":["none","low","moderate","high"]},"changeCategory":{"type":"string"},"resourceName":{"type":"string"},"isRedeploy":{"type":"boolean"}},"required":["category","changeRecordId"]},{"type":"object","properties":{"category":{"type":"string","enum":["release"]},"owner":{"type":"string"},"repo":{"type":"string"},"tagName":{"type":"string"},"releaseName":{"type":"string"},"url":{"type":"string"},"prerelease":{"type":"boolean"}},"required":["category","owner","repo","tagName"]},{"type":"object","properties":{"category":{"type":"string","enum":["alert"]},"receivedAlertId":{"type":"string"},"source":{"type":"string"},"integrationId":{"type":"string"},"severity":{"type":"string"},"incidentThreadId":{"type":"string"},"summary":{"type":"string"},"occurrenceCount":{"type":"number"}},"required":["category","receivedAlertId","source"]},{"type":"object","properties":{"category":{"type":"string","enum":["issue"]},"issueId":{"type":"string"},"source":{"type":"string"},"integrationId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"investigationThreadId":{"type":"string"},"summary":{"type":"string"},"occurrenceCount":{"type":"number"},"resourceKind":{"type":"string"},"resourceId":{"type":"string"}},"required":["category","issueId","source"]},{"type":"object","properties":{"category":{"type":"string","enum":["digest"]},"workspaceId":{"type":"string"},"weekStart":{"type":"number"},"weekEnd":{"type":"number"},"newIssues":{"type":"number"},"autofixesMerged":{"type":"number"},"dustCount":{"type":"number"},"commentary":{"type":"string"}},"required":["category","workspaceId","weekStart","weekEnd"]},{"type":"object","properties":{"category":{"type":"string","enum":["tier"]},"cloudAccountId":{"type":"string"},"provider":{"type":"string"},"classified":{"type":"number"},"counts":{"type":"object","additionalProperties":{"type":"number"}},"criticalNames":{"type":"array","items":{"type":"string"}}},"required":["category","cloudAccountId","provider","classified","counts"]},{"nullable":true}]},"occurredAt":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"string","format":"date-time"}]},"_object":{"type":"string","enum":["feed_entry"]},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"children":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"sourceEventId":{"type":"string","nullable":true},"category":{"type":"string","enum":["chat","investigation","autofix","automation","anomaly","deploy","change","release","alert","issue","digest","tier"]},"action":{"type":"string","enum":["created","updated","deleted","started","completed","submitted","merged","failed","skipped","resolved","status_changed","expired","exported","investigated","detected","reopened","deployed","released","triaged","escalated"]},"resourceType":{"type":"string","enum":["thread","message","autofix","automation","automation_execution","anomaly","deployment","change_record","release","received_alert","issue","workspace","cloud_account"]},"resourceId":{"type":"string","nullable":true},"actorType":{"type":"string","enum":["user","agent","system","api_key","admin"]},"actorId":{"type":"string","nullable":true},"actorName":{"type":"string","nullable":true},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"groupKey":{"type":"string","nullable":true},"parentKey":{"type":"string","nullable":true},"metadata":{"oneOf":[{"type":"object","properties":{"category":{"type":"string","enum":["chat"]},"threadId":{"type":"string"},"threadName":{"type":"string"}},"required":["category","threadId"]},{"type":"object","properties":{"category":{"type":"string","enum":["investigation"]},"hypothesisId":{"type":"string"},"hypothesisName":{"type":"string"},"verdict":{"type":"string","enum":["confirmed","refuted","inconclusive"]},"confidence":{"type":"string","enum":["definitive","strong","moderate","weak","speculative"]},"summary":{"type":"string"},"passCount":{"type":"number"},"durationMs":{"type":"number"},"threadIds":{"type":"array","items":{"type":"string"}},"severity":{"type":"string"},"fromStatus":{"type":"string"},"toStatus":{"type":"string"}},"required":["category"]},{"type":"object","properties":{"category":{"type":"string","enum":["autofix"]},"autofixId":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"},"prNumber":{"type":"number"},"branch":{"type":"string"},"baseBranch":{"type":"string"},"findingsCount":{"type":"number"},"mergedBy":{"type":"string"},"failureReason":{"type":"string"}},"required":["category","autofixId"]},{"type":"object","properties":{"category":{"type":"string","enum":["automation"]},"executionId":{"type":"string"},"automationId":{"type":"string"},"automationName":{"type":"string"},"triggerType":{"type":"string"},"triggerTypes":{"type":"array","items":{"type":"string"}},"passCount":{"type":"number"},"noteworthy":{"type":"boolean"},"summary":{"type":"string"},"durationMs":{"type":"number"}},"required":["category"]},{"type":"object","properties":{"category":{"type":"string","enum":["anomaly"]},"issueId":{"type":"string"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"]},"resourceProvider":{"type":"string"},"resourceAccount":{"type":"string"},"resourceRegion":{"type":"string"},"resourceType":{"type":"string"},"resourceCloudId":{"type":"string"},"integrationType":{"type":"string"},"integrationId":{"type":"string"},"cloudAccountId":{"type":"string"},"checkId":{"type":"string"},"severity":{"type":"string"},"detectedAt":{"type":"number"},"resolvedAt":{"type":"number"},"durationMs":{"type":"number"},"summary":{"type":"string"}},"required":["category","issueId","resourceKind"]},{"type":"object","properties":{"category":{"type":"string","enum":["deploy"]},"provider":{"type":"string","enum":["vercel","cloudflare","render","fly"]},"deployId":{"type":"string"},"service":{"type":"string"},"environment":{"type":"string"},"version":{"type":"string"},"url":{"type":"string"},"status":{"type":"string"},"cloudAccountId":{"type":"string"}},"required":["category","provider","deployId"]},{"type":"object","properties":{"category":{"type":"string","enum":["change"]},"changeRecordId":{"type":"string"},"cloudAccountId":{"type":"string"},"provider":{"type":"string"},"tldr":{"type":"string"},"impactLevel":{"type":"string","enum":["none","low","moderate","high"]},"changeCategory":{"type":"string"},"resourceName":{"type":"string"},"isRedeploy":{"type":"boolean"}},"required":["category","changeRecordId"]},{"type":"object","properties":{"category":{"type":"string","enum":["release"]},"owner":{"type":"string"},"repo":{"type":"string"},"tagName":{"type":"string"},"releaseName":{"type":"string"},"url":{"type":"string"},"prerelease":{"type":"boolean"}},"required":["category","owner","repo","tagName"]},{"type":"object","properties":{"category":{"type":"string","enum":["alert"]},"receivedAlertId":{"type":"string"},"source":{"type":"string"},"integrationId":{"type":"string"},"severity":{"type":"string"},"incidentThreadId":{"type":"string"},"summary":{"type":"string"},"occurrenceCount":{"type":"number"}},"required":["category","receivedAlertId","source"]},{"type":"object","properties":{"category":{"type":"string","enum":["issue"]},"issueId":{"type":"string"},"source":{"type":"string"},"integrationId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"investigationThreadId":{"type":"string"},"summary":{"type":"string"},"occurrenceCount":{"type":"number"},"resourceKind":{"type":"string"},"resourceId":{"type":"string"}},"required":["category","issueId","source"]},{"type":"object","properties":{"category":{"type":"string","enum":["digest"]},"workspaceId":{"type":"string"},"weekStart":{"type":"number"},"weekEnd":{"type":"number"},"newIssues":{"type":"number"},"autofixesMerged":{"type":"number"},"dustCount":{"type":"number"},"commentary":{"type":"string"}},"required":["category","workspaceId","weekStart","weekEnd"]},{"type":"object","properties":{"category":{"type":"string","enum":["tier"]},"cloudAccountId":{"type":"string"},"provider":{"type":"string"},"classified":{"type":"number"},"counts":{"type":"object","additionalProperties":{"type":"number"}},"criticalNames":{"type":"array","items":{"type":"string"}}},"required":["category","cloudAccountId","provider","classified","counts"]},{"nullable":true}]},"occurredAt":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"string","format":"date-time"}]},"_object":{"type":"string","enum":["feed_entry"]},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."}},"required":["id","sourceEventId","category","action","resourceType","resourceId","actorType","actorId","actorName","title","subtitle","groupKey","parentKey","metadata","occurredAt"]}}},"required":["id","sourceEventId","category","action","resourceType","resourceId","actorType","actorId","actorName","title","subtitle","groupKey","parentKey","metadata","occurredAt","children"]}},"nextCursor":{"type":"string","nullable":true}},"required":["entries","nextCursor"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}/{id}/timeline":{"get":{"operationId":"issues.timeline.list","tags":["Issues"],"summary":"List timeline events for an issue","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"},{"schema":{"type":"number","nullable":true,"minimum":0},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true,"minimum":0},"required":false,"name":"to","in":"query"},{"schema":{"type":"string","description":"Comma-separated list of event types to filter by"},"required":false,"description":"Comma-separated list of event types to filter by","name":"types","in":"query"},{"schema":{"type":"number","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":200,"default":100},"required":false,"name":"perPage","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"required":false,"name":"order","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTimelineEventsList"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/timeline":{"post":{"operationId":"issues.timeline.create","tags":["Issues"],"summary":"Append a user-authored timeline event to an issue","requestBody":{"required":true,"description":"The timeline event to add to an issue","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"issueId":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["note","milestone"],"description":"User-authored event type"},"at":{"type":"string","nullable":true,"format":"date-time","description":"When the event happened (defaults to now)"},"title":{"type":"string","maxLength":200},"body":{"type":"string","maxLength":5000},"data":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]}}},"required":["workspaceId","issueId","type"],"additionalProperties":false}}}},"responses":{"201":{"description":"Resource created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Resource created"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTimelineEvent"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"issues.timeline.patch","tags":["Issues"],"summary":"Edit a user-authored issue timeline event","requestBody":{"required":true,"description":"Fields to update on a user-authored issue timeline event","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"issueId":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"eventId":{"type":"string","pattern":"^tle_[0-9a-z]{32}$","description":"ID of the timeline_event","example":"tle_d18564pxsvozx979j3532mii2kk7pmw6"},"title":{"type":"string","nullable":true,"maxLength":200},"body":{"type":"string","nullable":true,"maxLength":5000},"data":{"type":"object","nullable":true,"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]}},"at":{"type":"string","nullable":true,"format":"date-time"},"type":{"type":"string","enum":["note","milestone"]}},"required":["workspaceId","issueId","eventId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTimelineEvent"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}/{id}/timeline/{eventId}":{"delete":{"operationId":"issues.timeline.del","tags":["Issues"],"summary":"Delete a user-authored issue timeline event","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"},{"schema":{"type":"string","pattern":"^tle_[0-9a-z]{32}$","description":"ID of the timeline event","example":"tle_d18564pxsvozx979j3532mii2kk7pmw6"},"required":true,"description":"ID of the timeline event","name":"eventId","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTimelineEvent"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}":{"get":{"operationId":"issues.list","tags":["Issues"],"summary":"List issues","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","enum":["polylane","datadog","honeycomb","sentry","cloudwatch","vercel","axiom","betterstack","render","cloudflare","github"]},"required":false,"name":"source","in":"query"},{"schema":{"type":"string","enum":["monitoring","threshold","defect","change_record","alert","automation","manual"]},"required":false,"name":"origin","in":"query"},{"schema":{"type":"string","enum":["infra_node","cloud_account","integration","repository"],"description":"Scope issues to a resource kind"},"required":false,"description":"Scope issues to a resource kind","name":"resourceKind","in":"query"},{"schema":{"type":"string","description":"Scope issues to a specific resource id"},"required":false,"description":"Scope issues to a specific resource id","name":"resourceId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"integrationId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"provider","in":"query"},{"schema":{"type":"string"},"required":false,"name":"account","in":"query"},{"schema":{"type":"string"},"required":false,"name":"region","in":"query"},{"schema":{"type":"string"},"required":false,"name":"nodeType","in":"query"},{"schema":{"type":"string"},"required":false,"name":"checkId","in":"query"},{"schema":{"type":"string","enum":["critical","high","medium","low","info"]},"required":false,"name":"severity","in":"query"},{"schema":{"type":"string","enum":["new","triaging","confirmed","dismissed","failed","skipped"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"since","in":"query"},{"schema":{"type":"integer","nullable":true},"required":false,"name":"until","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":500},"required":false,"name":"limit","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"required":false,"name":"active","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}],"description":"Only issues whose auto-investigation was held by the workspace investigation limit."},"required":false,"description":"Only issues whose auto-investigation was held by the workspace investigation limit.","name":"held","in":"query"},{"schema":{"type":"string","enum":["id","source","origin","originId","externalId","integrationId","checkId","checkRunId","resourceKind","resourceId","provider","account","region","nodeType","title","sourceSeverity","sourceStatus","severity","status","investigationThreadId","fingerprint","occurrenceCount","detectedAt","lastSeenAt","metricsComputedAt","triagedAt","resolvedAt"],"description":"Sort column. Providing any of orderBy/order/page/perPage switches to paged mode."},"required":false,"description":"Sort column. Providing any of orderBy/order/page/perPage switches to paged mode.","name":"orderBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"]},"required":false,"name":"order","in":"query"},{"schema":{"type":"integer","minimum":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"perPage","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}/stats":{"get":{"operationId":"issues.stats","tags":["Issues"],"summary":"Aggregate issue counts over a window (detected, resolved, caused by changes) for the feed summary","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"number","nullable":true},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"detected":{"type":"number"},"detectedPrev":{"type":"number"},"resolved":{"type":"number"},"resolvedPrev":{"type":"number"},"causedByChange":{"type":"number"},"causedByChangePrev":{"type":"number"},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"]}},"causedByChangeDaily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"]}},"resolvedDaily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"]}},"topResources":{"type":"array","items":{"type":"object","properties":{"resourceKind":{"type":"string"},"resourceId":{"type":"string"},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"count":{"type":"number"},"worstSeverity":{"type":"string"}},"required":["resourceKind","resourceId","provider","account","region","nodeType","count","worstSeverity"]}}},"required":["detected","detectedPrev","resolved","resolvedPrev","causedByChange","causedByChangePrev","daily","causedByChangeDaily","resolvedDaily","topResources"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/investigate":{"post":{"operationId":"issues.investigate","tags":["Issues"],"summary":"Start the investigation of an issue","description":"Starts the issue's investigation thread. Human-initiated, so it bypasses the workspace auto-investigation limit and clears a held state, but the plan's daily investigation quota still applies (402 application/problem+json when exceeded).","requestBody":{"required":true,"description":"The issue to investigate","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace id"},"issueId":{"type":"string","description":"Issue id to investigate"}},"required":["workspaceId","issueId"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/InvestigateIssueResponse"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Conflict"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}/{id}/links":{"get":{"operationId":"issues.links","tags":["Issues"],"summary":"Get the correlation cluster (linked duplicate/related issues) for an issue","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"issueId":{"type":"string"},"issueIds":{"type":"array","items":{"type":"string"}},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"},"confidence":{"type":"number"},"rationale":{"type":"string","nullable":true},"method":{"type":"string"},"occurrence":{"type":"number"},"createdAt":{"type":"number"}},"required":["id","source","target","relationship","confidence","rationale","method","occurrence","createdAt"]}},"issues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"resolvedAt":{"type":"number","nullable":true},"resourceKind":{"type":"string","nullable":true},"resourceId":{"type":"string","nullable":true},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true}},"required":["id","title","severity","status","resolvedAt","resourceKind","resourceId","provider","account","region","nodeType"]}}},"required":["issueId","issueIds","links","issues"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issues/{workspaceId}/{id}":{"get":{"operationId":"issues.get","tags":["Issues"],"summary":"Get an issue","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"description":"Return metrics/logs/traces/analysis for this occurrence (1 = first). Defaults to the most recent."},"required":false,"description":"Return metrics/logs/traces/analysis for this occurrence (1 = first). Defaults to the most recent.","name":"occurrence","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueWithDetails"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"issues.patch","tags":["Issues"],"summary":"Update an issue's status or severity","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"}],"requestBody":{"required":true,"description":"Fields to update on an issue","content":{"application/json":{"schema":{"type":"object","properties":{"severity":{"type":"string","enum":["critical","high","medium","low","info"]},"status":{"type":"string","enum":["new","triaging","confirmed","dismissed","failed","skipped"]},"resolved":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/Issue"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"delete":{"operationId":"issues.del","tags":["Issues"],"summary":"Delete an issue","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"required":true,"description":"ID of the issue","name":"id","in":"path"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"id":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"_object":{"type":"string","enum":["issue"]}},"required":["id","_object"]}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/issue_triage_rules/{workspaceId}":{"get":{"operationId":"issue-triage-rules.list","tags":["Issues"],"summary":"List provider alert rules and their issue triage state","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","minLength":1},"required":true,"name":"integrationId","in":"query"},{"schema":{"type":"string","enum":["integration","cloud_account"]},"required":true,"name":"kind","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTriageRulesListResult"}},"required":["message","success","error","result"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}},"patch":{"operationId":"issue-triage-rules.patch","tags":["Issues"],"summary":"Toggle automatic issue triage for a connection or an alert rule","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"}],"requestBody":{"required":true,"description":"Toggle automatic triage for a whole connection (root) or a single rule","content":{"application/json":{"schema":{"type":"object","properties":{"integrationId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["integration","cloud_account"]},"scope":{"type":"string","enum":["root","rule"]},"ruleExternalId":{"type":"string","minLength":1},"enabled":{"type":"boolean"}},"required":["integrationId","kind","scope","enabled"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/IssueTriagePatchResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/checks/list":{"post":{"operationId":"checks.list","tags":["Anomaly checks"],"summary":"List anomaly check runs for a scope","requestBody":{"required":true,"description":"Scope and filters for the check runs to list","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"],"description":"Scope kind the check runs belong to"},"resourceId":{"type":"string","description":"Id of the scoped resource, cloud account, or integration"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"nodeType":{"type":"string"},"includeStable":{"type":"boolean","description":"Include runs where no active evaluation happened (default true)"},"since":{"type":"integer"},"until":{"type":"integer"},"limit":{"type":"integer","minimum":1,"maximum":1000}},"required":["workspaceId","resourceKind","resourceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CheckRun"}},"count":{"type":"number","minimum":0,"description":"Number of items available"}},"required":["items","count"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/checks/{workspaceId}/stats":{"get":{"operationId":"checks.stats","tags":["Anomaly Checks"],"summary":"Workspace-wide check-run counts over a window (total, healthy, stable, breached)","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"number","nullable":true},"required":false,"name":"from","in":"query"},{"schema":{"type":"number","nullable":true},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"type":"object","properties":{"total":{"type":"number"},"healthy":{"type":"number"},"stable":{"type":"number"},"breached":{"type":"number"},"resourcesChecked":{"type":"number"},"breaches":{"type":"array","items":{"type":"object","properties":{"resourceKind":{"type":"string"},"resourceId":{"type":"string"},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"issueId":{"type":"string","nullable":true},"executedAt":{"type":"number"}},"required":["resourceKind","resourceId","provider","account","region","nodeType","issueId","executedAt"]}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"]},"resourceId":{"type":"string"},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"status":{"type":"string","enum":["healthy","breached","stable"]},"checkRunId":{"type":"string","nullable":true},"issueId":{"type":"string","nullable":true},"executedAt":{"type":"number"}},"required":["id","resourceKind","resourceId","provider","account","region","nodeType","status","checkRunId","issueId","executedAt"]},"description":"Individual check runs in the window, oldest first, capped at 500"}},"required":["total","healthy","stable","breached","resourcesChecked","breaches","items"]}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/checks/get":{"post":{"operationId":"checks.get","tags":["Anomaly checks"],"summary":"Get an anomaly check run","requestBody":{"required":true,"description":"Scope and id of the check run to fetch","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"],"description":"Scope kind the check runs belong to"},"resourceId":{"type":"string","description":"Id of the scoped resource, cloud account, or integration"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"nodeType":{"type":"string"},"id":{"type":"string","description":"ID of the check_run"}},"required":["workspaceId","resourceKind","resourceId","id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/CheckRunWithSignals"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Not found"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/checks/trigger":{"post":{"operationId":"checks.trigger","tags":["Anomaly checks"],"summary":"Trigger a new anomaly check evaluation for a scope","requestBody":{"required":true,"description":"Scope to evaluate now","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"],"description":"Scope kind the check runs belong to"},"resourceId":{"type":"string","description":"Id of the scoped resource, cloud account, or integration"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"nodeType":{"type":"string"}},"required":["workspaceId","resourceKind","resourceId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/CheckRunTriggerResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/agent_tools/{workspaceId}":{"get":{"operationId":"agent_tools.search","tags":["Agent Tools"],"summary":"Discover agent tools available to the workspace and fetch their schemas","parameters":[{"schema":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"required":true,"description":"ID of the workspace","name":"workspaceId","in":"path"},{"schema":{"type":"string","description":"Keywords to search tool names, summaries, and descriptions"},"required":false,"description":"Keywords to search tool names, summaries, and descriptions","name":"query","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":25,"description":"Maximum number of tools to return (1-25, default 10)"},"required":false,"description":"Maximum number of tools to return (1-25, default 10)","name":"limit","in":"query"}],"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AgentToolSearchResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/agent_tools/run":{"post":{"operationId":"agent_tools.run","tags":["Agent Tools"],"summary":"Run an agent tool by name","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace id"},"toolName":{"type":"string","description":"Exact tool name from the search results"},"params":{"type":"object","additionalProperties":{"nullable":true},"description":"The tool's arguments, per its schema"}},"required":["workspaceId","toolName"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AgentToolRunResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}},"/v1/agent_tools/run_code":{"post":{"operationId":"agent_tools.run_code","tags":["Agent Tools"],"summary":"Run TypeScript against the agent tools namespace in one call","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace id"},"code":{"type":"string","description":"Parameterless async arrow calling tools.<name>(args) and returning a result"}},"required":["workspaceId","code"]}}}},"responses":{"200":{"description":"Successful request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"object","properties":{"message":{"type":"string","enum":["Successful request"]}},"required":["message"]},"success":{"type":"boolean","enum":[true]},"error":{"nullable":true},"result":{"$ref":"#/components/schemas/AgentToolRunResult"}},"required":["message","success","error","result"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Bad Request"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Unauthorized"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Payment Required"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Forbidden"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"429":{"description":"Slow down","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Slow down"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","enum":["Internal error"]},"detail":{"type":"string"}},"required":["message"]},"success":{"type":"boolean","enum":[false]},"message":{"nullable":true}},"required":["error","success","message"]}}}}}}}},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"source":{"type":"string","enum":["google","email","github","cli"]},"githubId":{"type":"string","nullable":true},"googleId":{"type":"string","nullable":true},"forename":{"type":"string","example":"John"},"username":{"type":"string","example":"johndoe"},"surname":{"type":"string","nullable":true,"example":"Doe"},"email":{"type":"string","format":"email"},"domain":{"type":"string","minLength":3,"example":"gmail.com"},"personal":{"type":"boolean"},"emailVerified":{"type":"boolean"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["user"]}},"required":["id","source","githubId","googleId","forename","username","surname","email","domain","personal","emailVerified","created","updated","_object"],"additionalProperties":false},"UserEnrichmentWithDossier":{"allOf":[{"$ref":"#/components/schemas/UserEnrichment"},{"type":"object","nullable":true,"properties":{"dossier":{"type":"string","nullable":true,"description":"The full markdown dossier for this enrichment run"}},"required":["dossier"],"additionalProperties":false}]},"UserEnrichment":{"type":"object","properties":{"id":{"type":"string","pattern":"^uenr_[0-9a-z]{24}$","description":"ID of the user_enrichment","example":"uenr_38mg3o4ibc92h8t2efn8csrh"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$"},"status":{"type":"string","enum":["queued","running","complete","failed"]},"trigger":{"type":"string","enum":["signup","manual","refresh","backfill"]},"additionalContext":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"role":{"type":"string","nullable":true},"seniority":{"type":"string","nullable":true,"enum":["founder","exec","lead","ic","student","unknown",null]},"persona":{"type":"string","nullable":true,"enum":["pete-the-indie-hacker","max-the-product-engineer","laura-the-founding-cto","marcus-the-platform-engineer","unknown",null]},"companyName":{"type":"string","nullable":true},"companyUrl":{"type":"string","nullable":true},"companySize":{"type":"string","nullable":true},"companyStage":{"type":"string","nullable":true,"enum":["bootstrap","pre_seed","seed","series_a_plus","public","unknown",null]},"industry":{"type":"string","nullable":true},"icpFit":{"type":"number","nullable":true},"expansionScore":{"type":"number","nullable":true},"buyingRole":{"type":"string","nullable":true,"enum":["economic_buyer","champion","influencer","end_user","unknown",null]},"revOpportunity":{"type":"string","nullable":true,"enum":["free","solo_paid","team","scale","enterprise",null]},"revEstimate":{"type":"number","nullable":true},"teamSizeEstimate":{"type":"number","nullable":true},"paysForTools":{"type":"array","nullable":true,"items":{"type":"string"}},"suggestedIntegrations":{"type":"array","nullable":true,"items":{"type":"string"}},"expansionTriggers":{"type":"array","nullable":true,"items":{"type":"string"}},"outreachTiming":{"type":"string","nullable":true,"enum":["now","within_week","within_month","on_trigger","nurture",null]},"outreachAngle":{"type":"string","nullable":true},"confidence":{"type":"string","nullable":true,"enum":["low","medium","high",null]},"stack":{"type":"array","nullable":true,"items":{"type":"string"}},"primaryCloud":{"type":"string","nullable":true,"enum":["aws","gcp","azure","cloudflare","vercel","fly","render","planetscale","kubernetes","other","unknown",null]},"sources":{"type":"array","nullable":true,"items":{"type":"string"}},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"completed":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","userId","status","trigger","additionalContext","model","error","role","seniority","persona","companyName","companyUrl","companySize","companyStage","industry","icpFit","expansionScore","buyingRole","revOpportunity","revEstimate","teamSizeEstimate","paysForTools","suggestedIntegrations","expansionTriggers","outreachTiming","outreachAngle","confidence","stack","primaryCloud","sources","created","updated","completed"],"additionalProperties":false},"Notification Settings":{"type":"object","properties":{"preferences":{"type":"object","additionalProperties":{"type":"object","properties":{"web":{"type":"boolean"},"email":{"type":"boolean"}},"required":["web","email"],"additionalProperties":false}},"globalChannels":{"type":"object","properties":{"web":{"type":"boolean","description":"Receive notifications via the web console"},"email":{"type":"boolean","description":"Receive notifications via email"}},"required":["web","email"],"additionalProperties":false},"updates":{"type":"object","properties":{"digest":{"type":"boolean","description":"Receive weekly digest"},"product":{"type":"boolean","description":"Receive product updates"},"security":{"type":"boolean","description":"Receive security updates"}},"required":["digest","product","security"],"additionalProperties":false}},"required":["preferences","globalChannels","updates"],"additionalProperties":false},"User Profile":{"type":"object","properties":{"role":{"type":"object","properties":{"id":{"type":"string","enum":["content_creator","researcher","student","knowledge_worker","entrepreneur","designer","developer","marketer","consultant","journalist","librarian","educator","other"]},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false},"origin":{"type":"object","properties":{"id":{"type":"string","enum":["producthunt","friend_colleague","twitter","linkedin","reddit","hacker_news","youtube","podcast","blog_article","search","ai_recommendation","newsletter","conference_event","chrome_extension_store","other"]},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false},"objective":{"type":"object","properties":{"id":{"type":"string","enum":["research_organization","content_curation","knowledge_management","team_collaboration","ai_discovery","reading_list","project_resources","competitive_intelligence","learning_development","replace_browser_bookmarks","content_planning","other"]},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false}},"required":["role","origin","objective"],"additionalProperties":false},"Api Key":{"type":"object","properties":{"id":{"type":"string","pattern":"^(?:polylane|nominal)_[0-9a-z]{64}$","description":"ID of the api_key","example":"polylane_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the API key"},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"}},"lastActive":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["api_key"]}},"required":["id","workspaceId","ownerId","name","scopes","lastActive","created","updated","_object"],"additionalProperties":false},"Telemetry Token":{"type":"object","properties":{"id":{"type":"string","pattern":"^tt_id_[0-9a-z]{64}$","description":"ID of the telemetry_token","example":"tt_id_hciswovf778y8r43gby4n332ey4u1oa9tjsnnxrmdncd7oaotb7vy7tpi97hyg2u"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"token":{"type":"string","pattern":"^tt_[0-9a-z]{64}$","description":"ID of the telemetry_token_token","example":"tt_twz7duqh2vntphgam51681qxfgu5j21uvc31fi4g63kgu8ofbh1khzobzi3wwzdk"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the telemetry token"},"source":{"type":"string","nullable":true,"enum":["integration","cloud_account",null],"description":"Source that created this token","example":"integration"},"sourceResourceId":{"type":"string","nullable":true,"description":"ID of the resource that created this token","example":"integration_abc123"},"provider":{"type":"string","nullable":true,"enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","vercel",null],"description":"Integration provider that created this token","example":"sentry"},"lastActive":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["telemetry_token"]}},"required":["id","workspaceId","token","ownerId","name","source","sourceResourceId","provider","lastActive","created","updated","_object"],"additionalProperties":false},"Workspace":{"type":"object","properties":{"id":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"slug":{"type":"string","minLength":4,"maxLength":1024,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","example":"acme"},"domain":{"type":"string","nullable":true,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","example":"acme.com"},"description":{"type":"string","nullable":true,"maxLength":2000},"name":{"type":"string","minLength":4,"maxLength":128,"example":"Acme Inc"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"llmProvider":{"type":"string","enum":["recommended","openai","anthropic","gemini","deepseek","qwen","kimi","x","z","minimax","custom"]},"llmProviderBaseUrl":{"type":"string","nullable":true},"llmProviderApiKey":{"type":"string","nullable":true},"llmModelTiers":{"$ref":"#/components/schemas/CustomModelTiers"},"llmProviderAuthHeader":{"type":"string","nullable":true},"llmProviderModelsUrl":{"type":"string","nullable":true},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["workspace"]}},"required":["id","ownerId","createdBy","lastEditedBy","slug","domain","description","name","created","updated","llmProvider","llmProviderBaseUrl","llmProviderApiKey","llmModelTiers","llmProviderAuthHeader","llmProviderModelsUrl","_object"],"additionalProperties":false},"CustomModelTiers":{"type":"object","nullable":true,"properties":{"premium":{"type":"string","maxLength":200},"standard":{"type":"string","maxLength":200},"cheap":{"type":"string","maxLength":200},"code":{"type":"string","maxLength":200},"embeddings":{"type":"string","maxLength":200},"reranker":{"type":"string","maxLength":200}},"additionalProperties":false},"Public Workspace":{"type":"object","properties":{"id":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":4,"maxLength":128,"example":"Acme Inc"},"description":{"type":"string","nullable":true,"maxLength":2000},"slug":{"type":"string","minLength":3,"maxLength":1024,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","example":"acme"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["workspace"]}},"required":["id","name","description","slug","_object"],"additionalProperties":false},"PlanLimits":{"type":"object","properties":{"maxCloudAccounts":{"type":"number","description":"Max connected cloud accounts"},"maxNormalizedTokens":{"type":"number","description":"Monthly normalized token budget"},"maxWorkspaceMembers":{"type":"number","description":"Max members in workspace"},"maxAutomations":{"type":"number","description":"Max automations per workspace"},"maxInvestigationsPerDay":{"type":"number","default":-1,"description":"Max investigations started per rolling 24h"},"includedAutofixesPerMonth":{"type":"number","default":-1,"description":"Autofixes included per billing month"},"maxPrAnalysesPerMonth":{"type":"number","default":-1,"description":"Max PR analyses per billing month"},"minAutomationRunIntervalMinutes":{"type":"number","default":0,"description":"Minimum minutes between two runs of the same automation"}},"required":["maxCloudAccounts","maxNormalizedTokens","maxWorkspaceMembers","maxAutomations"],"additionalProperties":false},"Usage":{"type":"object","properties":{"normalizedTokens":{"type":"number","description":"Cost-weighted token usage for the current billing period"}},"required":["normalizedTokens"],"additionalProperties":false},"WorkspaceEnrichmentWithDossier":{"allOf":[{"$ref":"#/components/schemas/WorkspaceEnrichment"},{"type":"object","nullable":true,"properties":{"dossier":{"type":"string","nullable":true,"description":"The full markdown dossier for this enrichment run"}},"required":["dossier"],"additionalProperties":false}]},"WorkspaceEnrichment":{"type":"object","properties":{"id":{"type":"string","pattern":"^wenr_[0-9a-z]{24}$","description":"ID of the workspace_enrichment","example":"wenr_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"status":{"type":"string","enum":["queued","running","complete","failed"]},"trigger":{"type":"string","enum":["signup","manual","refresh","backfill"]},"additionalContext":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"companyName":{"type":"string","nullable":true},"companyUrl":{"type":"string","nullable":true},"companySize":{"type":"string","nullable":true},"companyStage":{"type":"string","nullable":true,"enum":["bootstrap","pre_seed","seed","series_a_plus","public","unknown",null]},"industry":{"type":"string","nullable":true},"engineeringTeamSize":{"type":"number","nullable":true},"stack":{"type":"array","nullable":true,"items":{"type":"string"}},"primaryCloud":{"type":"string","nullable":true,"enum":["aws","gcp","azure","cloudflare","vercel","fly","render","planetscale","kubernetes","other","unknown",null]},"detectedTools":{"type":"array","nullable":true,"items":{"type":"string"}},"connectedProviders":{"type":"array","nullable":true,"items":{"type":"string"}},"unconnectedSupported":{"type":"array","nullable":true,"items":{"type":"string"}},"icpFit":{"type":"number","nullable":true},"expansionScore":{"type":"number","nullable":true},"revOpportunity":{"type":"string","nullable":true,"enum":["free","solo_paid","team","scale","enterprise",null]},"revEstimate":{"type":"number","nullable":true},"seatPotential":{"type":"number","nullable":true},"recommendedPlan":{"type":"string","nullable":true},"expansionTriggers":{"type":"array","nullable":true,"items":{"type":"string"}},"nextContactAt":{"type":"string","nullable":true,"format":"date-time"},"contactReason":{"type":"string","nullable":true},"outreachAngle":{"type":"string","nullable":true},"confidence":{"type":"string","nullable":true,"enum":["low","medium","high",null]},"sources":{"type":"array","nullable":true,"items":{"type":"string"}},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"completed":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","workspaceId","status","trigger","additionalContext","model","error","companyName","companyUrl","companySize","companyStage","industry","engineeringTeamSize","stack","primaryCloud","detectedTools","connectedProviders","unconnectedSupported","icpFit","expansionScore","revOpportunity","revEstimate","seatPotential","recommendedPlan","expansionTriggers","nextContactAt","contactReason","outreachAngle","confidence","sources","created","updated","completed"],"additionalProperties":false},"ObservabilitySettings":{"type":"object","properties":{"nativeObservability":{"$ref":"#/components/schemas/NativeObservabilityConfig"}},"required":["nativeObservability"]},"NativeObservabilityConfig":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether native observability (ClickHouse telemetry) is enabled for this workspace"}},"required":["enabled"],"additionalProperties":false},"InvestigationsSettings":{"type":"object","properties":{"investigations":{"$ref":"#/components/schemas/InvestigationsConfig"}},"required":["investigations"]},"InvestigationsConfig":{"type":"object","properties":{"passesPerHypothesis":{"type":"integer","minimum":1,"maximum":12,"description":"Number of parallel analysis passes run per hypothesis during an investigation"}},"required":["passesPerHypothesis"],"additionalProperties":false},"DigestSettings":{"type":"object","properties":{"weeklyDigestDisabledAt":{"type":"number","nullable":true,"description":"When the weekly digest was disabled for this workspace, or null if enabled"}},"required":["weeklyDigestDisabledAt"]},"InvestigationLimitsSettings":{"type":"object","properties":{"investigationLimits":{"$ref":"#/components/schemas/InvestigationLimitsConfig"}},"required":["investigationLimits"]},"InvestigationLimitsConfig":{"type":"object","properties":{"per24h":{"type":"integer","nullable":true,"minimum":1,"maximum":1000,"description":"Max investigations started per rolling 24h window. null means unlimited."}},"required":["per24h"],"additionalProperties":false},"InvestigationUsage":{"type":"object","properties":{"used":{"type":"integer","description":"Investigations started in the rolling 24h window."},"limit":{"type":"integer","nullable":true,"description":"Max investigations per rolling 24h window. null means unlimited."},"remaining":{"type":"integer","nullable":true,"description":"Investigations that can still start in the window. null means unlimited."}},"required":["used","limit","remaining"]},"PrReviewsSettings":{"type":"object","properties":{"prReviews":{"$ref":"#/components/schemas/PrReviewsConfig"}},"required":["prReviews"]},"PrReviewsConfig":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When set, pull requests are not reviewed for production impact on any repository in the workspace"},"guestLinksDisabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When set, new review threads are visible to workspace members only and pull request comments link the member view instead of a signed guest link"}},"required":["disabledAt","guestLinksDisabledAt"],"additionalProperties":false},"PatchPrReviewsConfig":{"type":"object","properties":{"disabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When set, pull requests are not reviewed for production impact on any repository in the workspace"},"guestLinksDisabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When set, new review threads are visible to workspace members only and pull request comments link the member view instead of a signed guest link"}},"additionalProperties":false},"Invite":{"type":"object","properties":{"id":{"type":"string","pattern":"^inv_[0-9a-z]{64}$","description":"ID of the invite","example":"inv_gepzgu225yzyyv9mp485wbjwwrhwgvjwkammgcv5uzm1jorkgeqezkxz7x5ad1ha"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"token":{"type":"string","nullable":true},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"acceptedBy":{"type":"string","nullable":true,"pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"email":{"type":"string","format":"email"},"position":{"type":"string","enum":["owner","admin","member","read-only"]},"status":{"type":"string","enum":["pending","accepted","expired","revoked"]},"acceptedAt":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["invite"]}},"required":["id","workspaceId","token","createdBy","acceptedBy","email","position","status","acceptedAt","created","updated","_object"],"additionalProperties":false},"Workspace Member":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"invitedBy":{"type":"string","nullable":true,"pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"forename":{"type":"string","example":"John"},"username":{"type":"string","example":"johndoe"},"email":{"type":"string","format":"email","example":"john@doe.com"},"surname":{"type":"string","nullable":true,"example":"Doe"},"position":{"type":"string","enum":["owner","admin","member","read-only"]},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"}},"lastActive":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["workspace_member"]}},"required":["workspaceId","userId","invitedBy","forename","username","email","surname","position","scopes","lastActive","created","updated","_object"],"additionalProperties":false},"Join Via Guest Link":{"type":"object","properties":{"token":{"type":"string","minLength":1,"description":"The signed guest link token embedded in the PR comment"},"threadId":{"type":"string","minLength":1,"description":"The PR review thread the guest link was minted for"}},"required":["token","threadId"],"additionalProperties":false},"Session":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9]+$","description":"ID of the session","example":""},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"expiresAt":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["session"]}},"required":["id","userId","expiresAt","created","updated","_object"],"additionalProperties":false},"Notification":{"type":"object","properties":{"id":{"type":"string","pattern":"^notif_[0-9a-z]{32}$","description":"ID of the notification","example":"notif_d18564pxsvozx979j3532mii2kk7pmw6"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"workspaceId":{"type":"string","nullable":true,"pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"triggerId":{"anyOf":[{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},{"type":"string","enum":["system"]}]},"category":{"type":"string","enum":["security","billing","workspace","internal","transactional"]},"title":{"type":"string"},"body":{"type":"string"},"action":{"type":"string"},"ctaUrl":{"type":"string","nullable":true},"cta":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"]},"metadata":{"type":"object","nullable":true,"additionalProperties":{"type":"string"}},"deleted":{"type":"string","nullable":true,"format":"date-time"},"seen":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["notification"]}},"required":["id","userId","workspaceId","triggerId","category","title","body","action","ctaUrl","cta","priority","metadata","deleted","seen","updated","created","_object"],"additionalProperties":false},"OAuth Client":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the OAuth client","example":"oauth_client_efw4pgjae0n4vq2i5l98cozm"},"name":{"type":"string","minLength":4,"description":"The name of the OAuth client","example":"My Application"},"description":{"type":"string","nullable":true,"description":"A description of the OAuth client","example":"A sample OAuth application"},"email":{"type":"string","description":"Contact email for the OAuth client","example":"contact@example.com"},"redirectUris":{"type":"array","items":{"type":"string","format":"uri"},"description":"Valid redirect URIs for this client","example":["https://example.com/callback"]},"scopes":{"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:delete","workspace_members:read","workspace_members:write","workspace_members:delete","billing:read","billing:write","subscriptions:read","subscriptions:write","threads:read","threads:write","threads:delete","repositories:read","repositories:write","repositories:delete","ratings:write","messages:read","messages:write","messages:delete","integrations:read","integrations:write","integrations:delete","cloud_accounts:read","cloud_accounts:write","cloud_accounts:delete","memories:read","memories:write","memories:delete","cloud_infra:read","cloud_infra:write","cloud_infra:delete","analytics:read","analytics:export","audit_logs:read","audit_logs:export","api_keys:read","api_keys:write","api_keys:delete","telemetry_tokens:read","telemetry_tokens:write","telemetry_tokens:delete","datasets:read","datasets:write","datasets:delete","automations:read","automations:write","automations:delete","autofixes:read","autofixes:write","autofixes:delete","teams:read","teams:write","teams:delete","labels:read","labels:write","labels:delete","oauth_clients:read","oauth_clients:write","oauth_clients:delete","skills:read","skills:write","skills:delete","agent_tools:read","agent_tools:write","issues:read","issues:write","issues:delete","pages:read","pages:delete"],"description":"Permission scope label","example":"workspaces:read"},"description":"Allowed scopes for this client","example":["profile","email"]},"logoUrl":{"type":"string","nullable":true,"format":"uri","description":"URL of the client's logo","example":"https://example.com/logo.png"},"websiteUrl":{"type":"string","nullable":true,"format":"uri","description":"URL of the client's website","example":"https://example.com"},"privacyPolicyUrl":{"type":"string","nullable":true,"format":"uri","description":"URL of the client's privacy policy","example":"https://example.com/privacy"},"termsOfServiceUrl":{"type":"string","nullable":true,"format":"uri","description":"URL of the client's terms of service","example":"https://example.com/terms"},"isActive":{"type":"boolean","description":"Whether the client is active","example":true},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the client was created","example":"2026-07-28T12:22:39.948Z"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"When the client was last updated","example":"2026-07-28T12:22:39.948Z"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["oauth_client"]}},"required":["id","name","description","email","redirectUris","scopes","logoUrl","websiteUrl","privacyPolicyUrl","termsOfServiceUrl","isActive","created","updated","_object"]},"OAuth Client With Secret":{"allOf":[{"$ref":"#/components/schemas/OAuth Client"},{"type":"object","properties":{"clientSecret":{"type":"string","description":"The client secret. Only returned on creation and rotation; store it securely as it cannot be retrieved again.","example":"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"}},"required":["clientSecret"]}]},"Email":{"type":"object","properties":{"id":{"type":"string","pattern":"^email_[0-9a-z]{24}$","description":"ID of the email","example":"email_38mg3o4ibc92h8t2efn8csrh"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","description":"ID of the user","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"from":{"type":"string"},"to":{"type":"string"},"subject":{"type":"string","nullable":true},"body":{"type":"string","nullable":true},"emailId":{"type":"string","nullable":true},"template":{"type":"string","nullable":true},"replyTo":{"type":"string","nullable":true},"params":{"type":"object","nullable":true,"additionalProperties":{"type":"string"}},"direction":{"type":"string","enum":["inbound","outbound"]},"receivedAt":{"type":"string","nullable":true,"format":"date-time"},"repliedAt":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["email"]}},"required":["id","userId","from","to","subject","body","emailId","template","replyTo","params","direction","receivedAt","repliedAt","created","_object"],"additionalProperties":false},"Team":{"type":"object","properties":{"id":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","description":"Team name"},"slug":{"type":"string","description":"URL-friendly team identifier"},"description":{"type":"string","nullable":true,"description":"Team description"},"color":{"type":"string","nullable":true,"description":"Hex color for UI badges"},"icon":{"type":"string","nullable":true,"description":"Icon identifier"},"createdBy":{"type":"string","description":"User who created the team"},"created":{"type":"string","nullable":true,"format":"date-time","description":"Creation timestamp"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"Last update timestamp"},"_object":{"type":"string","enum":["team"]}},"required":["id","workspaceId","name","slug","description","color","icon","createdBy","created","updated","_object"],"additionalProperties":false},"TeamMember":{"type":"object","properties":{"teamId":{"type":"string","pattern":"^team_[0-9a-z]{24}$","description":"ID of the team","example":"team_38mg3o4ibc92h8t2efn8csrh"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"User ID"},"addedBy":{"type":"string","description":"User who added this member"},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the member was added"},"_object":{"type":"string","enum":["team_member"]}},"required":["teamId","userId","addedBy","created","_object"],"additionalProperties":false},"Label":{"type":"object","properties":{"id":{"type":"string","pattern":"^lbl_[0-9a-z]{24}$","description":"ID of the label","example":"lbl_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","description":"Label name"},"color":{"type":"string","description":"Hex color code"},"description":{"type":"string","nullable":true,"description":"Label description"},"createdBy":{"type":"string","description":"User who created the label"},"created":{"type":"string","nullable":true,"format":"date-time","description":"Creation timestamp"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"Last update timestamp"},"_object":{"type":"string","enum":["label"]}},"required":["id","workspaceId","name","color","description","createdBy","created","updated","_object"],"additionalProperties":false},"RepositoryEnvironment":{"type":"object","properties":{"id":{"type":"string","pattern":"^renv_[0-9a-z]{24}$","description":"ID of the repository_environment","example":"renv_38mg3o4ibc92h8t2efn8csrh"},"repositoryId":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"Repository this environment belongs to","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"containerImage":{"type":"string","description":"Container base image name"},"preinstalledPackages":{"$ref":"#/components/schemas/PreinstalledPackages"},"setupScriptMode":{"type":"string","enum":["automatic","manual"],"description":"Automatic or manual dependency installation"},"setupScript":{"type":"string","nullable":true,"description":"Bash setup script run after repo clone (manual mode)"},"maintenanceScript":{"type":"string","nullable":true,"description":"Bash script run when a cached container is resumed"},"prReviewInstructions":{"type":"string","nullable":true,"description":"Repository-specific instructions for the pull request production-impact review"},"prReviewCheckDisabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When null, the pull request review posts a GitHub check that fails on production concerns, so branch protection can block merging; set to disable the check"},"prReviewsDisabledAt":{"type":"string","nullable":true,"format":"date-time","description":"When set, pull requests on this repository are not reviewed for production impact"},"envVars":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment variables for setup and agent execution"},"secrets":{"type":"object","additionalProperties":{"type":"string"},"description":"Encrypted secrets available only during setup"},"cachingEnabled":{"type":"boolean","description":"Whether to cache sandbox state after setup"},"cacheBackupId":{"type":"string","nullable":true,"description":"Backup ID of cached sandbox state"},"cacheCreatedAt":{"type":"string","nullable":true,"format":"date-time","description":"When the cache was created"},"cacheExpiresAt":{"type":"string","nullable":true,"format":"date-time","description":"When the cache expires"},"cacheInvalidated":{"type":"boolean","description":"Whether the cache was invalidated by a config change"},"internetAccess":{"type":"string","enum":["off","on"],"description":"Agent internet access during execution"},"domainAllowlistPreset":{"type":"string","enum":["none","common_dependencies","all"],"description":"Preset domain allowlist for outbound requests"},"domainAllowlistCustom":{"type":"array","items":{"type":"string"},"description":"Additional allowed domains"},"allowedHttpMethods":{"type":"array","items":{"type":"string"},"description":"Allowed HTTP methods for outbound requests"},"status":{"type":"string","enum":["ready","setting_up","errored"],"description":"Setup status of the environment"},"errorReport":{"type":"string","nullable":true,"description":"Error report from failed setup"},"createdBy":{"type":"string","description":"User who created this configuration"},"lastEditedBy":{"type":"string","description":"User who last edited this configuration"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["repository_environment"]}},"required":["id","repositoryId","containerImage","preinstalledPackages","setupScriptMode","setupScript","maintenanceScript","prReviewInstructions","prReviewCheckDisabledAt","prReviewsDisabledAt","envVars","secrets","cachingEnabled","cacheBackupId","cacheCreatedAt","cacheExpiresAt","cacheInvalidated","internetAccess","domainAllowlistPreset","domainAllowlistCustom","allowedHttpMethods","status","errorReport","createdBy","lastEditedBy","created","updated","_object"],"additionalProperties":false},"PreinstalledPackages":{"type":"object","properties":{"python":{"type":"string","description":"Python version (e.g. '3.12')"},"node":{"type":"string","description":"Node.js version (e.g. '20')"},"ruby":{"type":"string","description":"Ruby version (e.g. '3.4.4')"},"rust":{"type":"string","description":"Rust version (e.g. '1.89.0')"},"go":{"type":"string","description":"Go version (e.g. '1.24.3')"},"bun":{"type":"string","description":"Bun version (e.g. '1.2.14')"},"php":{"type":"string","description":"PHP version (e.g. '8.4')"},"java":{"type":"string","description":"Java version (e.g. '21')"},"swift":{"type":"string","description":"Swift version (e.g. '6.1')"},"dotnet":{"type":"string","description":".NET SDK version (e.g. '9.0')"},"elixir":{"type":"string","description":"Elixir version (e.g. '1.18')"},"scala":{"type":"string","description":"Scala version (via sbt, e.g. '3.6')"},"flutter":{"type":"string","description":"Flutter SDK version (e.g. '3.32')"}},"description":"Runtime versions to pre-install in the sandbox"},"Repository":{"type":"object","properties":{"id":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","description":"Name of the repository"},"owner":{"type":"string","description":"Owner of the repository"},"remoteId":{"type":"string","description":"ID of the repository as defined in the git provider"},"integrationId":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"description":{"type":"string","nullable":true,"description":"Description of the repository"},"provider":{"type":"string","enum":["github"],"description":"Git provider"},"keywords":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["ready","syncing","new","errored"],"description":"Sync status of the repository"},"metadata":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["github"]},"defaultBranch":{"type":"string"},"nodeId":{"type":"string"},"visibility":{"type":"string"},"private":{"type":"boolean"},"fullName":{"type":"string"},"id":{"type":"number"},"owner":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"homepage":{"type":"string","nullable":true},"topics":{"type":"array","items":{"type":"string"}}},"required":["provider","defaultBranch","nodeId","private","fullName","id","owner","name","url"]}],"description":"Metadata related to the repository"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"lastSync":{"type":"string","nullable":true,"format":"date-time"},"disabled":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["repository"]}},"required":["id","workspaceId","name","owner","remoteId","integrationId","description","provider","keywords","labels","status","metadata","createdBy","lastEditedBy","created","updated","lastSync","disabled","_object"],"additionalProperties":false},"RepositoryInstrumentationReport":{"type":"object","properties":{"summary":{"type":"object","nullable":true,"properties":{"routesTotal":{"type":"number"},"routesInstrumented":{"type":"number"},"darkRoutes":{"type":"number"},"scannedSha":{"type":"string"},"computedAt":{"type":"number"}},"required":["routesTotal","routesInstrumented","darkRoutes","scannedSha","computedAt"]},"findings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ruleId":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]},"title":{"type":"string"},"message":{"type":"string"},"remediation":{"type":"string"},"filePath":{"type":"string","nullable":true},"line":{"type":"number","nullable":true},"routes":{"type":"array","nullable":true,"items":{"type":"string"}},"dismissedAtMs":{"type":"number","nullable":true},"dismissedBy":{"type":"string","nullable":true}},"required":["id","ruleId","severity","title","message","remediation","filePath","line","routes","dismissedAtMs","dismissedBy"]}}},"required":["summary","findings"]},"RepositoryAdvisoryDismissal":{"type":"object","properties":{"id":{"type":"string"},"dismissedAtMs":{"type":"number","nullable":true},"dismissedBy":{"type":"string","nullable":true}},"required":["id","dismissedAtMs","dismissedBy"]},"PrChangeRecord":{"type":"object","properties":{"id":{"type":"string"},"repositoryId":{"type":"string"},"prNumber":{"type":"number"},"prTitle":{"type":"string"},"prAuthor":{"type":"string","nullable":true},"prUrl":{"type":"string"},"baseRef":{"type":"string"},"headRef":{"type":"string"},"headSha":{"type":"string"},"verdict":{"type":"string","enum":["fail","pass"]},"title":{"type":"string"},"tldr":{"type":"string"},"impactLevel":{"type":"string","enum":["none","low","moderate","high"]},"affectedResourceIds":{"type":"array","items":{"type":"string"}},"threadId":{"type":"string","nullable":true},"autofixId":{"type":"string","nullable":true},"commentId":{"type":"number","nullable":true},"commentedAtMs":{"type":"number","nullable":true},"dismissedAtMs":{"type":"number","nullable":true},"dismissedBy":{"type":"string","nullable":true},"resolvedAtMs":{"type":"number","nullable":true},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","repositoryId","prNumber","prTitle","prAuthor","prUrl","baseRef","headRef","headSha","verdict","title","tldr","impactLevel","affectedResourceIds","threadId","autofixId","commentId","commentedAtMs","dismissedAtMs","dismissedBy","resolvedAtMs","created","updated"]},"PrChangeRecordDetail":{"allOf":[{"$ref":"#/components/schemas/PrChangeRecord"},{"type":"object","properties":{"comment":{"type":"string","nullable":true,"description":"The comment markdown posted for this analysis; null when no comment was produced"}},"required":["comment"]}]},"PrChangeRecordDismissal":{"type":"object","properties":{"id":{"type":"string"},"dismissedAtMs":{"type":"number","nullable":true},"dismissedBy":{"type":"string","nullable":true}},"required":["id","dismissedAtMs","dismissedBy"]},"PrChangeRecordFix":{"type":"object","properties":{"id":{"type":"string"},"autofixId":{"type":"string"}},"required":["id","autofixId"]},"Code Chunk":{"type":"object","properties":{"id":{"type":"string","pattern":"^chk_[0-9a-z]{32}$","description":"ID of the chunk","example":"chk_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"repositoryId":{"type":"string"},"text":{"type":"string"},"path":{"type":"string"},"sha":{"type":"string"},"branch":{"type":"string"},"symbol":{"type":"string","nullable":true},"language":{"type":"string"},"type":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["chunk"]}},"required":["id","workspaceId","repositoryId","text","path","sha","branch","symbol","language","type","start","end","created","updated","_object"],"additionalProperties":false},"Code File":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"path":{"type":"string","description":"Path to the codefile"},"status":{"type":"string","enum":["ready","syncing","new","failed"],"description":"Sync status of the code file"},"metadata":{"type":"object","properties":{},"description":"Metadata related to the code file"},"sha":{"type":"string"},"branch":{"type":"string"},"language":{"type":"string","nullable":true},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"lastSync":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["codefile"]}},"required":["workspaceId","path","status","metadata","sha","branch","language","created","updated","lastSync","_object"],"additionalProperties":false},"AdminRepositoryScanQueued":{"type":"object","properties":{"queued":{"type":"boolean","enum":[true]},"repositoryId":{"type":"string"}},"required":["queued","repositoryId"]},"AdminFinetuningDataPurgeQueued":{"type":"object","properties":{"queued":{"type":"boolean","enum":[true]},"workspaceId":{"type":"string"}},"required":["queued","workspaceId"]},"MapPublishResponse":{"type":"object","properties":{"slug":{"type":"string"},"url":{"type":"string"},"score":{"type":"integer"},"editToken":{"type":"string"},"expiresAt":{"type":"string","nullable":true,"description":"When an unclaimed map expires, ISO 8601. Null once the map is claimed."}},"required":["slug","url","score","editToken","expiresAt"]},"PublicMapList":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicMapListItem"}},"count":{"type":"integer"}},"required":["items","count"]},"PublicMapListItem":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"repository":{"type":"string","nullable":true},"score":{"type":"integer"},"nodes":{"type":"integer","nullable":true},"coveragePercent":{"type":"integer","nullable":true},"created":{"type":"string"},"updated":{"type":"string"}},"required":["slug","name","repository","score","nodes","coveragePercent","created","updated"]},"PublicMap":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"score":{"type":"integer"},"scoreVersion":{"type":"integer"},"claimed":{"type":"boolean"},"expiresAt":{"type":"string","nullable":true},"created":{"type":"string"},"updated":{"type":"string"},"document":{"$ref":"#/components/schemas/MapDocument"},"stats":{"$ref":"#/components/schemas/MapStats"},"breakdown":{"$ref":"#/components/schemas/MapScoreBreakdown"},"history":{"type":"array","items":{"$ref":"#/components/schemas/MapHistoryEntry"},"description":"One entry per publish, oldest first. Empty for maps published before versioning."},"changes":{"allOf":[{"$ref":"#/components/schemas/MapVersionChanges"},{"description":"Diff between the latest publish and the one before it, when known."}]},"percentile":{"type":"integer","nullable":true,"description":"Share of live maps this map scores higher than, 0-100. Null until enough maps exist to compare."}},"required":["slug","name","score","scoreVersion","claimed","expiresAt","created","updated","document","stats","breakdown","history","changes","percentile"]},"MapDocument":{"type":"object","properties":{"version":{"type":"number","enum":[1]},"project":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":48},"slug":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"tagline":{"type":"string","maxLength":80},"iconDomain":{"type":"string","maxLength":253,"pattern":"^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,}$/i"},"repository":{"type":"string","maxLength":100,"pattern":"^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$"},"remote":{"type":"string","maxLength":200},"commit":{"type":"string","pattern":"^[0-9a-f]{7,40}$/i"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["name","slug","date"],"additionalProperties":false},"analysis":{"type":"string","minLength":1,"maxLength":2000},"signals":{"type":"object","properties":{"structuredLogs":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"tracing":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"errorTracking":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"alerting":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"healthChecks":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"resilience":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"iac":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"},"ciChecks":{"type":"string","enum":["yes","partial","no","unknown"],"default":"unknown"}},"additionalProperties":false},"findings":{"type":"object","properties":{"structuredLogs":{"type":"string","minLength":1,"maxLength":300},"tracing":{"type":"string","minLength":1,"maxLength":300},"errorTracking":{"type":"string","minLength":1,"maxLength":300},"alerting":{"type":"string","minLength":1,"maxLength":300},"healthChecks":{"type":"string","minLength":1,"maxLength":300},"resilience":{"type":"string","minLength":1,"maxLength":300},"iac":{"type":"string","minLength":1,"maxLength":300},"ciChecks":{"type":"string","minLength":1,"maxLength":300}}},"graph":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":28},"kind":{"type":"string","enum":["entry","cron","queue","agent","model","service","store","external","platform"]},"type":{"type":"string","maxLength":64},"tier":{"type":"integer","minimum":1,"maximum":4},"sub":{"type":"string","maxLength":40},"group":{"type":"string","maxLength":24},"domain":{"type":"string","maxLength":253,"pattern":"^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,}$/i"},"sourceRef":{"type":"string","maxLength":120},"telemetry":{"type":"string","enum":["logs","traces","logs+traces","none","unknown"]},"detail":{"type":"string","maxLength":200}},"required":["id","label","kind"],"additionalProperties":false},"minItems":1},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1},"to":{"type":"string","minLength":1},"kind":{"type":"string","enum":["calls","reads","writes","triggers","deploys_to"]},"label":{"type":"string","maxLength":24}},"required":["from","to"],"additionalProperties":false}}},"required":["nodes","edges"],"additionalProperties":false}},"required":["version","project","signals","graph"],"additionalProperties":false},"MapStats":{"type":"object","properties":{"nodes":{"type":"integer"},"edges":{"type":"integer"},"kinds":{"type":"object","additionalProperties":{"type":"integer"}},"groups":{"type":"array","items":{"type":"string"}},"darkNodeIds":{"type":"array","items":{"type":"string"}},"unknownTelemetryNodeIds":{"type":"array","items":{"type":"string"}},"telemetryCoveragePercent":{"type":"integer","nullable":true}},"required":["nodes","edges","kinds","groups","darkNodeIds","unknownTelemetryNodeIds","telemetryCoveragePercent"]},"MapScoreBreakdown":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"scoreVersion":{"type":"integer"},"signalKeys":{"type":"array","items":{"type":"string","enum":["structuredLogs","tracing","errorTracking","alerting","healthChecks","resilience","iac","ciChecks"]},"description":"The signals this rubric version scores, in display order."},"signalsPoints":{"type":"number"},"signalsMaxPoints":{"type":"number"},"perSignalPoints":{"type":"number"},"coveragePoints":{"type":"number"},"coverageMaxPoints":{"type":"number"},"coverableNodes":{"type":"integer"},"coveredNodes":{"type":"integer"}},"required":["score","scoreVersion","signalKeys","signalsPoints","signalsMaxPoints","perSignalPoints","coveragePoints","coverageMaxPoints","coverableNodes","coveredNodes"]},"MapHistoryEntry":{"type":"object","properties":{"version":{"type":"integer"},"score":{"type":"integer"},"coveragePercent":{"type":"integer","nullable":true},"created":{"type":"string"},"changes":{"$ref":"#/components/schemas/MapVersionChanges"}},"required":["version","score","coveragePercent","created","changes"]},"MapVersionChanges":{"type":"object","nullable":true,"properties":{"scoreFrom":{"type":"integer"},"scoreTo":{"type":"integer"},"coverageFrom":{"type":"integer","nullable":true},"coverageTo":{"type":"integer","nullable":true},"addedCount":{"type":"integer"},"removedCount":{"type":"integer"},"addedNodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string","enum":["entry","cron","queue","agent","model","service","store","external","platform"]}},"required":["id","label","kind"]}},"removedNodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string","enum":["entry","cron","queue","agent","model","service","store","external","platform"]}},"required":["id","label","kind"]}},"signalChanges":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["structuredLogs","tracing","errorTracking","alerting","healthChecks","resilience","iac","ciChecks"]},"from":{"type":"string","enum":["yes","partial","no","unknown"]},"to":{"type":"string","enum":["yes","partial","no","unknown"]}},"required":["key","from","to"]}},"newlyCoveredNodeIds":{"type":"array","items":{"type":"string"}}},"required":["scoreFrom","scoreTo","coverageFrom","coverageTo","addedCount","removedCount","addedNodes","removedNodes","signalChanges","newlyCoveredNodeIds"]},"MapClaimResult":{"type":"object","properties":{"slug":{"type":"string"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"url":{"type":"string"}},"required":["slug","workspaceId","url"]},"MapClaimBody":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"}},"required":["workspaceId"]},"MapDeleteResult":{"type":"object","properties":{"slug":{"type":"string"}},"required":["slug"]},"Integration":{"type":"object","properties":{"id":{"type":"string","pattern":"^int_[0-9a-z]{24}$","description":"ID of the integration","example":"int_34gky74ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the integration"},"installationId":{"type":"string","description":"Installation ID of the integration"},"externalId":{"type":"string","nullable":true,"description":"External ID of the integration"},"type":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"],"description":"Integration type"},"metadata":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"data":{"type":"object","properties":{"teamId":{"type":"string"},"teamName":{"type":"string"},"teamDomain":{"type":"string"},"appId":{"type":"string"},"botUserId":{"type":"string"},"botScope":{"type":"string"},"authedUserId":{"type":"string"},"installedAt":{"type":"number"},"botTokenCipher":{"type":"string"},"userTokenCipher":{"type":"string"},"enterpriseId":{"type":"string"},"enterpriseName":{"type":"string"},"notificationsChannelId":{"type":"string"},"notificationsChannelName":{"type":"string"},"notificationsDisabledAt":{"type":"number"},"proactive":{"type":"object","properties":{"threshold":{"type":"number","minimum":0,"maximum":1},"mentionOnlyChannels":{"type":"array","items":{"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"disabledAt":{"type":"number"},"disabledBy":{"type":"string"}},"required":["channelId","disabledAt","disabledBy"]}},"rateLimits":{"type":"object","properties":{"perChannelPerHour":{"type":"number"},"perWorkspacePerHour":{"type":"number"}}}},"required":["mentionOnlyChannels"]}},"required":["teamId","teamName","appId","botUserId","botScope","authedUserId","installedAt","botTokenCipher"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["github"]},"installationId":{"type":"string"},"installation":{"nullable":true}},"required":["type","installationId"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog"]},"site":{"type":"string"},"apiKey":{"type":"string"},"appKey":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"organizationName":{"type":"string"},"webhookName":{"type":"string"},"telemetryToken":{"type":"string"}},"required":["type","site","apiKey","appKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb"]},"region":{"type":"string","enum":["us","eu"]},"apiKey":{"type":"string"},"teamSlug":{"type":"string"},"environmentSlug":{"type":"string"},"teamName":{"type":"string"},"environmentName":{"type":"string"},"recipientId":{"type":"string"},"telemetryToken":{"type":"string"}},"required":["type","region","apiKey","teamSlug","environmentSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom"]},"region":{"type":"string","enum":["us-east-1","eu-central-1"]},"apiToken":{"type":"string"},"notifierId":{"type":"string"},"telemetryToken":{"type":"string"}},"required":["type","region","apiToken"]},{"type":"object","properties":{"type":{"type":"string","enum":["betterstack"]},"apiToken":{"type":"string"},"uptimeApiToken":{"type":"string"},"telemetryApiToken":{"type":"string"},"webhookId":{"type":"string"},"telemetryToken":{"type":"string"}},"required":["type","apiToken"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry"]},"organizationSlug":{"type":"string"},"organizationName":{"type":"string"},"installationUuid":{"type":"string"},"sentryAppId":{"type":"number"},"accessTokenCipher":{"type":"string"},"refreshTokenCipher":{"type":"string"},"expiresAt":{"type":"number"},"telemetryToken":{"type":"string"}},"required":["type","organizationSlug","installationUuid","accessTokenCipher","refreshTokenCipher","expiresAt"]},{"type":"object","properties":{"type":{"type":"string","enum":["mcp"]},"url":{"type":"string"},"transport":{"type":"string","enum":["http","sse"]},"authMethod":{"type":"string","enum":["bearer","oauth"]},"authHeaderCipher":{"type":"string"},"oauth":{"type":"object","properties":{"clientInfo":{"type":"object","properties":{"clientId":{"type":"string"},"clientSecretCipher":{"type":"string"},"clientIdIssuedAt":{"type":"number"},"clientSecretExpiresAt":{"type":"number"},"redirectUri":{"type":"string"},"tokenEndpointAuthMethod":{"type":"string"}},"required":["clientId","redirectUri"]},"tokens":{"type":"object","properties":{"accessTokenCipher":{"type":"string"},"refreshTokenCipher":{"type":"string"},"tokenType":{"type":"string"},"expiresAt":{"type":"number"},"scope":{"type":"string"}},"required":["accessTokenCipher"]},"discovery":{"type":"object","properties":{"authorizationServerUrl":{"type":"string"},"resourceMetadataUrl":{"type":"string"},"authorizationServerMetadata":{"anyOf":[{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string","format":"uri"},"token_endpoint":{"type":"string","format":"uri"},"registration_endpoint":{"type":"string","format":"uri"},"scopes_supported":{"type":"array","items":{"type":"string"}},"response_types_supported":{"type":"array","items":{"type":"string"}},"response_modes_supported":{"type":"array","items":{"type":"string"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"service_documentation":{"type":"string","format":"uri"},"revocation_endpoint":{"type":"string","format":"uri"},"revocation_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"revocation_endpoint_auth_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"introspection_endpoint":{"type":"string"},"introspection_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"introspection_endpoint_auth_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}},"client_id_metadata_document_supported":{"type":"boolean"}},"required":["issuer","authorization_endpoint","token_endpoint","response_types_supported"],"additionalProperties":{"nullable":true}},{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string","format":"uri"},"token_endpoint":{"type":"string","format":"uri"},"userinfo_endpoint":{"type":"string","format":"uri"},"jwks_uri":{"type":"string","format":"uri"},"registration_endpoint":{"type":"string","format":"uri"},"scopes_supported":{"type":"array","items":{"type":"string"}},"response_types_supported":{"type":"array","items":{"type":"string"}},"response_modes_supported":{"type":"array","items":{"type":"string"}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"acr_values_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"id_token_encryption_alg_values_supported":{"type":"array","items":{"type":"string"}},"id_token_encryption_enc_values_supported":{"type":"array","items":{"type":"string"}},"userinfo_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"userinfo_encryption_alg_values_supported":{"type":"array","items":{"type":"string"}},"userinfo_encryption_enc_values_supported":{"type":"array","items":{"type":"string"}},"request_object_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"request_object_encryption_alg_values_supported":{"type":"array","items":{"type":"string"}},"request_object_encryption_enc_values_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"display_values_supported":{"type":"array","items":{"type":"string"}},"claim_types_supported":{"type":"array","items":{"type":"string"}},"claims_supported":{"type":"array","items":{"type":"string"}},"service_documentation":{"type":"string"},"claims_locales_supported":{"type":"array","items":{"type":"string"}},"ui_locales_supported":{"type":"array","items":{"type":"string"}},"claims_parameter_supported":{"type":"boolean"},"request_parameter_supported":{"type":"boolean"},"request_uri_parameter_supported":{"type":"boolean"},"require_request_uri_registration":{"type":"boolean"},"op_policy_uri":{"type":"string","format":"uri"},"op_tos_uri":{"type":"string","format":"uri"},"client_id_metadata_document_supported":{"type":"boolean"},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"}}},"required":["issuer","authorization_endpoint","token_endpoint","jwks_uri","response_types_supported","subject_types_supported","id_token_signing_alg_values_supported"]}]},"resourceMetadata":{"type":"object","properties":{"resource":{"type":"string","format":"uri"},"authorization_servers":{"type":"array","items":{"type":"string","format":"uri"}},"jwks_uri":{"type":"string","format":"uri"},"scopes_supported":{"type":"array","items":{"type":"string"}},"bearer_methods_supported":{"type":"array","items":{"type":"string"}},"resource_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"resource_name":{"type":"string"},"resource_documentation":{"type":"string"},"resource_policy_uri":{"type":"string","format":"uri"},"resource_tos_uri":{"type":"string","format":"uri"},"tls_client_certificate_bound_access_tokens":{"type":"boolean"},"authorization_details_types_supported":{"type":"array","items":{"type":"string"}},"dpop_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"dpop_bound_access_tokens_required":{"type":"boolean"}},"required":["resource"],"additionalProperties":{"nullable":true}}},"required":["authorizationServerUrl"]},"scope":{"type":"string"}}},"extraHeaders":{"type":"object","additionalProperties":{"type":"string"}},"serverInfo":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"protocolVersion":{"type":"string"}}},"toolsSnapshot":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{"nullable":true}}},"required":["name"]}},"toolsSnapshotRefreshedAt":{"type":"number"},"enabledTools":{"type":"array","items":{"type":"string"}}},"required":["type","url","transport"]},{"type":"object","properties":{"type":{"type":"string","enum":["devin"]},"devinOrgId":{"type":"string"},"apiKey":{"type":"string"}},"required":["type","devinOrgId","apiKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["cursor"]},"cursorUserId":{"type":"string"},"apiKey":{"type":"string"}},"required":["type","cursorUserId","apiKey"]},{"type":"object","properties":{"type":{"type":"string","enum":["factory"]},"apiKey":{"type":"string"}},"required":["type","apiKey"]},{"nullable":true}],"description":"Metadata related to the integration"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Visibility level"},"guests":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Guest email addresses"},"labels":{"type":"array","items":{"type":"string"},"description":"Integration labels"},"initialised":{"type":"string","nullable":true,"format":"date-time"},"disabled":{"type":"string","nullable":true,"format":"date-time"},"lastFailureAt":{"type":"string","nullable":true,"format":"date-time"},"anomalyChecksDisabled":{"type":"string","nullable":true,"format":"date-time","description":"When anomaly checks were disabled for this integration, or null if enabled"},"anomalyCheckIntervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this integration, in minutes. Null means the default interval."},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["integration"]}},"required":["id","workspaceId","name","installationId","externalId","type","metadata","createdBy","ownerId","lastEditedBy","visibility","guests","labels","initialised","disabled","lastFailureAt","anomalyChecksDisabled","anomalyCheckIntervalMinutes","created","updated","_object"],"additionalProperties":false},"Grouped Infrastructure Statistics":{"allOf":[{"type":"object","additionalProperties":{"nullable":true}},{"type":"object","properties":{"count":{"type":"number"}},"required":["count"],"additionalProperties":false}]},"Infrastructure Node":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"data":{"type":"object","additionalProperties":{"nullable":true}},"alternateNames":{"type":"array","items":{"type":"string"},"description":"Alternate names discovered from observability providers (service names, dataset names, etc.)"},"createdBy":{"type":"string"},"lastEditedBy":{"type":"string"},"updated":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"category":{"type":"string","enum":["compute","storage","database","networking","messaging","security","observability","code","identity","other"],"description":"Broad functional category derived from the resource type"},"tier":{"type":"number","nullable":true,"description":"Monitoring tier (1-4), or null when not yet classified"},"tierSource":{"type":"string","nullable":true,"enum":["agent","manual",null],"description":"Whether the tier was assigned automatically or set manually"},"tierUpdatedAt":{"type":"string","nullable":true,"description":"When the tier was last updated"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["infra_node"]}},"required":["workspaceId","data","alternateNames","createdBy","lastEditedBy","updated","created","id","provider","account","region","type","category","_object"],"additionalProperties":false},"Infrastructure Node Composite ID":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"}},"required":["id","provider","account","region","type"],"additionalProperties":false},"ResourceWiki":{"type":"object","nullable":true,"properties":{"markdown":{"type":"string"},"updatedAt":{"type":"number"},"inputFingerprint":{"type":"string","nullable":true}},"required":["markdown","updatedAt"],"additionalProperties":false},"ResourceAdvisory":{"type":"object","properties":{"id":{"type":"string"},"category":{"type":"string","enum":["observability","resilience","security","data-protection","lifecycle"]},"severity":{"type":"string","enum":["warning","info"]},"title":{"type":"string"},"message":{"type":"string"},"remediation":{"type":"string"},"fixability":{"type":"string","enum":["in-place","guidance"]},"dismissedAtMs":{"type":"number","nullable":true,"description":"When this advisory was ignored for this resource, or null if active"},"dismissedBy":{"type":"string","nullable":true}},"required":["id","category","severity","title","message","remediation","fixability","dismissedAtMs","dismissedBy"]},"Infrastructure Edge":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"source":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"target":{"$ref":"#/components/schemas/Infrastructure Node Composite ID"},"properties":{"type":"object","additionalProperties":{"nullable":true}},"relationship":{"type":"string","enum":["connects_to","publishes_to","contains","is_tailed","uses","defines","encrypts","serves","invokes","triggers","assumes","accesses","manages","runs_on","controls","deploys_to","owns"]},"discoveredVia":{"type":"string","enum":["infrastructure_sweep","environment_variables","traces","agent","manual","repository"]},"createdBy":{"type":"string"},"lastEditedBy":{"type":"string"},"updated":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["infra_edge"]}},"required":["workspaceId","source","target","properties","relationship","discoveredVia","createdBy","lastEditedBy","updated","created","_object"],"additionalProperties":false},"Get Node Edges Parameters":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","description":"The ID of the node in the cloud account"},"provider":{"type":"string","description":"Cloud provider name. Must be a value listed in the `cloudProvider` enum (see <enums> in the system prompt).","x-shared-enum":"cloudProvider"},"account":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud account the node is part of"},"region":{"type":"string","pattern":"^[a-zA-Z0-9]+(?:[_\\-:.#][a-zA-Z0-9]+)*$","description":"The cloud region the node is part of"},"type":{"type":"string","description":"Identifies the kind of cloud resource. Must be a value listed in the `nodeType` enum (see the <enums> section in the system prompt or the `enums` field of a searchToolCatalog response).","x-shared-enum":"nodeType"},"orderBy":{"type":"string","enum":["source","target","relationship","discovered_via","created_by","last_edited_by","created","updated"],"description":"Column to order edges by"},"orderDirection":{"type":"string","enum":["ASC","DESC"],"description":"Sort direction"}},"required":["workspaceId","id","provider","account","region","type"],"additionalProperties":false},"Calculation":{"type":"object","properties":{"alias":{"type":"string"},"calculation":{"type":"string"},"aggregates":{"type":"array","items":{"$ref":"#/components/schemas/Aggregate"}},"series":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Aggregate"}}},"required":["time","data"],"additionalProperties":false}}},"required":["calculation","aggregates","series"],"additionalProperties":false},"Aggregate":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"required":["key","value"],"additionalProperties":false}},"groupKey":{"type":"string"},"value":{"type":"number"},"count":{"type":"number"}},"required":["groups","groupKey","value","count"],"additionalProperties":false},"NodeLogTemplates":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"fingerprint":{"type":"string"},"template":{"type":"string"},"severity":{"type":"string","enum":["ERROR","WARN","INFO","DEBUG","UNKNOWN"]},"sample":{"type":"string"},"firstSeenMs":{"type":"number"},"lastSeenMs":{"type":"number"},"totalCount":{"type":"number"},"ewmaRatePerHour":{"type":"number"},"observedRuns":{"type":"number"}},"required":["fingerprint","template","severity","sample","firstSeenMs","lastSeenMs","totalCount","ewmaRatePerHour","observedRuns"]}}},"required":["templates"]},"AdvisoryDismissal":{"type":"object","properties":{"nodeCompositeId":{"type":"string"},"advisoryId":{"type":"string"},"dismissedAt":{"type":"number","nullable":true,"description":"When the advisory was ignored, or null after a restore"},"dismissedBy":{"type":"string","nullable":true}},"required":["nodeCompositeId","advisoryId","dismissedAt","dismissedBy"]},"Catalog Chunk":{"type":"object","properties":{"id":{"type":"string","pattern":"^chk_[0-9a-z]{32}$","description":"ID of the chunk","example":"chk_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"nodeId":{"type":"string"},"text":{"type":"string"},"type":{"type":"string","enum":["chunk"]},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["chunk"]}},"required":["id","workspaceId","nodeId","text","type","created","updated","_object"],"additionalProperties":false},"AdminWorkspaceAdvisories":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["resource","repository"]},"category":{"type":"string","enum":["observability","resilience","security","data-protection","lifecycle"]},"severity":{"type":"string","enum":["warning","info"]},"fixability":{"type":"string","enum":["in-place","guidance"]},"title":{"type":"string"},"message":{"type":"string"},"count":{"type":"number"},"resources":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]}},"required":["provider","account","region","type","id","name","title","severity"]}},"repositories":{"type":"array","items":{"type":"object","properties":{"repositoryId":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["repositoryId","owner","name","provider","url"]}}},"required":["id","kind","category","severity","fixability","title","message","count","resources"]}},"coverage":{"type":"object","properties":{"totalNodes":{"type":"number"},"monitorableNodes":{"type":"number"},"monitoredNodes":{"type":"number"},"minimalNodes":{"type":"number"},"observabilityGapNodes":{"type":"number"}},"required":["totalNodes","monitorableNodes","monitoredNodes","minimalNodes","observabilityGapNodes"]},"dismissed":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"title":{"type":"string"},"category":{"type":"string","enum":["observability","resilience","security","data-protection","lifecycle"]},"severity":{"type":"string","enum":["warning","info"]},"resource":{"type":"object","properties":{"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]}},"required":["provider","account","region","type","id","name","title","severity"]},"dismissedAtMs":{"type":"number"},"dismissedBy":{"type":"string"}},"required":["ruleId","title","category","severity","resource","dismissedAtMs","dismissedBy"]}},"repositoryDismissed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ruleId":{"type":"string"},"title":{"type":"string"},"severity":{"type":"string","enum":["warning","info"]},"filePath":{"type":"string","nullable":true},"repository":{"type":"object","properties":{"repositoryId":{"type":"string"},"owner":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"url":{"type":"string","nullable":true}},"required":["repositoryId","owner","name","provider","url"]},"dismissedAtMs":{"type":"number"},"dismissedBy":{"type":"string","nullable":true}},"required":["id","ruleId","title","severity","filePath","repository","dismissedAtMs","dismissedBy"]}}},"required":["groups","coverage","dismissed","repositoryDismissed"]},"Cloud Account Repository":{"type":"object","properties":{"id":{"type":"string","pattern":"^car_[0-9a-z]{24}$","description":"ID of the cloud_account_repo","example":"car_7xk9m2p4qw8n5j3v6h1t0y9r"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"cloudAccountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"repositoryId":{"type":"string","pattern":"^repo_[0-9a-z]{24}$","description":"ID of the repository","example":"repo_38mg3o4ibc92h8t2efn8csrh"},"reasoning":{"type":"string","description":"Why this repository is connected to this cloud account"},"confidence":{"type":"string","enum":["definitive","strong","moderate","weak","speculative"],"description":"Confidence level of the connection"},"source":{"type":"string","enum":["auto","manual"],"description":"How this connection was created"},"sourceWorkflowId":{"type":"string","nullable":true},"sourceWorkflowName":{"type":"string","nullable":true},"confirmed":{"type":"string","nullable":true,"format":"date-time"},"confirmedBy":{"type":"string","nullable":true},"repositoryOwner":{"type":"string"},"repositoryName":{"type":"string"},"repositoryProvider":{"type":"string"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["cloud_account_repo"]}},"required":["id","workspaceId","cloudAccountId","repositoryId","reasoning","confidence","source","sourceWorkflowId","sourceWorkflowName","confirmed","confirmedBy","repositoryOwner","repositoryName","repositoryProvider","createdBy","lastEditedBy","created","updated","_object"],"additionalProperties":false},"Change Record":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"title":{"type":"string"},"tldr":{"type":"string","nullable":true},"impactLevel":{"type":"string","nullable":true,"enum":["none","low","moderate","high",null]},"category":{"type":"string","nullable":true,"enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed",null]},"syncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"previousSyncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"nodesAdded":{"type":"number"},"nodesRemoved":{"type":"number"},"nodesModified":{"type":"number"},"edgesAdded":{"type":"number"},"edgesRemoved":{"type":"number"},"edgesModified":{"type":"number"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"ownerId":{"type":"string"},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"createdBy":{"type":"string"},"lastEditedBy":{"type":"string"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["change_record"]},"summary":{"type":"string"},"changes":{"type":"object","properties":{"nodes":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id"]}},"removed":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id"]}},"modified":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["key","before","after"]}}},"required":["type","id"]}}},"required":["added","removed","modified"]},"edges":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}},"modified":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}},"removed":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}}},"required":["added","modified","removed"]}},"required":["nodes","edges"],"additionalProperties":false},"analysis":{"type":"object","nullable":true,"properties":{"tldr":{"type":"string"},"impactLevel":{"type":"string","enum":["none","low","moderate","high"]},"category":{"type":"string","enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed"]},"risks":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"detail":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"resourceIds":{"type":"array","items":{"type":"string"}}},"required":["title","detail","severity","resourceIds"]}},"signals":{"type":"array","items":{"type":"object","properties":{"resourceId":{"type":"string"},"metricLabel":{"type":"string"},"worseDirection":{"type":"string","enum":["up","down"]},"note":{"type":"string"},"baseline":{"type":"number"},"unit":{"type":"string","nullable":true}},"required":["resourceId","metricLabel","worseDirection","note","baseline","unit"]},"default":[]}},"required":["tldr","impactLevel","category","risks"]},"triggerEvents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["aws","vercel","render","cloudflare","fly","kubernetes"]},"kind":{"type":"string"},"occurredAtMs":{"type":"number","nullable":true},"actor":{"type":"string","nullable":true},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"raw":{"type":"object","additionalProperties":{"nullable":true}}},"required":["id","provider","kind","occurredAtMs","actor","title","summary","raw"]},"default":[]}},"required":["workspaceId","id","accountId","title","tldr","impactLevel","category","syncTimestamp","previousSyncTimestamp","nodesAdded","nodesRemoved","nodesModified","edgesAdded","edgesRemoved","edgesModified","visibility","ownerId","guests","createdBy","lastEditedBy","created","updated","_object","summary","changes","analysis"],"additionalProperties":false},"Public Extended Change Record":{"allOf":[{"$ref":"#/components/schemas/Public Change Record"},{"type":"object","properties":{"summary":{"type":"string"},"changes":{"type":"object","properties":{"nodes":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id"]}},"removed":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id"]}},"modified":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"before":{"type":"string"},"after":{"type":"string"}},"required":["key","before","after"]}}},"required":["type","id"]}}},"required":["added","removed","modified"]},"edges":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}},"modified":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}},"removed":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"relationship":{"type":"string"}},"required":["source","target","relationship"]}}},"required":["added","modified","removed"]}},"required":["nodes","edges"],"additionalProperties":false},"analysis":{"type":"object","nullable":true,"properties":{"tldr":{"type":"string"},"impactLevel":{"type":"string","enum":["none","low","moderate","high"]},"category":{"type":"string","enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed"]},"risks":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"detail":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"resourceIds":{"type":"array","items":{"type":"string"}}},"required":["title","detail","severity","resourceIds"]}},"signals":{"type":"array","items":{"type":"object","properties":{"resourceId":{"type":"string"},"metricLabel":{"type":"string"},"worseDirection":{"type":"string","enum":["up","down"]},"note":{"type":"string"},"baseline":{"type":"number"},"unit":{"type":"string","nullable":true}},"required":["resourceId","metricLabel","worseDirection","note","baseline","unit"]},"default":[]}},"required":["tldr","impactLevel","category","risks"]}},"required":["summary","changes","analysis"],"additionalProperties":false}]},"Public Change Record":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","pattern":"^change_[0-9a-z]{32}$","description":"ID of the change_record","example":"change_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"accountId":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"title":{"type":"string"},"tldr":{"type":"string","nullable":true},"impactLevel":{"type":"string","nullable":true,"enum":["none","low","moderate","high",null]},"category":{"type":"string","nullable":true,"enum":["deployment","configuration","scaling","security","networking","data","teardown","discovery","mixed",null]},"syncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"previousSyncTimestamp":{"type":"string","nullable":true,"format":"date-time"},"nodesAdded":{"type":"number"},"nodesRemoved":{"type":"number"},"nodesModified":{"type":"number"},"edgesAdded":{"type":"number"},"edgesRemoved":{"type":"number"},"edgesModified":{"type":"number"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"createdBy":{"type":"string"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["change_record"]}},"required":["workspaceId","id","accountId","title","tldr","impactLevel","category","syncTimestamp","previousSyncTimestamp","nodesAdded","nodesRemoved","nodesModified","edgesAdded","edgesRemoved","edgesModified","visibility","createdBy","_object"],"additionalProperties":false},"Cloud Account":{"type":"object","properties":{"id":{"type":"string","pattern":"^acc_[0-9a-z]{24}$","description":"ID of the cloud_account","example":"acc_34gky74ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"alias":{"type":"string","minLength":4,"maxLength":256,"description":"Alias of the cloud account"},"provider":{"$ref":"#/components/schemas/Cloud Provider"},"status":{"type":"string","enum":["ready","syncing","new"],"description":"Sync status"},"account":{"type":"string","description":"Cloud account"},"region":{"type":"string","description":"Cloud region"},"metadata":{"oneOf":[{"type":"object","properties":{"provider":{"type":"string","enum":["cloudflare"]},"token":{"type":"string"},"readOnly":{"type":"boolean"},"createMonitoringAlarms":{"type":"string","nullable":true},"webhookDestinationId":{"type":"string"},"webhookSecret":{"type":"string"},"notificationPolicyId":{"type":"string"},"alertIds":{"type":"array","items":{"type":"string"}}},"required":["provider"]},{"type":"object","properties":{"provider":{"type":"string","enum":["aws"]},"roleArn":{"type":"string"},"externalParameter":{"type":"string"},"stackName":{"type":"string"},"serviceToken":{"type":"string"},"bucketName":{"type":"string"},"topicArn":{"type":"string"},"cloudTrailName":{"type":"string"},"createMonitoringAlarms":{"type":"string","nullable":true},"subscribeToAlarms":{"type":"string","nullable":true}},"required":["provider","roleArn","externalParameter","stackName","serviceToken","bucketName","topicArn","cloudTrailName","createMonitoringAlarms","subscribeToAlarms"]},{"type":"object","properties":{"provider":{"type":"string","enum":["vercel"]},"configurationId":{"type":"string"},"accessToken":{"type":"string"},"authType":{"type":"string","enum":["access_token"]},"type":{"type":"string","enum":["personal","team"]},"teamId":{"type":"string"},"userId":{"type":"string"},"apiKey":{"type":"string"},"apiKeyConfiguredAt":{"type":"string","nullable":true},"logDrain":{"type":"object","additionalProperties":{"nullable":true}},"telemetry":{"type":"array","items":{"type":"string","enum":["logs","traces","analytics","speed_insights"]}},"previewEnvironmentsEnabled":{"type":"string","nullable":true},"id":{"type":"string"},"setup":{"type":"object","properties":{"teamId":{"type":"string"},"userId":{"type":"string"},"configurationId":{"type":"string"},"next":{"type":"string"},"team":{"type":"object","additionalProperties":{"nullable":true}},"user":{"type":"object","additionalProperties":{"nullable":true}}},"required":["userId","configurationId","next"]}},"required":["provider","configurationId","accessToken","authType","type","userId","setup"]},{"type":"object","properties":{"provider":{"type":"string","enum":["fly"]},"token":{"type":"string"},"orgSlug":{"type":"string"}},"required":["provider","orgSlug"]},{"type":"object","properties":{"provider":{"type":"string","enum":["render"]},"apiKey":{"type":"string"},"ownerId":{"type":"string"},"ownerType":{"type":"string","enum":["user","team"]},"webhookId":{"type":"string"},"webhookSecret":{"type":"string"}},"required":["provider","ownerId","ownerType"]},{"type":"object","properties":{"provider":{"type":"string","enum":["planetscale"]},"apiKey":{"type":"string"},"organization":{"type":"string"},"authType":{"type":"string","enum":["service_token","oauth"]},"refreshToken":{"type":"string"},"accessTokenExpiresAt":{"type":"number"}},"required":["provider","organization"]},{"type":"object","properties":{"provider":{"type":"string","enum":["kubernetes"]},"connectionMode":{"type":"string","enum":["direct","agent"]},"apiServerUrl":{"type":"string"},"token":{"type":"string"},"caCert":{"type":"string"},"clusterName":{"type":"string"},"namespace":{"type":"string"},"distribution":{"type":"string"},"clusterUid":{"type":"string"},"agentNamespace":{"type":"string"},"tunnelId":{"type":"string"},"tunnelHostname":{"type":"string"},"dnsRecordId":{"type":"string"},"shimSecret":{"type":"string"},"agentVersion":{"type":"string"},"kubernetesVersion":{"type":"string"},"chartVersion":{"type":"string"},"lastRegisteredAt":{"type":"string"},"agentConnectionStatus":{"type":"string","enum":["connected","disconnected","waiting"]},"agentLastSeenAt":{"type":"string"},"cfAccountId":{"type":"string"}},"required":["provider"]}],"description":"Metadata related to the cloud provider"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Visibility level"},"guests":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Guest email addresses"},"labels":{"type":"array","items":{"type":"string"},"description":"Cloud account labels"},"initialised":{"type":"string","nullable":true,"format":"date-time"},"lastSync":{"type":"string","nullable":true,"format":"date-time"},"lastFailureAt":{"type":"string","nullable":true,"format":"date-time"},"resyncRequestedAt":{"type":"string","nullable":true,"format":"date-time","description":"When a resync was requested while a sync was in progress, or null if none is pending"},"anomalyChecksDisabled":{"type":"string","nullable":true,"format":"date-time","description":"When anomaly checks were disabled for this account, or null if enabled"},"readOnly":{"type":"string","nullable":true,"format":"date-time","description":"When this account was set to read-only, or null if writes are allowed. While set, all write calls against the provider API are refused."},"anomalyCheckIntervalMinutes":{"type":"number","nullable":true,"description":"How often anomaly checks run for this account, in minutes. Null means the default interval. Cloud resources in this account inherit this interval unless overridden."},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["cloud_account"]}},"required":["id","workspaceId","alias","provider","status","account","region","metadata","createdBy","ownerId","lastEditedBy","visibility","guests","labels","initialised","lastSync","lastFailureAt","resyncRequestedAt","anomalyChecksDisabled","readOnly","anomalyCheckIntervalMinutes","created","updated","_object"],"additionalProperties":false},"Cloud Provider":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"],"description":"Cloud provider"},"TemplateInstallStatsItem":{"type":"object","properties":{"templateSlug":{"type":"string","description":"Template slug"},"totalInstalls":{"type":"integer","minimum":0,"description":"All-time install count"},"recentInstalls":{"type":"integer","minimum":0,"description":"Installs in the last 7 days"},"trending":{"type":"boolean","description":"Whether the template is currently trending"}},"required":["templateSlug","totalInstalls","recentInstalls","trending"]},"SkillInstallStatsItem":{"type":"object","properties":{"templateSlug":{"type":"string","description":"Template slug"},"totalInstalls":{"type":"integer","minimum":0,"description":"All-time install count"},"recentInstalls":{"type":"integer","minimum":0,"description":"Installs in the last 7 days"},"trending":{"type":"boolean","description":"Whether the template is currently trending"}},"required":["templateSlug","totalInstalls","recentInstalls","trending"]},"Feedback":{"type":"object","properties":{"id":{"type":"string","pattern":"^fdbk_[0-9a-z]{32}$","description":"ID of the feedback","example":"fdbk_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"userId":{"type":"string","nullable":true,"pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$"},"text":{"type":"string"},"title":{"type":"string"},"context":{"type":"string","nullable":true},"environment":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"screenshotFileId":{"type":"string","nullable":true,"pattern":"^file_[0-9a-z]{24}$"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"archived":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["feedback"]}},"required":["id","workspaceId","userId","text","title","context","environment","screenshotFileId","created","updated","archived","_object"],"additionalProperties":false},"FailedToolCall":{"type":"object","properties":{"id":{"type":"string","pattern":"^ftc_[0-9a-z]{32}$","description":"ID of the failed_tool_call","example":"ftc_x7k9m2n5p8q3v6w4j1s7h9d2f5g8t1r3"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"userId":{"type":"string","nullable":true,"pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$"},"name":{"type":"string","description":"Name of the tool that failed"},"agent":{"type":"string","description":"Agent name that made the call"},"input":{"type":"object","additionalProperties":{"nullable":true},"description":"Tool input parameters"},"error":{"type":"object","additionalProperties":{"nullable":true},"description":"Error object with message, stack, code"},"workflowId":{"type":"string","nullable":true,"description":"Workflow ID if called from workflow"},"threadId":{"type":"string","nullable":true,"pattern":"^thrd_[0-9a-z]{24}$","description":"Thread ID if called from thread"},"context":{"$ref":"#/components/schemas/FailedToolCallContext"},"title":{"type":"string","description":"Auto-generated summary of failure"},"text":{"type":"string","description":"Detailed error description"},"environment":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"System environment at time of failure"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"archived":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["failed_tool_call"]}},"required":["id","workspaceId","userId","name","agent","input","error","workflowId","threadId","context","title","text","environment","created","updated","archived","_object"],"additionalProperties":false},"FailedToolCallContext":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["thread"]},"threadId":{"type":"string"},"requestId":{"type":"string"}},"required":["type","threadId"]},{"type":"object","properties":{"type":{"type":"string","enum":["workflow"]},"workflowId":{"type":"string"},"requestId":{"type":"string"}},"required":["type","workflowId"]},{"type":"object","properties":{"type":{"type":"string","enum":["api"]},"requestId":{"type":"string"}},"required":["type","requestId"]},{"type":"object","properties":{"type":{"type":"string","enum":["background"]},"jobId":{"type":"string"}},"required":["type"]},{"nullable":true}],"description":"Type-safe context with discriminated union"},"Rating":{"type":"object","properties":{"id":{"type":"string","pattern":"^rating_[0-9a-z]{32}$","description":"ID of the rating","example":"rating_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","nullable":true,"pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"version":{"type":"string","nullable":true},"wikiId":{"type":"string","nullable":true},"accountId":{"type":"string","nullable":true},"resourceId":{"type":"string"},"resource":{"type":"string","enum":["message","wiki_outline","wiki_doc","change_record","incident"]},"userId":{"type":"string"},"type":{"type":"string","enum":["implicit","explicit"]},"logId":{"type":"string","nullable":true},"score":{"type":"number"},"status":{"type":"string","enum":["new","resolved","closed","wontfix"]},"metadata":{"type":"object","nullable":true,"properties":{"reason":{"type":"string","nullable":true},"details":{"type":"string","nullable":true}},"additionalProperties":false},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["rating"]}},"required":["id","workspaceId","threadId","version","wikiId","accountId","resourceId","resource","userId","type","logId","score","status","metadata","created","updated","_object"],"additionalProperties":false},"Dataset":{"type":"object","properties":{"id":{"type":"string","pattern":"^dtst_[0-9a-z]{32}$","description":"ID of the dataset","example":"dtst_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"slug":{"type":"string","minLength":4,"maxLength":1024,"pattern":"^[a-z0-9_]+(?:-[a-z0-9_]+)*$","description":"Slug of the dataset"},"description":{"type":"string","nullable":true,"minLength":4,"maxLength":2000,"description":"Description of the dataset"},"providerMetadata":{"type":"object","nullable":true,"properties":{"vercel":{"type":"object","properties":{"disablePreview":{"type":"string","nullable":true,"format":"date-time"}},"required":["disablePreview"]},"aws":{"type":"object","properties":{"disableLambdaStartEndLogs":{"type":"string","nullable":true,"format":"date-time"}},"required":["disableLambdaStartEndLogs"]}}},"keys":{"type":"object","properties":{"scrub":{"type":"string","nullable":true,"format":"date-time"},"obfuscate":{"type":"array","items":{"type":"string"}},"exclude":{"type":"array","items":{"type":"string"}}},"required":["scrub","obfuscate","exclude"]},"services":{"type":"object","properties":{"exclude":{"type":"array","items":{"type":"string"}}},"required":["exclude"]},"sampling":{"type":"object","properties":{"enabled":{"type":"string","nullable":true,"format":"date-time"},"rate":{"type":"number","minimum":0,"maximum":1}},"required":["enabled","rate"]},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"blocked":{"type":"string","nullable":true,"format":"date-time"},"disabled":{"type":"string","nullable":true,"format":"date-time"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["dataset"]}},"required":["id","workspaceId","ownerId","slug","description","providerMetadata","keys","services","sampling","createdBy","lastEditedBy","blocked","disabled","created","updated","_object"],"additionalProperties":false},"Skill":{"type":"object","properties":{"id":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"slug":{"type":"string","description":"URL-safe identifier used as /slug shortcut in chat"},"name":{"type":"string","description":"Human-readable name of the skill"},"description":{"type":"string","description":"Brief description of what the skill does"},"instructions":{"type":"string","description":"Step-by-step instructions the agent follows when executing the skill"},"source":{"type":"string","enum":["template","manual","generated"],"description":"How the skill was created: template (seeded), manual (user-created), or generated (system-created)"},"templateSlug":{"type":"string","nullable":true,"description":"Links back to the catalog template this skill was created from"},"parametersSchema":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"JSON Schema defining parameters the user fills in before the skill runs"},"requiredIntegrations":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Integrations that must be connected for the skill to be available"},"requiredProviders":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Cloud providers that must be connected for the skill to be available"},"labels":{"type":"array","items":{"type":"string"},"description":"Label IDs attached to this skill"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Who can see this skill"},"guests":{"type":"array","items":{"type":"string"},"description":"Email addresses of guest users who can access this skill"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"User who owns this skill"},"disabled":{"type":"string","nullable":true,"format":"date-time","description":"When the skill was disabled, or null if enabled"},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the skill was created"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"When the skill was last updated"},"_html_url":{"type":"string","description":"URL to view this skill in the console"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["skill"],"description":"Resource type identifier"}},"required":["id","slug","name","description","instructions","source","templateSlug","parametersSchema","requiredIntegrations","requiredProviders","labels","visibility","guests","ownerId","disabled","created","updated","_object"],"additionalProperties":false},"SkillDocument":{"type":"object","properties":{"id":{"type":"string","pattern":"^skld_[0-9a-z]{24}$","description":"ID of the skilldoc","example":"skld_38mg3o4ibc92h8t2efn8csrh"},"skillId":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"name":{"type":"string","description":"Human-readable name of the document"},"description":{"type":"string","nullable":true,"description":"What this document contains or when to read it"},"filename":{"type":"string","description":"Original filename"},"mimeType":{"type":"string","description":"MIME type of the document content"},"size":{"type":"number","nullable":true,"description":"Content size in bytes"},"createdBy":{"type":"string","nullable":true,"description":"User who uploaded this document"},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the document was created"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"When the document was last updated"},"_html_url":{"type":"string","description":"URL to view the parent skill in the console"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["skilldoc"],"description":"Resource type identifier"}},"required":["id","skillId","name","description","filename","mimeType","size","createdBy","created","updated","_object"],"additionalProperties":false},"SkillAuthoringWarning":{"type":"object","properties":{"rule":{"type":"string","enum":["description","completion","negation","responsibility","size"],"description":"Which authoring-rubric rule the skill falls short of"},"message":{"type":"string","description":"One-sentence advisory explaining what to change"}},"required":["rule","message"]},"CreateSkill":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable name of the skill"},"slug":{"type":"string","maxLength":64,"pattern":"^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$","description":"URL-safe identifier used as /slug shortcut in chat"},"description":{"type":"string","minLength":1,"maxLength":512,"description":"Brief description of what the skill does"},"instructions":{"type":"string","minLength":10,"maxLength":10000,"description":"Step-by-step instructions the agent follows"},"parametersSchema":{"type":"object","additionalProperties":{"nullable":true},"description":"JSON Schema for skill parameters"},"requiredIntegrations":{"type":"array","items":{"type":"string"},"description":"Required integration types"},"requiredProviders":{"type":"array","items":{"type":"string"},"description":"Required cloud provider types"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Label IDs to attach"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Who can see this skill"},"guests":{"type":"array","items":{"type":"string"},"description":"Guest email addresses"}},"required":["workspaceId","name","slug","description","instructions"],"additionalProperties":false},"EditSkill":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable name"},"description":{"type":"string","minLength":1,"maxLength":512,"description":"Brief description"},"instructions":{"type":"string","minLength":10,"maxLength":10000,"description":"Step-by-step instructions"},"parametersSchema":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"JSON Schema for parameters"},"requiredIntegrations":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Required integration types"},"requiredProviders":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Required cloud provider types"},"labels":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Label IDs to attach"},"disabled":{"type":"boolean","description":"Whether the skill is disabled"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Who can see this skill"},"guests":{"type":"array","items":{"type":"string"},"description":"Guest email addresses"}},"additionalProperties":false},"SkillCatalogItem":{"type":"object","properties":{"slug":{"type":"string","description":"Skill slug identifier"},"name":{"type":"string","description":"Human-readable skill name"},"description":{"type":"string","description":"Brief description"},"instructions":{"type":"string","description":"Step-by-step instructions the agent follows"},"parametersSchema":{"type":"object","additionalProperties":{"nullable":true},"description":"JSON Schema for skill parameters"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/SkillCatalogDocument"},"description":"Supporting documents included with the skill"},"requiredIntegrations":{"type":"array","items":{"type":"string"},"description":"Required integration types"},"requiredProviders":{"type":"array","items":{"type":"string"},"description":"Required cloud provider types"}},"required":["slug","name","description","instructions"]},"SkillCatalogDocument":{"type":"object","properties":{"filename":{"type":"string","description":"Document filename"},"name":{"type":"string","description":"Human-readable document name"},"description":{"type":"string","description":"What this document contains"}},"required":["filename","name"]},"CreateSkillFromTemplate":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"templateSlug":{"type":"string","minLength":1,"description":"Slug of the catalog template to install"}},"required":["workspaceId","templateSlug"],"additionalProperties":false},"CreateSkillDocument":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable name"},"description":{"type":"string","maxLength":512,"description":"What this document contains"},"filename":{"type":"string","minLength":1,"maxLength":256,"description":"Filename for the document"}},"required":["name","filename"],"additionalProperties":false},"PublicSkill":{"type":"object","properties":{"id":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"slug":{"type":"string","description":"URL-safe identifier used as /slug shortcut in chat"},"name":{"type":"string","description":"Human-readable name of the skill"},"description":{"type":"string","description":"Brief description of what the skill does"},"instructions":{"type":"string","description":"Step-by-step instructions the agent follows when executing the skill"},"source":{"type":"string","enum":["template","manual","generated"],"description":"How the skill was created"},"parametersSchema":{"type":"object","nullable":true,"additionalProperties":{"nullable":true},"description":"JSON Schema defining parameters"},"requiredIntegrations":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Required integrations"},"requiredProviders":{"type":"array","nullable":true,"items":{"type":"string"},"description":"Required cloud providers"},"labels":{"type":"array","items":{"type":"string"},"description":"Label IDs attached to this skill"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Who can see this skill"},"createdBy":{"type":"string","description":"User who created this skill"},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the skill was created"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"When the skill was last updated"},"_html_url":{"type":"string","description":"URL to view this skill in the console"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["skill"],"description":"Resource type identifier"}},"required":["id","workspaceId","slug","name","description","instructions","source","parametersSchema","requiredIntegrations","requiredProviders","labels","visibility","createdBy","created","updated","_object"],"additionalProperties":false},"PublicSkillDocument":{"type":"object","properties":{"id":{"type":"string","pattern":"^skld_[0-9a-z]{24}$","description":"ID of the skilldoc","example":"skld_38mg3o4ibc92h8t2efn8csrh"},"skillId":{"type":"string","pattern":"^skl_[0-9a-z]{24}$","description":"ID of the skill","example":"skl_38mg3o4ibc92h8t2efn8csrh"},"name":{"type":"string","description":"Human-readable name of the document"},"description":{"type":"string","nullable":true,"description":"What this document contains or when to read it"},"filename":{"type":"string","description":"Original filename"},"mimeType":{"type":"string","description":"MIME type of the document content"},"size":{"type":"number","nullable":true,"description":"Content size in bytes"},"created":{"type":"string","nullable":true,"format":"date-time","description":"When the document was created"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"When the document was last updated"},"_html_url":{"type":"string","description":"URL to view the parent skill in the console"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["skilldoc"],"description":"Resource type identifier"}},"required":["id","skillId","name","description","filename","mimeType","size","created","updated","_object"],"additionalProperties":false},"Page":{"type":"object","properties":{"id":{"type":"string","pattern":"^page_[0-9a-z]{40}$","description":"ID of the page","example":"page_38mg3o4ibc92h8t2efn8csrhd18564pxsvozx979"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"kind":{"type":"string","enum":["pr_analysis","autofix_run"]},"title":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string","nullable":true},"url":{"type":"string"},"deleted":{"type":"string","nullable":true,"format":"date-time"},"deletedBy":{"type":"string","nullable":true},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["page"]}},"required":["id","workspaceId","kind","title","source","sourceUrl","url","deleted","deletedBy","created","updated","_object"],"additionalProperties":false},"Memory":{"type":"object","properties":{"id":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"title":{"type":"string","description":"Title of the memory"},"contentStatus":{"type":"string","enum":["pending","processing","completed","failed","unavailable"],"description":"Status of content processing"},"sourceType":{"type":"string","nullable":true,"enum":["investigation","change_analysis","observation","automation",null],"description":"How this learning was discovered"},"sourceId":{"type":"string","nullable":true,"description":"ID of the source (e.g. changeRecordId)"},"sourceThreadId":{"type":"string","nullable":true,"description":"Thread ID where the learning originated"},"labels":{"type":"array","items":{"type":"string"}},"archived":{"type":"number","nullable":true,"description":"Timestamp of when the memory was archived, if any"},"score":{"type":"number"},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["memory"]}},"required":["id","workspaceId","title","contentStatus","sourceType","sourceId","sourceThreadId","labels","archived","createdBy","ownerId","lastEditedBy","created","updated","_object"],"additionalProperties":false},"Chunk":{"type":"object","properties":{"id":{"type":"string","pattern":"^chk_[0-9a-z]{32}$","description":"ID of the chunk","example":"chk_s9stv2sfvyc9ef2396nadqz6mi25pyiv"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"memoryId":{"type":"string","pattern":"^mem_[0-9a-z]{32}$","description":"ID of the memory","example":"mem_a5o4rt7ugpddmkbe46aokdh21vavzs3b"},"text":{"type":"string"},"type":{"type":"string","enum":["chunk","title"]},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["chunk"]}},"required":["id","workspaceId","memoryId","text","type","created","updated","_object"],"additionalProperties":false},"GlobalNote":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"content":{"type":"string","description":"The global note content"},"ownerId":{"type":"string"},"createdBy":{"type":"string"},"lastEditedBy":{"type":"string"},"created":{"type":"number"},"updated":{"type":"number"},"deleted":{"type":"number","nullable":true},"_object":{"type":"string","enum":["global_note"]}},"required":["workspaceId","content","ownerId","createdBy","lastEditedBy","created","updated","deleted","_object"]},"DailyNote":{"type":"object","properties":{"id":{"type":"string","pattern":"^dnote_[0-9a-z]{24}$","description":"ID of the daily_note","example":"dnote_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date the note pertains to (YYYY-MM-DD)"},"content":{"type":"string","description":"The note content"},"threadCount":{"type":"number","description":"Number of threads that contributed to this note"},"ownerId":{"type":"string","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"Owner ('system' for auto-generated)"},"createdBy":{"type":"string","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"Creator ('system' for auto-generated)"},"lastEditedBy":{"type":"string","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6","description":"Last editor ('system' or user)"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["daily_note"]}},"required":["id","workspaceId","date","content","threadCount","ownerId","createdBy","lastEditedBy","created","updated","_object"]},"Thread":{"type":"object","properties":{"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"parentThreadId":{"type":"string","nullable":true,"pattern":"^thrd_[0-9a-z]{24}$","description":"Parent thread ID if this is a sub-agent thread"},"agentName":{"type":"string","nullable":true,"description":"Fun agent name for this thread"},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the thread"},"summary":{"type":"string","nullable":true,"description":"Summary of the thread"},"context":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["repository","cloud_account","integration","thread","infrastructure_node","wiki_document","memory","anomaly","issue","change_record","pull_request"]}},"required":["id","type"]}},"hypothesis":{"type":"object","nullable":true,"properties":{"investigationThreadId":{"type":"string"},"hypothesisId":{"type":"string"},"prompt":{"type":"string","nullable":true},"hypothesis":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]},"alternativeHypotheses":{"type":"array","nullable":true,"items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]}}},"required":["investigationThreadId","hypothesisId","hypothesis"],"description":"Hypothesis metadata if this thread is a sub-agent testing one hypothesis inside an investigation (type: 'hypothesis')"},"automation":{"type":"object","nullable":true,"properties":{"automationId":{"type":"string"},"automationExecutionId":{"type":"string"},"actionPlanId":{"type":"string"},"instructions":{"type":"string"},"passIndex":{"type":"integer"},"passPrompt":{"type":"string"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"mode":{"type":"string","enum":["always","smart"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]}},"requireChecks":{"type":"boolean"}},"required":["type","mode","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"mode":{"type":"string","enum":["always","smart"]},"defaultLabels":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"mode":{"type":"string","enum":["always","smart"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false}]}},"sandboxId":{"type":"string"},"triggerEvent":{"type":"object","properties":{"type":{"type":"string"},"data":{"type":"object","additionalProperties":{"nullable":true}}},"required":["type","data"],"additionalProperties":false}},"additionalProperties":false,"description":"Automation metadata if this thread was created by an automation execution"},"investigation":{"type":"object","nullable":true,"properties":{"issueId":{"type":"string"},"prompt":{"type":"string"},"hypothesisIds":{"type":"array","items":{"type":"string"}},"status":{"type":"object","nullable":true,"properties":{"kind":{"type":"string","enum":["needs_human_action","needs_decision","awaiting_change","failed"]},"headline":{"type":"string"},"detail":{"type":"string"},"at":{"type":"number"}},"required":["kind","headline","detail","at"],"description":"Out-of-loop investigation status: when set the investigation is parked (waiting on a human, decision, external change, or it failed) and re-investigation nudges are suppressed."},"diagnosis":{"type":"object","nullable":true,"properties":{"outcome":{"type":"string","enum":["diagnosed","resolved","inconclusive","false_positive","failed"]},"confidence":{"type":"string","enum":["low","medium","high"]},"at":{"type":"number"}},"required":["outcome","confidence","at"],"description":"The agent's technical verdict for the investigated issue, set after each turn is classified."}},"required":["issueId","prompt","hypothesisIds"],"description":"Investigation metadata if this thread is the coordinating investigation of an issue (type: 'investigation')"},"metadata":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"integrationId":{"type":"string"},"teamId":{"type":"string"},"channelId":{"type":"string"},"channelType":{"type":"string","enum":["channel","group","mpim","im"]},"threadTs":{"type":"string"},"rootMessageTs":{"type":"string"}},"required":["type","integrationId","teamId","channelId","channelType","threadTs"],"additionalProperties":false},{"nullable":true}],"description":"Source-specific metadata (Slack, future adapters). Discriminated by `type`."},"externalId":{"type":"string","nullable":true,"description":"External lookup key for threads created from external sources (e.g. Slack)."},"createdBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"ownerId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"lastEditedBy":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"origin":{"type":"string","enum":["web","web:recommendation","email","api","cli","mcp","extension:chrome","extension:firefox","extension:edge","extension:safari","oauth","admin","sub-agent","system","slack","unknown"]},"originVersion":{"type":"string","nullable":true,"description":"Version of the client that created the thread (e.g. CLI or extension version), when supplied via the x-polylane-client-version header."},"mode":{"type":"string","enum":["text","voice"],"description":"Input method inferred from the first user message in the thread."},"type":{"type":"string","enum":["chat","hypothesis","automation","autofix","investigation","pr_review"]},"guests":{"type":"array","nullable":true,"items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"runningSince":{"type":"string","nullable":true,"format":"date-time","description":"When the currently running turn started, or null when the thread is idle."},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["thread"]}},"required":["id","workspaceId","parentThreadId","agentName","name","summary","context","hypothesis","automation","investigation","metadata","externalId","createdBy","ownerId","lastEditedBy","visibility","origin","originVersion","mode","type","guests","labels","created","updated","runningSince","_object"],"additionalProperties":false},"ThreadSkill":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"},"instructions":{"type":"string"}},"required":["skillId","skillSlug","instructions"]},"ThreadParticipant":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"userId":{"type":"string","pattern":"^(system|usr_[0-9a-z]{32}|team_[0-9a-z]{24})$","example":"usr_8y34bjuxip8jcz73r1ohaf346kbvuvg6"},"role":{"type":"string","enum":["owner","editor","commenter","viewer"]},"addedBy":{"type":"string"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["thread_participant"]}},"required":["workspaceId","threadId","userId","role","addedBy","created","updated","_object"],"additionalProperties":false},"Public Thread":{"type":"object","properties":{"id":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"agentName":{"type":"string","nullable":true},"name":{"type":"string","minLength":4,"maxLength":256,"description":"Name of the thread"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"]},"type":{"type":"string","enum":["chat","hypothesis","automation","autofix","investigation","pr_review"]},"hypothesis":{"type":"object","nullable":true,"properties":{"investigationThreadId":{"type":"string"},"hypothesisId":{"type":"string"},"prompt":{"type":"string","nullable":true},"hypothesis":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]},"alternativeHypotheses":{"type":"array","nullable":true,"items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]}}},"required":["investigationThreadId","hypothesisId","hypothesis"],"description":"Hypothesis metadata if this thread is a sub-agent testing one hypothesis inside an investigation"},"automation":{"type":"object","nullable":true,"properties":{"automationId":{"type":"string"},"automationExecutionId":{"type":"string"},"actionPlanId":{"type":"string"},"instructions":{"type":"string"},"passIndex":{"type":"integer"},"passPrompt":{"type":"string"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"mode":{"type":"string","enum":["always","smart"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]}},"requireChecks":{"type":"boolean"}},"required":["type","mode","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"mode":{"type":"string","enum":["always","smart"]},"defaultLabels":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"mode":{"type":"string","enum":["always","smart"]},"accountIds":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"mode":{"type":"string","enum":["always","smart"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"mode":{"type":"string","enum":["always","smart"]},"baseBranch":{"type":"string"}},"required":["type","mode"],"additionalProperties":false}]}},"sandboxId":{"type":"string"},"triggerEvent":{"type":"object","properties":{"type":{"type":"string"},"data":{"type":"object","additionalProperties":{"nullable":true}}},"required":["type","data"],"additionalProperties":false}},"additionalProperties":false,"description":"Automation metadata if this thread was created by an automation execution"},"investigation":{"type":"object","nullable":true,"properties":{"issueId":{"type":"string"},"prompt":{"type":"string"},"hypothesisIds":{"type":"array","items":{"type":"string"}},"status":{"type":"object","nullable":true,"properties":{"kind":{"type":"string","enum":["needs_human_action","needs_decision","awaiting_change","failed"]},"headline":{"type":"string"},"detail":{"type":"string"},"at":{"type":"number"}},"required":["kind","headline","detail","at"],"description":"Out-of-loop investigation status: when set the investigation is parked (waiting on a human, decision, external change, or it failed) and re-investigation nudges are suppressed."},"diagnosis":{"type":"object","nullable":true,"properties":{"outcome":{"type":"string","enum":["diagnosed","resolved","inconclusive","false_positive","failed"]},"confidence":{"type":"string","enum":["low","medium","high"]},"at":{"type":"number"}},"required":["outcome","confidence","at"],"description":"The agent's technical verdict for the investigated issue, set after each turn is classified."}},"required":["issueId","prompt","hypothesisIds"],"description":"Investigation metadata if this thread is the coordinating investigation of an issue"},"viewerIsOwner":{"type":"boolean","description":"Whether the caller created this thread, computed server-side so the creator identity itself is never exposed"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["thread"]}},"required":["id","workspaceId","agentName","name","visibility","type","hypothesis","automation","investigation","viewerIsOwner","_object"],"additionalProperties":false},"Message":{"type":"object","properties":{"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"role":{"type":"string","enum":["user","assistant","system"]},"metadata":{"type":"object","nullable":true,"properties":{"sources":{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string","enum":["url"]},"id":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"providerMetadata":{"type":"object","properties":{"nominal":{"type":"object","properties":{"description":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"filename":{"type":"string","nullable":true},"created":{"type":"number","nullable":true},"chunks":{"type":"array","nullable":true,"items":{"type":"object","properties":{"id":{"type":"string","nullable":true},"markdown":{"type":"string","nullable":true}},"additionalProperties":false}},"tags":{"type":"array","nullable":true,"items":{"type":"string"}},"type":{"type":"string","enum":["web"]}},"required":["type"],"additionalProperties":false}}}},"required":["sourceType","id","url"]}},"durationMs":{"type":"number"},"upgrade":{"type":"boolean"}},"additionalProperties":false},"parts":{"type":"array","nullable":true,"items":{"nullable":true}},"createdAt":{"type":"string","nullable":true,"format":"date-time"},"userId":{"type":"string","description":"ID of the user who sent this message"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["message"]}},"required":["id","workspaceId","threadId","role","metadata","parts","createdAt","_object"],"additionalProperties":false},"Public Message":{"type":"object","properties":{"id":{"type":"string","pattern":"^msg_[0-9a-z]{32}$","description":"ID of the message","example":"msg_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"role":{"type":"string","enum":["user","assistant","system"]},"metadata":{"type":"object","nullable":true,"properties":{"sources":{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string","enum":["url"]},"id":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"providerMetadata":{"type":"object","properties":{"nominal":{"type":"object","properties":{"description":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"filename":{"type":"string","nullable":true},"created":{"type":"number","nullable":true},"chunks":{"type":"array","nullable":true,"items":{"type":"object","properties":{"id":{"type":"string","nullable":true},"markdown":{"type":"string","nullable":true}},"additionalProperties":false}},"tags":{"type":"array","nullable":true,"items":{"type":"string"}},"type":{"type":"string","enum":["web"]}},"required":["type"],"additionalProperties":false}}}},"required":["sourceType","id","url"]}},"durationMs":{"type":"number"},"upgrade":{"type":"boolean"}},"additionalProperties":false},"parts":{"type":"array","nullable":true,"items":{"nullable":true}},"createdAt":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["message"]}},"required":["id","workspaceId","threadId","role","metadata","parts","createdAt","_object"],"additionalProperties":false},"ArtifactListItem":{"type":"object","properties":{"id":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["report","diagram","chat.autofix","hypothesis","github.pull_request","github.pr_comment","github.issue","github.release","github.branch","github.commit","aws.cloudwatch_alarm","aws.cloudwatch_dashboard","honeycomb.marker","axiom.annotation","datadog.dashboard","datadog.monitor","datadog.slo","datadog.downtime","honeycomb.board","honeycomb.trigger","honeycomb.slo","honeycomb.query_annotation","axiom.dashboard","axiom.monitor","axiom.view","axiom.virtual_field","betterstack.monitor","sentry.alert_rule","sentry.metric_alert","sentry.dashboard","action_request","issue.timeline"]},"title":{"type":"string","minLength":1,"maxLength":200,"description":"Title of the artifact"},"summary":{"type":"string","minLength":1,"maxLength":500,"description":"Summary of the artifact"},"status":{"type":"string","enum":["draft","final"]},"currentVersion":{"type":"integer","minimum":0},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"createdBy":{"type":"string"},"messageId":{"type":"string"},"metadata":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["report"]},"repositories":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]}},"cloudResources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"}},"required":["id","provider","account","region","type"]}},"investigationThreadId":{"type":"string"}},"required":["type","repositories","cloudResources"]},{"type":"object","properties":{"type":{"type":"string","enum":["diagram"]},"format":{"type":"string"}},"required":["type","format"]},{"type":"object","properties":{"type":{"type":"string","enum":["chat.autofix"]},"autofixId":{"type":"string"},"childThreadId":{"type":"string","nullable":true},"parentThreadId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"integrationId":{"type":"string"},"branch":{"type":"string"},"baseBranch":{"type":"string"},"sandboxId":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["started","branch_pushed","pr_opened","failed","skipped"]},"commitSha":{"type":"string"},"prNumber":{"type":"number"},"prUrl":{"type":"string"},"filesChangedCount":{"type":"number"},"failureReason":{"type":"string"},"skippedReason":{"type":"string"},"hypothesisId":{"type":"string"},"runId":{"type":"string"},"investigationThreadId":{"type":"string"}},"required":["type","autofixId","childThreadId","parentThreadId","repository","integrationId","branch","baseBranch","title","status"]},{"type":"object","properties":{"type":{"type":"string","enum":["hypothesis"]},"hypothesisId":{"type":"string"},"runId":{"type":"string"},"investigationThreadId":{"type":"string"},"hypothesisName":{"type":"string"},"hypothesisDescription":{"type":"string"},"alternativeHypotheses":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]}},"status":{"type":"string","enum":["queued","active","completed","failed"]},"verdict":{"type":"string","nullable":true,"enum":["confirmed","refuted","inconclusive",null]},"confidence":{"type":"string","nullable":true,"enum":["definitive","strong","moderate","weak","speculative",null]},"votedSummary":{"type":"string","nullable":true},"parallelPasses":{"type":"integer"},"passThreadIds":{"type":"array","items":{"type":"string"}},"failureReason":{"type":"string"}},"required":["type","hypothesisId","runId","investigationThreadId","hypothesisName","hypothesisDescription","alternativeHypotheses","status","verdict","confidence","votedSummary","parallelPasses","passThreadIds"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"number":{"type":"number"},"url":{"type":"string"},"state":{"type":"string","enum":["open","closed","merged","draft"]},"head":{"type":"string"},"base":{"type":"string"},"author":{"type":"string","nullable":true},"isUpdate":{"type":"boolean"}},"required":["type","integrationId","repository","number","url","state","head","base","author","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.pr_comment"]},"kind":{"type":"string","enum":["review","reply"]},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"pullNumber":{"type":"number"},"headSha":{"type":"string"},"verdict":{"type":"string","enum":["pass","fail"]},"impactLevel":{"type":"string","enum":["low","moderate","high"]},"affectedResourceIds":{"type":"array","items":{"type":"string"}},"charts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"caption":{"type":"string"},"points":{"type":"array","items":{"type":"number"}}},"required":["title","points"]}},"logs":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"source":{"type":"string"},"lines":{"type":"array","items":{"type":"string"}},"emphasize":{"type":"array","items":{"type":"number"}},"totalLines":{"type":"number"}},"required":["title","lines"]}},"integrationId":{"type":"string"},"commentId":{"type":"number"},"url":{"type":"string"}},"required":["type","repository","pullNumber","headSha","affectedResourceIds"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"number":{"type":"number"},"url":{"type":"string"},"state":{"type":"string","enum":["open","closed"]},"labels":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}},"author":{"type":"string","nullable":true},"isUpdate":{"type":"boolean"}},"required":["type","integrationId","repository","number","url","state","labels","assignees","author","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"releaseId":{"type":"number"},"tagName":{"type":"string"},"url":{"type":"string"},"draft":{"type":"boolean"},"prerelease":{"type":"boolean"}},"required":["type","integrationId","repository","releaseId","tagName","url","draft","prerelease"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.branch"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"branchName":{"type":"string"},"sha":{"type":"string"},"url":{"type":"string"},"fromRef":{"type":"string","nullable":true}},"required":["type","integrationId","repository","branchName","sha","url","fromRef"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.commit"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"sha":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"message":{"type":"string"},"branch":{"type":"string"}},"required":["type","integrationId","repository","sha","url","path","message","branch"]},{"type":"object","properties":{"type":{"type":"string","enum":["aws.cloudwatch_alarm"]},"account":{"type":"string"},"region":{"type":"string"},"alarmName":{"type":"string"},"url":{"type":"string"},"metricName":{"type":"string"},"namespace":{"type":"string"},"threshold":{"type":"number"},"comparisonOperator":{"type":"string"},"isUpdate":{"type":"boolean"}},"required":["type","account","region","alarmName","url","metricName","namespace","threshold","comparisonOperator","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["aws.cloudwatch_dashboard"]},"account":{"type":"string"},"region":{"type":"string"},"dashboardName":{"type":"string"},"url":{"type":"string"},"isUpdate":{"type":"boolean"}},"required":["type","account","region","dashboardName","url","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.marker"]},"integrationId":{"type":"string"},"dataset":{"type":"string"},"markerId":{"type":"string"},"markerType":{"type":"string"},"message":{"type":"string"},"externalUrl":{"type":"string","nullable":true}},"required":["type","integrationId","dataset","markerId","markerType","message","externalUrl"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.annotation"]},"integrationId":{"type":"string"},"annotationId":{"type":"string"},"annotationType":{"type":"string"},"title":{"type":"string"},"datasets":{"type":"array","items":{"type":"string"}},"externalUrl":{"type":"string","nullable":true}},"required":["type","integrationId","annotationId","annotationType","title","datasets","externalUrl"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"title":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","dashboardId","title","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"number"},"monitorName":{"type":"string"},"monitorType":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.slo"]},"integrationId":{"type":"string"},"sloId":{"type":"string"},"sloName":{"type":"string"},"sloType":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","sloId","sloName","sloType","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.downtime"]},"integrationId":{"type":"string"},"downtimeId":{"type":"string"},"scope":{"type":"string"},"site":{"type":"string"}},"required":["type","integrationId","downtimeId","scope","site"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.board"]},"integrationId":{"type":"string"},"boardId":{"type":"string"},"boardName":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","boardId","boardName","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.trigger"]},"integrationId":{"type":"string"},"triggerId":{"type":"string"},"triggerName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","triggerId","triggerName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.slo"]},"integrationId":{"type":"string"},"sloId":{"type":"string"},"sloName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","sloId","sloName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.query_annotation"]},"integrationId":{"type":"string"},"annotationId":{"type":"string"},"queryId":{"type":"string"},"name":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","annotationId","queryId","name","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"dashboardName":{"type":"string"}},"required":["type","integrationId","dashboardId","dashboardName"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"string"},"monitorName":{"type":"string"},"monitorType":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.view"]},"integrationId":{"type":"string"},"viewId":{"type":"string"},"viewName":{"type":"string"}},"required":["type","integrationId","viewId","viewName"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.virtual_field"]},"integrationId":{"type":"string"},"virtualFieldId":{"type":"string"},"fieldName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","virtualFieldId","fieldName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["betterstack.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"string"},"monitorName":{"type":"string"},"monitorType":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.alert_rule"]},"integrationId":{"type":"string"},"ruleId":{"type":"string"},"ruleName":{"type":"string"},"projectSlug":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","ruleId","ruleName","projectSlug","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.metric_alert"]},"integrationId":{"type":"string"},"alertId":{"type":"string"},"alertName":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","alertId","alertName","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"dashboardName":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","dashboardId","dashboardName","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["issue.timeline"]},"issueId":{"type":"string"},"investigationThreadId":{"type":"string"}},"required":["type","issueId","investigationThreadId"]},{"type":"object","properties":{"type":{"type":"string","enum":["action_request"]},"actionType":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"]},"automationId":{"type":"string"},"automationExecutionId":{"type":"string"},"passIndex":{"type":"integer","minimum":0},"attempt":{"type":"integer","minimum":0},"externalRef":{"type":"object","properties":{"provider":{"type":"string","enum":["github","vercel","render","fly","cloudflare","nominal","devin","cursor","factory"]},"kind":{"type":"string","enum":["pr","review","comment","deployment","issue","incident","session"]},"url":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"number"}]}},"required":["provider","kind","url","id"]},"resolvedTarget":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"integrationId":{"type":"string"}},"required":["owner","repo","integrationId"]},"input":{"anyOf":[{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"type":"string"},"sha":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"draft":{"type":"boolean"}},"required":["branch","sha","title","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"body":{"type":"string"}},"required":["pullNumber","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"issueNumber":{"type":"number"},"body":{"type":"string"}},"required":["issueNumber","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"method":{"type":"string","enum":["merge","squash","rebase"]},"commitTitle":{"type":"string"}},"required":["pullNumber","method"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}}},"required":["title","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_version"]},"versionId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_deployment"]},"deploymentId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_commit"]},"commitId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous_image","pin_to_image"]},"imageRef":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"metricSource":{"type":"string"},"integrationId":{"type":"string"},"metricQuery":{"type":"object","additionalProperties":{"nullable":true}},"metricUnit":{"type":"string"},"target":{"type":"object","properties":{"operator":{"type":"string"},"value":{"type":"number"},"unit":{"type":"string"},"degradedAt":{"type":"number"}},"required":["operator","value"]},"scopeRepositories":{"type":"array","items":{"type":"string"}},"scopeResources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"]}},"labels":{"type":"array","items":{"type":"string"}}},"required":["name","description","metricSource","metricQuery","target"]},{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"summary":{"type":"string"},"body":{"type":"string"},"timeframe":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}},"required":["from","to"]},"labels":{"type":"array","items":{"type":"string"}}},"required":["title","severity","summary","body"]},{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"prompt":{"type":"string"}},"required":["title","severity","prompt"]}]}},"required":["type","actionType","automationId","automationExecutionId","passIndex","input"]},{"nullable":true}]},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["artifact"]}},"required":["id","workspaceId","threadId","type","title","summary","status","currentVersion","created","updated","createdBy","messageId","metadata","_object"],"additionalProperties":false},"Artifact":{"type":"object","properties":{"id":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"threadId":{"type":"string","pattern":"^thrd_[0-9a-z]{24}$","description":"ID of the thread","example":"thrd_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["report","diagram","chat.autofix","hypothesis","github.pull_request","github.pr_comment","github.issue","github.release","github.branch","github.commit","aws.cloudwatch_alarm","aws.cloudwatch_dashboard","honeycomb.marker","axiom.annotation","datadog.dashboard","datadog.monitor","datadog.slo","datadog.downtime","honeycomb.board","honeycomb.trigger","honeycomb.slo","honeycomb.query_annotation","axiom.dashboard","axiom.monitor","axiom.view","axiom.virtual_field","betterstack.monitor","sentry.alert_rule","sentry.metric_alert","sentry.dashboard","action_request","issue.timeline"]},"title":{"type":"string","minLength":1,"maxLength":200,"description":"Title of the artifact"},"summary":{"type":"string","minLength":1,"maxLength":500,"description":"Summary of the artifact"},"status":{"type":"string","enum":["draft","final"]},"currentVersion":{"type":"integer","minimum":0},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"createdBy":{"type":"string"},"messageId":{"type":"string"},"metadata":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["report"]},"repositories":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]}},"cloudResources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"}},"required":["id","provider","account","region","type"]}},"investigationThreadId":{"type":"string"}},"required":["type","repositories","cloudResources"]},{"type":"object","properties":{"type":{"type":"string","enum":["diagram"]},"format":{"type":"string"}},"required":["type","format"]},{"type":"object","properties":{"type":{"type":"string","enum":["chat.autofix"]},"autofixId":{"type":"string"},"childThreadId":{"type":"string","nullable":true},"parentThreadId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"integrationId":{"type":"string"},"branch":{"type":"string"},"baseBranch":{"type":"string"},"sandboxId":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["started","branch_pushed","pr_opened","failed","skipped"]},"commitSha":{"type":"string"},"prNumber":{"type":"number"},"prUrl":{"type":"string"},"filesChangedCount":{"type":"number"},"failureReason":{"type":"string"},"skippedReason":{"type":"string"},"hypothesisId":{"type":"string"},"runId":{"type":"string"},"investigationThreadId":{"type":"string"}},"required":["type","autofixId","childThreadId","parentThreadId","repository","integrationId","branch","baseBranch","title","status"]},{"type":"object","properties":{"type":{"type":"string","enum":["hypothesis"]},"hypothesisId":{"type":"string"},"runId":{"type":"string"},"investigationThreadId":{"type":"string"},"hypothesisName":{"type":"string"},"hypothesisDescription":{"type":"string"},"alternativeHypotheses":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"}},"required":["name","description"]}},"status":{"type":"string","enum":["queued","active","completed","failed"]},"verdict":{"type":"string","nullable":true,"enum":["confirmed","refuted","inconclusive",null]},"confidence":{"type":"string","nullable":true,"enum":["definitive","strong","moderate","weak","speculative",null]},"votedSummary":{"type":"string","nullable":true},"parallelPasses":{"type":"integer"},"passThreadIds":{"type":"array","items":{"type":"string"}},"failureReason":{"type":"string"}},"required":["type","hypothesisId","runId","investigationThreadId","hypothesisName","hypothesisDescription","alternativeHypotheses","status","verdict","confidence","votedSummary","parallelPasses","passThreadIds"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"number":{"type":"number"},"url":{"type":"string"},"state":{"type":"string","enum":["open","closed","merged","draft"]},"head":{"type":"string"},"base":{"type":"string"},"author":{"type":"string","nullable":true},"isUpdate":{"type":"boolean"}},"required":["type","integrationId","repository","number","url","state","head","base","author","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.pr_comment"]},"kind":{"type":"string","enum":["review","reply"]},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"pullNumber":{"type":"number"},"headSha":{"type":"string"},"verdict":{"type":"string","enum":["pass","fail"]},"impactLevel":{"type":"string","enum":["low","moderate","high"]},"affectedResourceIds":{"type":"array","items":{"type":"string"}},"charts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"caption":{"type":"string"},"points":{"type":"array","items":{"type":"number"}}},"required":["title","points"]}},"logs":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"source":{"type":"string"},"lines":{"type":"array","items":{"type":"string"}},"emphasize":{"type":"array","items":{"type":"number"}},"totalLines":{"type":"number"}},"required":["title","lines"]}},"integrationId":{"type":"string"},"commentId":{"type":"number"},"url":{"type":"string"}},"required":["type","repository","pullNumber","headSha","affectedResourceIds"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"number":{"type":"number"},"url":{"type":"string"},"state":{"type":"string","enum":["open","closed"]},"labels":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}},"author":{"type":"string","nullable":true},"isUpdate":{"type":"boolean"}},"required":["type","integrationId","repository","number","url","state","labels","assignees","author","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"releaseId":{"type":"number"},"tagName":{"type":"string"},"url":{"type":"string"},"draft":{"type":"boolean"},"prerelease":{"type":"boolean"}},"required":["type","integrationId","repository","releaseId","tagName","url","draft","prerelease"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.branch"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"branchName":{"type":"string"},"sha":{"type":"string"},"url":{"type":"string"},"fromRef":{"type":"string","nullable":true}},"required":["type","integrationId","repository","branchName","sha","url","fromRef"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.commit"]},"integrationId":{"type":"string"},"repository":{"type":"object","properties":{"provider":{"type":"string"},"owner":{"type":"string"},"repo":{"type":"string"}},"required":["provider","owner","repo"]},"sha":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"message":{"type":"string"},"branch":{"type":"string"}},"required":["type","integrationId","repository","sha","url","path","message","branch"]},{"type":"object","properties":{"type":{"type":"string","enum":["aws.cloudwatch_alarm"]},"account":{"type":"string"},"region":{"type":"string"},"alarmName":{"type":"string"},"url":{"type":"string"},"metricName":{"type":"string"},"namespace":{"type":"string"},"threshold":{"type":"number"},"comparisonOperator":{"type":"string"},"isUpdate":{"type":"boolean"}},"required":["type","account","region","alarmName","url","metricName","namespace","threshold","comparisonOperator","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["aws.cloudwatch_dashboard"]},"account":{"type":"string"},"region":{"type":"string"},"dashboardName":{"type":"string"},"url":{"type":"string"},"isUpdate":{"type":"boolean"}},"required":["type","account","region","dashboardName","url","isUpdate"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.marker"]},"integrationId":{"type":"string"},"dataset":{"type":"string"},"markerId":{"type":"string"},"markerType":{"type":"string"},"message":{"type":"string"},"externalUrl":{"type":"string","nullable":true}},"required":["type","integrationId","dataset","markerId","markerType","message","externalUrl"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.annotation"]},"integrationId":{"type":"string"},"annotationId":{"type":"string"},"annotationType":{"type":"string"},"title":{"type":"string"},"datasets":{"type":"array","items":{"type":"string"}},"externalUrl":{"type":"string","nullable":true}},"required":["type","integrationId","annotationId","annotationType","title","datasets","externalUrl"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"title":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","dashboardId","title","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"number"},"monitorName":{"type":"string"},"monitorType":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.slo"]},"integrationId":{"type":"string"},"sloId":{"type":"string"},"sloName":{"type":"string"},"sloType":{"type":"string"},"site":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","sloId","sloName","sloType","site","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["datadog.downtime"]},"integrationId":{"type":"string"},"downtimeId":{"type":"string"},"scope":{"type":"string"},"site":{"type":"string"}},"required":["type","integrationId","downtimeId","scope","site"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.board"]},"integrationId":{"type":"string"},"boardId":{"type":"string"},"boardName":{"type":"string"},"url":{"type":"string"}},"required":["type","integrationId","boardId","boardName","url"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.trigger"]},"integrationId":{"type":"string"},"triggerId":{"type":"string"},"triggerName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","triggerId","triggerName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.slo"]},"integrationId":{"type":"string"},"sloId":{"type":"string"},"sloName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","sloId","sloName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["honeycomb.query_annotation"]},"integrationId":{"type":"string"},"annotationId":{"type":"string"},"queryId":{"type":"string"},"name":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","annotationId","queryId","name","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"dashboardName":{"type":"string"}},"required":["type","integrationId","dashboardId","dashboardName"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"string"},"monitorName":{"type":"string"},"monitorType":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.view"]},"integrationId":{"type":"string"},"viewId":{"type":"string"},"viewName":{"type":"string"}},"required":["type","integrationId","viewId","viewName"]},{"type":"object","properties":{"type":{"type":"string","enum":["axiom.virtual_field"]},"integrationId":{"type":"string"},"virtualFieldId":{"type":"string"},"fieldName":{"type":"string"},"dataset":{"type":"string"}},"required":["type","integrationId","virtualFieldId","fieldName","dataset"]},{"type":"object","properties":{"type":{"type":"string","enum":["betterstack.monitor"]},"integrationId":{"type":"string"},"monitorId":{"type":"string"},"monitorName":{"type":"string"},"monitorType":{"type":"string"}},"required":["type","integrationId","monitorId","monitorName","monitorType"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.alert_rule"]},"integrationId":{"type":"string"},"ruleId":{"type":"string"},"ruleName":{"type":"string"},"projectSlug":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","ruleId","ruleName","projectSlug","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.metric_alert"]},"integrationId":{"type":"string"},"alertId":{"type":"string"},"alertName":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","alertId","alertName","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["sentry.dashboard"]},"integrationId":{"type":"string"},"dashboardId":{"type":"string"},"dashboardName":{"type":"string"},"organizationSlug":{"type":"string"}},"required":["type","integrationId","dashboardId","dashboardName","organizationSlug"]},{"type":"object","properties":{"type":{"type":"string","enum":["issue.timeline"]},"issueId":{"type":"string"},"investigationThreadId":{"type":"string"}},"required":["type","issueId","investigationThreadId"]},{"type":"object","properties":{"type":{"type":"string","enum":["action_request"]},"actionType":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"]},"automationId":{"type":"string"},"automationExecutionId":{"type":"string"},"passIndex":{"type":"integer","minimum":0},"attempt":{"type":"integer","minimum":0},"externalRef":{"type":"object","properties":{"provider":{"type":"string","enum":["github","vercel","render","fly","cloudflare","nominal","devin","cursor","factory"]},"kind":{"type":"string","enum":["pr","review","comment","deployment","issue","incident","session"]},"url":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"number"}]}},"required":["provider","kind","url","id"]},"resolvedTarget":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"integrationId":{"type":"string"}},"required":["owner","repo","integrationId"]},"input":{"anyOf":[{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"type":"string"},"sha":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"draft":{"type":"boolean"}},"required":["branch","sha","title","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"body":{"type":"string"}},"required":["pullNumber","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"issueNumber":{"type":"number"},"body":{"type":"string"}},"required":["issueNumber","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"method":{"type":"string","enum":["merge","squash","rebase"]},"commitTitle":{"type":"string"}},"required":["pullNumber","method"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}}},"required":["title","body"]},{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_version"]},"versionId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_deployment"]},"deploymentId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_commit"]},"commitId":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous_image","pin_to_image"]},"imageRef":{"type":"string"}},"required":["strategy"]},{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"metricSource":{"type":"string"},"integrationId":{"type":"string"},"metricQuery":{"type":"object","additionalProperties":{"nullable":true}},"metricUnit":{"type":"string"},"target":{"type":"object","properties":{"operator":{"type":"string"},"value":{"type":"number"},"unit":{"type":"string"},"degradedAt":{"type":"number"}},"required":["operator","value"]},"scopeRepositories":{"type":"array","items":{"type":"string"}},"scopeResources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"]}},"labels":{"type":"array","items":{"type":"string"}}},"required":["name","description","metricSource","metricQuery","target"]},{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"summary":{"type":"string"},"body":{"type":"string"},"timeframe":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}},"required":["from","to"]},"labels":{"type":"array","items":{"type":"string"}}},"required":["title","severity","summary","body"]},{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"prompt":{"type":"string"}},"required":["title","severity","prompt"]}]}},"required":["type","actionType","automationId","automationExecutionId","passIndex","input"]},{"nullable":true}]},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["artifact"]},"content":{"type":"string","description":"The artifact content"}},"required":["id","workspaceId","threadId","type","title","summary","status","currentVersion","created","updated","createdBy","messageId","metadata","_object","content"],"additionalProperties":false},"ArtifactVersion":{"type":"object","properties":{"artifactId":{"type":"string","pattern":"^art_[0-9a-z]{32}$","description":"ID of the artifact","example":"art_d18564pxsvozx979j3532mii2kk7pmw6"},"version":{"type":"integer","minimum":0},"content":{"type":"string"},"created":{"type":"string","nullable":true,"format":"date-time"},"createdBy":{"type":"string"},"changeNote":{"type":"string","nullable":true},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["artifact_version"]}},"required":["artifactId","version","content","created","createdBy","changeNote","_object"],"additionalProperties":false},"Automation":{"type":"object","properties":{"id":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"name":{"type":"string","description":"Automation name"},"description":{"type":"string","description":"Automation description"},"triggers":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","error","warning","info","ok"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.issue.triaged"]},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["polylane","datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"]}},"severities":{"type":"array","items":{"type":"string","enum":["critical","high","medium","low","info"]}},"statuses":{"type":"array","items":{"type":"string","enum":["confirmed","dismissed"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"]},"checks":{"type":"boolean","description":"When true, the automation posts a check run on the pull request that succeeds or fails with the execution."},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","synchronize","closed","merged"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","completed","failure"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"workflows":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["requested","completed"]}},"conclusions":{"type":"array","items":{"type":"string","enum":["success","failure","cancelled","skipped","timed_out"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["published","created","edited","prereleased","released"]}},"prerelease":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["opened","closed","reopened","labeled"]}},"labels":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"isPullRequest":{"type":"boolean"},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"]},"filters":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string","enum":["created","edited","deleted"]}},"users":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]}},"resourceIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"projectIds":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"branches":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"serviceIds":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"]}},"triggers":{"type":"array","items":{"type":"string","enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"]},"filters":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"string"}},"appIds":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message"]},"filters":{"type":"object","properties":{"integrationIds":{"type":"array","items":{"type":"string"}},"channelIds":{"type":"array","items":{"type":"string"}},"channelTypes":{"type":"array","items":{"type":"string","enum":["channel","group","im","mpim"]}},"userIds":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":20},"mentionsBot":{"type":"boolean"},"excludeBotMessages":{"type":"boolean"},"excludeThreadReplies":{"type":"boolean"}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["cron"]},"expression":{"type":"string","pattern":"^(\\S+\\s+){4}\\S+$"},"timezone":{"type":"string"}},"required":["type","expression"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"token":{"type":"string","minLength":32,"description":"Webhook authentication token"}},"required":["type","token"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.connected"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.cloud_account.synced"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.change_record.created"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.codebase.synced"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.infra_node.created"]},"filters":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"string","enum":["aws","vercel","cloudflare","fly","render","planetscale","kubernetes","code","external","unknown"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.integration.connected"]},"filters":{"type":"object","properties":{"types":{"type":"array","items":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"]}}},"additionalProperties":false}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["polylane.repository.created"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":10,"description":"Trigger configurations (logical OR — any matching trigger fires the automation)"},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert","polylane.issue.triaged","github.push","github.pull_request","github.deployment","github.workflow_run","github.release","github.issues","github.issue_comment","github.review_comment","cloudflare.deployment","vercel.deployment","render.deployment","fly.deployment","slack.message","cron","webhook","polylane.cloud_account.connected","polylane.cloud_account.synced","polylane.change_record.created","polylane.codebase.synced","polylane.infra_node.created","polylane.integration.connected","polylane.repository.created"]},"description":"Denormalised list of trigger types for filtering"},"agentConfig":{"type":"object","nullable":true,"properties":{"instructions":{"type":"string","maxLength":10000},"passes":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10}},"required":["count"],"additionalProperties":false}},"default":{},"additionalProperties":false,"description":"Agent configuration"},"destinations":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["email"]},"name":{"type":"string","minLength":1,"maxLength":100},"emails":{"type":"array","items":{"type":"string","format":"email"},"minItems":1,"maxItems":10},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","emails"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["slack"]},"name":{"type":"string","minLength":1,"maxLength":100},"integrationId":{"type":"string","minLength":1,"maxLength":64},"channelId":{"type":"string","minLength":1,"maxLength":32},"channelName":{"type":"string","maxLength":80},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","channelId"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","format":"uri"},"headers":{"type":"object","additionalProperties":{"type":"string","maxLength":4096}},"mode":{"type":"string","enum":["always","smart"],"default":"smart"}},"required":["type","name","url"],"additionalProperties":false}]},"description":"Notification destinations"},"actions":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["submitPr"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"draft":{"type":"boolean"},"requireLint":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentPr"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["commentGithubIssue"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mergePr"]},"allowedMethods":{"type":"array","items":{"type":"string","enum":["merge","squash","rebase"]},"minItems":1,"maxItems":3},"requireChecks":{"type":"boolean"},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type","allowedMethods"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["createGithubIssue"]},"defaultLabels":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackCloudflareDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"resourceTypes":{"type":"array","items":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment"]},"maxItems":4},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackVercelDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"projectIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"environments":{"type":"array","items":{"type":"string","enum":["production","preview","development"]},"maxItems":3},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackRenderDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"serviceIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["rollbackFlyDeployment"]},"accountIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":20},"appIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"maxItems":50},"regions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"maxItems":20},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["openIssue"]},"defaultSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["autofix"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToDevin"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToCursor"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["handoffToFactory"]},"baseBranch":{"type":"string","minLength":1,"maxLength":128},"mode":{"type":"string","enum":["always","smart"],"default":"always"}},"required":["type"],"additionalProperties":false}]},"description":"Platform-executed actions the agent can request"},"labels":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"object","properties":{"skillId":{"type":"string"},"skillSlug":{"type":"string"}},"required":["skillId","skillSlug"],"additionalProperties":false}},"delayMs":{"type":"number","description":"Delay in milliseconds before execution"},"disabled":{"type":"string","nullable":true,"format":"date-time","description":"Disabled timestamp, null if enabled"},"visibility":{"type":"string","enum":["public","private","unlisted","workspace","workspace_and_guests","workspace_and_github_org","private_and_guests","team","team_and_guests","custom","internal"],"description":"Automation visibility"},"ownerId":{"type":"string","description":"Workspace ID"},"source":{"type":"string","enum":["template","manual","generated","builder"],"description":"How the automation was created"},"templateSlug":{"type":"string","nullable":true,"description":"Template slug if created from template"},"createdBy":{"type":"string","description":"Creator user ID or 'system'"},"lastEditedBy":{"type":"string","description":"Last editor"},"lastExecuted":{"type":"string","nullable":true,"format":"date-time","description":"Last execution timestamp, null if never executed"},"created":{"type":"string","nullable":true,"format":"date-time","description":"Creation timestamp"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"Last update timestamp"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation"]}},"required":["id","workspaceId","name","description","triggers","triggerTypes","destinations","actions","labels","skills","delayMs","disabled","visibility","ownerId","source","templateSlug","createdBy","lastEditedBy","lastExecuted","created","updated","_object"],"additionalProperties":false},"AutomationExecution":{"type":"object","properties":{"id":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the automation_execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"automationId":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"triggerEvent":{"type":"object","additionalProperties":{"nullable":true},"description":"Trigger event snapshot"},"status":{"type":"string","enum":["pending","delayed","running","completed","failed","skipped"],"description":"Execution status"},"summary":{"type":"string","nullable":true,"description":"Execution summary"},"error":{"type":"string","nullable":true,"description":"Error message"},"noteworthy":{"type":"boolean","nullable":true,"description":"Whether this execution result is noteworthy"},"passThreadIds":{"type":"array","items":{"type":"string"},"description":"Thread IDs for each pass"},"passResults":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"summary":{"type":"string"},"noteworthy":{"type":"boolean"},"completedAt":{"type":"number"},"durationMs":{"type":"number"}},"required":["threadId","summary","noteworthy","completedAt","durationMs"],"additionalProperties":false},"description":"Results from each pass"},"triggeredAt":{"type":"string","nullable":true,"format":"date-time","description":"Trigger timestamp"},"scheduledAt":{"type":"string","nullable":true,"format":"date-time","description":"Scheduled execution time"},"startedAt":{"type":"string","nullable":true,"format":"date-time","description":"Execution start time"},"completedAt":{"type":"string","nullable":true,"format":"date-time","description":"Execution completion time"},"durationMs":{"type":"number","nullable":true,"description":"Execution duration in ms"},"created":{"type":"string","nullable":true,"format":"date-time","description":"Created timestamp"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"Updated timestamp"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_execution"]}},"required":["id","workspaceId","automationId","triggerEvent","status","summary","error","noteworthy","passThreadIds","passResults","triggeredAt","scheduledAt","startedAt","completedAt","durationMs","created","updated","_object"],"additionalProperties":false},"TriggerAutomationBody":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"id":{"type":"string","description":"Automation ID"},"event":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["alert.received"],"description":"Triggered when an observability alert is received"},"data":{"type":"object","properties":{"alert":{"type":"object","properties":{"source":{"type":"string","enum":["datadog","honeycomb","axiom","betterstack","sentry","cloudwatch","vercel","render","cloudflare","github"],"description":"Alert provider source (e.g. datadog, cloudwatch, sentry)"},"externalId":{"type":"string","description":"External alert identifier from the provider"},"integrationId":{"type":"string","description":"Cloudscope integration ID that received the alert"},"title":{"type":"string","description":"Alert title"},"message":{"type":"string","description":"Alert message body"},"severity":{"type":"string","enum":["critical","error","warning","info","ok"],"description":"Alert severity level"},"status":{"type":"string","enum":["triggered","recovered","acknowledged","unknown"],"description":"Current alert status"},"timestamp":{"type":"number","description":"Alert timestamp in milliseconds since epoch"},"tags":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value tags from the alert provider"},"raw":{"type":"object","additionalProperties":{"nullable":true},"description":"Raw alert payload from the provider"}},"required":["source","externalId","integrationId","title","message","severity","status","timestamp","tags","raw"],"description":"Alert details from the monitoring provider"}},"required":["alert"],"description":"Alert event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.push"],"description":"Triggered when code is pushed to a GitHub repository"},"data":{"type":"object","properties":{"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner (user or organization)"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the push"},"branch":{"type":"string","description":"Branch that was pushed to"},"commits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Commit SHA"},"message":{"type":"string","description":"Commit message"},"author":{"type":"string","description":"Commit author name"}},"required":["id","message","author"],"description":"A git commit in a push event"},"description":"List of commits in the push"},"pusher":{"type":"string","description":"Name of the user who pushed"},"headCommit":{"type":"object","properties":{"message":{"type":"string","description":"Head commit message"}},"required":["message"],"description":"The head commit of the push, if available"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["repository","owner","repo","sender","branch","commits","pusher","integrationId","payload"],"description":"GitHub push event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.pull_request"],"description":"Triggered by pull request events on GitHub"},"data":{"type":"object","properties":{"action":{"type":"string","description":"PR action (e.g. opened, closed, synchronize, merged)"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"number":{"type":"number","description":"Pull request number"},"title":{"type":"string","description":"Pull request title"},"author":{"type":"string","description":"Pull request author username"},"base":{"type":"string","description":"Base branch name"},"head":{"type":"string","description":"Head branch name"},"url":{"type":"string","description":"Pull request URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","number","title","author","base","head","url","integrationId","payload"],"description":"GitHub pull request event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.deployment_status"],"description":"Triggered when a deployment status changes on GitHub"},"data":{"type":"object","properties":{"action":{"type":"string","description":"Deployment status action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"environment":{"type":"string","description":"Deployment environment (e.g. production, staging)"},"status":{"type":"string","description":"Deployment status (e.g. success, failure, pending)"},"sha":{"type":"string","description":"Git commit SHA being deployed"},"timestamp":{"type":"number","description":"Deployment timestamp in milliseconds"},"url":{"type":"string","description":"Deployment status URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","environment","status","sha","timestamp","url","integrationId","payload"],"description":"GitHub deployment status event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.workflow_run"],"description":"Triggered by GitHub Actions workflow run events"},"data":{"type":"object","properties":{"action":{"type":"string","enum":["requested","in_progress","completed"],"description":"Workflow run action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"workflowId":{"type":"number","description":"Workflow ID"},"workflowName":{"type":"string","description":"Workflow name"},"workflowPath":{"type":"string","description":"Workflow file path (e.g. .github/workflows/ci.yml)"},"runId":{"type":"number","description":"Workflow run ID"},"runNumber":{"type":"number","description":"Workflow run number"},"runAttempt":{"type":"number","description":"Run attempt number"},"headBranch":{"type":"string","description":"Branch that triggered the workflow"},"headSha":{"type":"string","description":"Git commit SHA for the workflow run"},"status":{"type":"string","enum":["queued","in_progress","completed"],"description":"Current workflow run status"},"conclusion":{"type":"string","nullable":true,"enum":["success","failure","cancelled","skipped","timed_out","action_required",null],"description":"Workflow run conclusion, null if still running"},"event":{"type":"string","description":"GitHub event that triggered the workflow (e.g. push, pull_request)"},"actor":{"type":"string","description":"GitHub username of the actor"},"url":{"type":"string","description":"Workflow run URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","workflowId","workflowName","workflowPath","runId","runNumber","runAttempt","headBranch","headSha","status","conclusion","event","actor","url","integrationId","payload"],"description":"GitHub workflow run event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.release"],"description":"Triggered by GitHub release events"},"data":{"type":"object","properties":{"action":{"type":"string","enum":["published","created","edited","deleted","prereleased","released"],"description":"Release action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"tagName":{"type":"string","description":"Git tag name for the release"},"releaseName":{"type":"string","description":"Release name/title"},"body":{"type":"string","description":"Release notes body (markdown)"},"draft":{"type":"boolean","description":"Whether the release is a draft"},"prerelease":{"type":"boolean","description":"Whether the release is a prerelease"},"targetCommitish":{"type":"string","description":"Target branch or commit for the release tag"},"author":{"type":"string","description":"Release author username"},"url":{"type":"string","description":"Release URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","tagName","releaseName","body","draft","prerelease","targetCommitish","author","url","integrationId","payload"],"description":"GitHub release event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.issues"],"description":"Triggered by GitHub issue events"},"data":{"type":"object","properties":{"action":{"type":"string","enum":["opened","closed","reopened","labeled","assigned","edited"],"description":"Issue action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"number":{"type":"number","description":"Issue number"},"title":{"type":"string","description":"Issue title"},"body":{"type":"string","description":"Issue body (markdown)"},"state":{"type":"string","enum":["open","closed"],"description":"Current issue state"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels applied to the issue"},"author":{"type":"string","description":"Issue author username"},"url":{"type":"string","description":"Issue URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","number","title","body","state","labels","author","url","integrationId","payload"],"description":"GitHub issues event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.issue_comment"],"description":"Triggered by GitHub issue or PR comment events"},"data":{"type":"object","properties":{"action":{"type":"string","enum":["created","edited","deleted"],"description":"Comment action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"issueNumber":{"type":"number","description":"Issue or PR number the comment belongs to"},"issueTitle":{"type":"string","description":"Title of the issue or PR"},"isPullRequest":{"type":"boolean","description":"Whether the comment is on a pull request (true) or issue (false)"},"commentId":{"type":"number","description":"Comment ID"},"commentBody":{"type":"string","description":"Comment body text (markdown)"},"commentAuthor":{"type":"string","description":"Comment author username"},"url":{"type":"string","description":"Comment URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","issueNumber","issueTitle","isPullRequest","commentId","commentBody","commentAuthor","url","integrationId","payload"],"description":"GitHub issue comment event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["github.review_comment"],"description":"Triggered by GitHub PR review comment events"},"data":{"type":"object","properties":{"action":{"type":"string","enum":["created","edited","deleted"],"description":"Review comment action"},"repository":{"type":"string","description":"Full repository name (owner/repo)"},"owner":{"type":"string","description":"Repository owner"},"repo":{"type":"string","description":"Repository name"},"sender":{"type":"string","description":"GitHub username who triggered the event"},"pullNumber":{"type":"number","description":"Pull request number"},"prTitle":{"type":"string","description":"Pull request title"},"commentId":{"type":"number","description":"Comment ID"},"commentBody":{"type":"string","description":"Comment body text (markdown)"},"commentAuthor":{"type":"string","description":"Comment author username"},"filePath":{"type":"string","description":"File path the comment is on"},"diffHunk":{"type":"string","description":"Diff hunk context for the comment"},"url":{"type":"string","description":"Comment URL"},"integrationId":{"type":"string","description":"GitHub integration ID"},"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"Full GitHub webhook payload"}},"required":["action","repository","owner","repo","sender","pullNumber","prTitle","commentId","commentBody","commentAuthor","filePath","diffHunk","url","integrationId","payload"],"description":"GitHub review comment event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["cron"],"description":"Triggered on a recurring schedule"},"data":{"type":"object","properties":{"cronExpression":{"type":"string","description":"The cron expression that triggered this event"},"timestamp":{"type":"number","description":"Trigger timestamp in milliseconds since epoch"}},"required":["cronExpression","timestamp"],"description":"Cron schedule event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["issue.triaged"],"description":"Triggered when Polylane finishes triaging an issue"},"data":{"type":"object","properties":{"issue":{"$ref":"#/components/schemas/Issue"},"investigationThreadId":{"type":"string","nullable":true,"description":"Investigation thread id when one was started, null otherwise"}},"required":["issue","investigationThreadId"],"description":"Issue triaged event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["webhook"],"description":"Triggered by an incoming webhook request"},"data":{"type":"object","properties":{"payload":{"type":"object","additionalProperties":{"nullable":true},"description":"The webhook request payload"},"timestamp":{"type":"number","description":"Webhook receipt timestamp in milliseconds"}},"required":["payload","timestamp"],"description":"Webhook event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["cloud_account.connected"],"description":"Triggered when a new cloud account is connected"},"data":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","description":"Cloud account ID"},"ownerId":{"type":"string","description":"ID of the account owner"},"provider":{"type":"string","description":"Cloud provider (e.g. aws, vercel, cloudflare)","x-shared-enum":"cloudProvider"},"status":{"type":"string","enum":["ready","syncing","new"],"description":"Current sync status of the account"},"region":{"type":"string","description":"Cloud region identifier"},"account":{"type":"string","description":"Provider account identifier (e.g. AWS account ID)"},"alias":{"type":"string","description":"Human-readable alias for the account"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels applied to the account"},"metadata":{"type":"object","additionalProperties":{"nullable":true},"description":"Provider-specific metadata"},"lastSync":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"},{"nullable":true}],"description":"Last sync timestamp (epoch milliseconds or ISO 8601 string), or null if never synced"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","ownerId","provider","status","region","account","alias","labels","metadata","lastSync","created","updated"],"description":"Cloud account details"}},"required":["account"],"description":"Cloud account connected event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["cloud_account.synced"],"description":"Triggered when a cloud account finishes syncing"},"data":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","description":"Cloud account ID"},"ownerId":{"type":"string","description":"ID of the account owner"},"provider":{"type":"string","description":"Cloud provider (e.g. aws, vercel, cloudflare)","x-shared-enum":"cloudProvider"},"status":{"type":"string","enum":["ready","syncing","new"],"description":"Current sync status of the account"},"region":{"type":"string","description":"Cloud region identifier"},"account":{"type":"string","description":"Provider account identifier (e.g. AWS account ID)"},"alias":{"type":"string","description":"Human-readable alias for the account"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels applied to the account"},"metadata":{"type":"object","additionalProperties":{"nullable":true},"description":"Provider-specific metadata"},"lastSync":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"},{"nullable":true}],"description":"Last sync timestamp (epoch milliseconds or ISO 8601 string), or null if never synced"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","ownerId","provider","status","region","account","alias","labels","metadata","lastSync","created","updated"],"description":"Cloud account details"},"notify":{"type":"boolean","description":"Whether to notify users about the sync completion"}},"required":["account","notify"],"description":"Cloud account synced event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["change_record.created"],"description":"Triggered when an infrastructure change is detected"},"data":{"type":"object","properties":{"record":{"type":"object","properties":{"id":{"type":"string","description":"Change record ID"},"syncTimestamp":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Sync timestamp (epoch milliseconds or ISO 8601 string) when the change was detected"},"previousSyncTimestamp":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"},{"nullable":true}],"description":"Previous sync timestamp, or null for the first sync"},"title":{"type":"string","description":"Human-readable title describing the change"},"nodesAdded":{"type":"number","description":"Number of infrastructure nodes added"},"nodesRemoved":{"type":"number","description":"Number of infrastructure nodes removed"},"nodesModified":{"type":"number","description":"Number of infrastructure nodes modified"},"edgesAdded":{"type":"number","description":"Number of infrastructure edges (relationships) added"},"edgesRemoved":{"type":"number","description":"Number of infrastructure edges removed"},"edgesModified":{"type":"number","description":"Number of infrastructure edges modified"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","syncTimestamp","previousSyncTimestamp","title","nodesAdded","nodesRemoved","nodesModified","edgesAdded","edgesRemoved","edgesModified","created","updated"],"description":"Infrastructure change record"},"details":{"type":"object","properties":{"nodes":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Infrastructure node type (e.g. aws.lambda.function, cf.workers.script)"},"id":{"type":"string","description":"Node identifier"},"name":{"type":"string","description":"Human-readable node name"}},"required":["type","id"]},"description":"Nodes added in this change"},"removed":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Infrastructure node type (e.g. aws.lambda.function, cf.workers.script)"},"id":{"type":"string","description":"Node identifier"},"name":{"type":"string","description":"Human-readable node name"}},"required":["type","id"]},"description":"Nodes removed in this change"},"modified":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Infrastructure node type (e.g. aws.lambda.function, cf.workers.script)"},"id":{"type":"string","description":"Node identifier"},"name":{"type":"string","description":"Human-readable node name"}},"required":["type","id"]},"description":"Nodes modified in this change"}},"required":["added","removed","modified"],"description":"Node-level changes"},"edges":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","description":"Source node identifier"},"target":{"type":"string","description":"Target node identifier"},"relationship":{"type":"string","description":"Relationship type between nodes (e.g. connects_to, contains, invokes)"}},"required":["source","target","relationship"]},"description":"Edges added in this change"},"removed":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","description":"Source node identifier"},"target":{"type":"string","description":"Target node identifier"},"relationship":{"type":"string","description":"Relationship type between nodes (e.g. connects_to, contains, invokes)"}},"required":["source","target","relationship"]},"description":"Edges removed in this change"},"modified":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","description":"Source node identifier"},"target":{"type":"string","description":"Target node identifier"},"relationship":{"type":"string","description":"Relationship type between nodes (e.g. connects_to, contains, invokes)"}},"required":["source","target","relationship"]},"description":"Edges modified in this change"}},"required":["added","removed","modified"],"description":"Edge-level (relationship) changes"}},"required":["nodes","edges"],"description":"Detailed breakdown of infrastructure changes"}},"required":["record","details"],"description":"Change record created event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["codebase.synced"],"description":"Triggered when a codebase finishes syncing"},"data":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","description":"Repository ID"},"remoteId":{"type":"string","description":"Remote repository ID from the git provider"},"name":{"type":"string","description":"Repository name"},"owner":{"type":"string","description":"Repository owner (user or organization)"},"description":{"type":"string","nullable":true,"description":"Repository description"},"integrationId":{"type":"string","description":"Integration ID for the git provider connection"},"status":{"type":"string","enum":["ready","syncing","new","errored"],"description":"Current sync status"},"lastSync":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"},{"nullable":true}],"description":"Last sync timestamp (epoch milliseconds or ISO 8601 string), or null if never synced"},"provider":{"type":"string","enum":["github"],"description":"Git provider"},"keywords":{"type":"array","items":{"type":"string"},"description":"Keywords associated with the repository"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels applied to the repository"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","remoteId","name","owner","description","integrationId","status","lastSync","provider","keywords","labels","created","updated"],"description":"Repository details"},"notify":{"type":"boolean","description":"Whether to notify users about the sync completion"}},"required":["repository","notify"],"description":"Codebase synced event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["infra_node.created"],"description":"Triggered when a new infrastructure resource is discovered"},"data":{"type":"object","properties":{"node":{"type":"object","properties":{"provider":{"type":"string","description":"Cloud provider (e.g. aws, cloudflare)","x-shared-enum":"cloudProvider"},"account":{"type":"string","description":"Provider account identifier"},"region":{"type":"string","description":"Cloud region"},"type":{"type":"string","description":"Infrastructure node type (e.g. aws.lambda.function, cf.workers.script)"},"id":{"type":"string","description":"Node identifier (e.g. ARN, resource name)"},"data":{"type":"object","additionalProperties":{"nullable":true},"description":"Provider-specific resource data and attributes"},"alternateNames":{"type":"array","items":{"type":"string"},"description":"Alternate names or aliases for this resource"},"createdBy":{"type":"string","description":"User or system that created this node"},"lastEditedBy":{"type":"string","description":"User or system that last edited this node"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["provider","account","region","type","id","data","alternateNames","createdBy","lastEditedBy","created","updated"],"description":"Infrastructure node representing a cloud resource"}},"required":["node"],"description":"Infrastructure node created event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["integration.connected"],"description":"Triggered when a new integration is connected to the workspace"},"data":{"type":"object","properties":{"integration":{"type":"object","properties":{"id":{"type":"string","description":"Integration ID"},"type":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","sentry","mcp","devin","cursor","factory"],"description":"Integration type (e.g. github, slack, datadog, honeycomb, axiom, sentry, mcp)"},"name":{"type":"string","description":"Human-readable integration name"},"externalId":{"type":"string","nullable":true,"description":"External identifier from the provider, or null"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","type","name","externalId","created","updated"],"description":"Integration details (secrets and credentials omitted)"}},"required":["integration"],"description":"Integration connected event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["repository.created"],"description":"Triggered the moment a repository is connected to Polylane"},"data":{"type":"object","properties":{"repository":{"type":"object","properties":{"id":{"type":"string","description":"Repository ID"},"remoteId":{"type":"string","description":"Remote repository ID from the git provider"},"name":{"type":"string","description":"Repository name"},"owner":{"type":"string","description":"Repository owner (user or organization)"},"description":{"type":"string","nullable":true,"description":"Repository description"},"integrationId":{"type":"string","description":"Integration ID for the git provider connection"},"status":{"type":"string","enum":["ready","syncing","new","errored"],"description":"Current sync status"},"lastSync":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"},{"nullable":true}],"description":"Last sync timestamp (epoch milliseconds or ISO 8601 string), or null if never synced"},"provider":{"type":"string","enum":["github"],"description":"Git provider"},"keywords":{"type":"array","items":{"type":"string"},"description":"Keywords associated with the repository"},"labels":{"type":"array","items":{"type":"string"},"description":"Labels applied to the repository"},"created":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Creation timestamp (epoch milliseconds or ISO 8601 string)"},"updated":{"anyOf":[{"type":"number"},{"type":"string","format":"date-time"}],"description":"Last update timestamp (epoch milliseconds or ISO 8601 string)"}},"required":["id","remoteId","name","owner","description","integrationId","status","lastSync","provider","keywords","labels","created","updated"],"description":"Repository details"}},"required":["repository"],"description":"Repository created event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["slack.message_received"],"description":"Triggered when a Slack message is observed by the Polylane Slack bot"},"data":{"type":"object","properties":{"integrationId":{"type":"string","description":"Slack integration ID that observed the message"},"teamId":{"type":"string","description":"Slack team (workspace) ID"},"channelId":{"type":"string","description":"Slack channel ID"},"channelName":{"type":"string","description":"Slack channel name, if available"},"channelType":{"type":"string","enum":["channel","group","im","mpim"],"description":"Channel type (channel, group, im, mpim)"},"messageTs":{"type":"string","description":"Slack message timestamp identifier"},"threadTs":{"type":"string","description":"Slack thread timestamp identifier if the message is in a thread"},"isThreadReply":{"type":"boolean","description":"True when the message is a reply inside a thread"},"userId":{"type":"string","description":"Slack user ID of the author"},"userName":{"type":"string","description":"Slack username if available"},"botUserId":{"type":"string","description":"Bot user ID of the Polylane Slack bot in this workspace"},"text":{"type":"string","description":"Raw message text"},"isBot":{"type":"boolean","description":"True if the message was posted by a bot"},"mentionsBot":{"type":"boolean","description":"True if the message @mentions the Polylane Slack bot"},"timestamp":{"type":"number","description":"Receipt timestamp in milliseconds"}},"required":["integrationId","teamId","channelId","channelType","messageTs","isThreadReply","userId","botUserId","text","isBot","mentionsBot","timestamp"],"description":"Slack message received event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["cloudflare.deployment"],"description":"Triggered when a Cloudflare resource is deployed"},"data":{"type":"object","properties":{"workspaceId":{"type":"string"},"accountId":{"type":"string","description":"Cloudflare account ID"},"deployId":{"type":"string","description":"Cloudflare deployment ID"},"resourceType":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"],"description":"Cloudflare resource type"},"resourceId":{"type":"string","description":"Cloudflare resource ID (worker/page/container name)"},"environment":{"type":"string","nullable":true,"description":"Deployment environment, if known"},"actor":{"type":"string","nullable":true,"description":"Who triggered the deploy, if known"},"atMs":{"type":"number","description":"Deployment timestamp in milliseconds"},"raw":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]},"description":"Raw deployment summary"}},"required":["workspaceId","accountId","deployId","resourceType","resourceId","environment","actor","atMs","raw"],"description":"Cloudflare deployment event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["vercel.deployment"],"description":"Triggered when a Vercel deployment changes state"},"data":{"type":"object","properties":{"workspaceId":{"type":"string"},"accountId":{"type":"string","description":"Vercel account ID"},"deployId":{"type":"string","description":"Vercel deployment ID"},"projectId":{"type":"string","description":"Vercel project ID"},"environment":{"type":"string","description":"Deployment environment (e.g. production, preview)"},"branch":{"type":"string","nullable":true,"description":"Git branch, if known"},"sha":{"type":"string","nullable":true,"description":"Git commit SHA, if known"},"state":{"type":"string","enum":["BUILDING","READY","ERROR","CANCELED"],"description":"Vercel deployment state"},"createdAtMs":{"type":"number","description":"Deployment creation timestamp in milliseconds"},"readyAtMs":{"type":"number","nullable":true,"description":"Deployment ready timestamp in milliseconds, if reached"},"url":{"type":"string","nullable":true,"description":"Deployment URL, if available"}},"required":["workspaceId","accountId","deployId","projectId","environment","branch","sha","state","createdAtMs","readyAtMs","url"],"description":"Vercel deployment event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["render.deployment"],"description":"Triggered when a Render deployment changes state"},"data":{"type":"object","properties":{"workspaceId":{"type":"string"},"accountId":{"type":"string","description":"Render account ID"},"deployId":{"type":"string","description":"Render deployment ID"},"serviceId":{"type":"string","description":"Render service ID"},"status":{"type":"string","enum":["created","build_in_progress","update_in_progress","live","deactivated","build_failed","update_failed","canceled","pre_deploy_in_progress","pre_deploy_failed"],"description":"Render deployment status"},"trigger":{"type":"string","nullable":true,"enum":["api","deploy_hook","github","gitlab","manual","new_commit","other","rollback",null],"description":"What initiated the Render deploy, if known"},"commitId":{"type":"string","nullable":true,"description":"Git commit ID, if known"},"commitMessage":{"type":"string","nullable":true,"description":"Git commit message, if known"},"createdAtMs":{"type":"number","description":"Deployment creation timestamp in milliseconds"},"finishedAtMs":{"type":"number","nullable":true,"description":"Deployment finished timestamp in milliseconds, if finished"}},"required":["workspaceId","accountId","deployId","serviceId","status","trigger","commitId","commitMessage","createdAtMs","finishedAtMs"],"description":"Render deployment event payload"}},"required":["type","data"]},{"type":"object","properties":{"type":{"type":"string","enum":["fly.deployment"],"description":"Triggered when a Fly.io app is deployed"},"data":{"type":"object","properties":{"workspaceId":{"type":"string"},"accountId":{"type":"string","description":"Fly account ID"},"deployId":{"type":"string","description":"Fly deployment ID"},"appId":{"type":"string","description":"Fly app name"},"imageRef":{"type":"string","description":"Deployed image reference"},"machinesUpdated":{"type":"number","description":"Number of machines updated by the deploy"},"regions":{"type":"array","items":{"type":"string"},"description":"Fly regions the deploy targeted"},"firstUpdatedAtMs":{"type":"number","description":"First machine update timestamp in milliseconds"},"lastUpdatedAtMs":{"type":"number","description":"Last machine update timestamp in milliseconds"}},"required":["workspaceId","accountId","deployId","appId","imageRef","machinesUpdated","regions","firstUpdatedAtMs","lastUpdatedAtMs"],"description":"Fly deployment event payload"}},"required":["type","data"]}],"description":"Optional event payload to trigger the automation with. If omitted, a synthetic event matching the automation's trigger is used."}},"required":["workspaceId","id"]},"Issue":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string","enum":["polylane","datadog","honeycomb","sentry","cloudwatch","vercel","axiom","betterstack","render","cloudflare","github"]},"origin":{"type":"string","enum":["monitoring","threshold","defect","change_record","alert","automation","manual"]},"originId":{"type":"string","nullable":true},"externalId":{"type":"string","nullable":true},"integrationId":{"type":"string","nullable":true},"checkId":{"type":"string","nullable":true},"checkRunId":{"type":"string","nullable":true},"contributingCheckIds":{"type":"array","items":{"type":"string"}},"resourceKind":{"type":"string","nullable":true,"enum":["infra_node","cloud_account","integration","repository",null]},"resourceId":{"type":"string","nullable":true},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"reasoning":{"type":"string","nullable":true},"verdictReason":{"type":"string","nullable":true},"tags":{"type":"object","additionalProperties":{"type":"string"}},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/IssueMetricSummary"}},"sourceSeverity":{"type":"string","nullable":true,"enum":["critical","error","warning","info","ok",null]},"sourceStatus":{"type":"string","nullable":true,"enum":["triggered","recovered","acknowledged","unknown",null]},"severity":{"type":"string","enum":["critical","high","medium","low","info"]},"status":{"type":"string","enum":["new","triaging","confirmed","dismissed","failed","skipped"]},"investigationThreadId":{"type":"string","nullable":true},"investigationHeldAt":{"type":"string","nullable":true,"format":"date-time","description":"Set when the auto-investigation quota held back starting an investigation for this confirmed issue; cleared when one starts."},"investigationParentIssueId":{"type":"string","nullable":true,"description":"Set when this issue is a duplicate of another open issue: it is not investigated separately, and the parent issue's investigation covers it. Follow the parentIssue link for the investigation."},"fingerprint":{"type":"string","nullable":true},"occurrenceCount":{"type":"integer","minimum":1},"detectedAt":{"type":"string","format":"date-time"},"lastSeenAt":{"type":"string","format":"date-time"},"metricsComputedAt":{"type":"string","nullable":true,"format":"date-time"},"triagedAt":{"type":"string","nullable":true,"format":"date-time"},"resolvedAt":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","source","origin","originId","externalId","integrationId","checkId","checkRunId","contributingCheckIds","resourceKind","resourceId","provider","account","region","nodeType","title","summary","message","reasoning","verdictReason","tags","metrics","sourceSeverity","sourceStatus","severity","status","investigationThreadId","investigationHeldAt","investigationParentIssueId","fingerprint","occurrenceCount","detectedAt","lastSeenAt","metricsComputedAt","triagedAt","resolvedAt"],"additionalProperties":false},"IssueMetricSummary":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string","nullable":true},"calculation":{"type":"string"},"value":{"type":"number","nullable":true},"current":{"type":"number","nullable":true},"min":{"type":"number","nullable":true},"avg":{"type":"number","nullable":true},"max":{"type":"number","nullable":true},"unit":{"type":"string","nullable":true},"chartGroup":{"type":"string","nullable":true},"query":{"type":"string"},"series":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["time","value"],"additionalProperties":false}},"baselineMean":{"type":"number","nullable":true},"baselineStd":{"type":"number","nullable":true},"deviationSigma":{"type":"number","nullable":true},"worseDirection":{"type":"string","nullable":true,"enum":["up","down","both",null]},"breachFromIndex":{"type":"integer","nullable":true}},"required":["id","label","calculation","current","min","avg","max"],"additionalProperties":false},"RegenerateWebhookTokenResponse":{"type":"object","properties":{"token":{"type":"string","description":"New webhook token"}},"required":["token"]},"RegenerateWebhookTokenBody":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"automationId":{"type":"string","description":"Automation ID"},"webhookTokenIndex":{"type":"integer","minimum":0,"description":"Index of the webhook trigger to regenerate (defaults to 0 when the automation has a single webhook trigger)"}},"required":["workspaceId","automationId"]},"CreateAutomationFromTemplateBody":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"templateSlug":{"type":"string","minLength":1,"description":"Slug of the template to create the automation from"},"passCount":{"type":"integer","minimum":1,"maximum":10,"description":"Override the template's default number of parallel agent passes"},"provider":{"type":"string","enum":["github","slack","datadog","honeycomb","axiom","betterstack","aws","vercel","cloudflare","fly","render","sentry","cloudwatch","devin","cursor","factory"],"description":"Sanity-check the template targets this provider: the request fails if the template's providers list does not include it"}},"required":["workspaceId","templateSlug"],"additionalProperties":false},"RerunExecutionBody":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"automationId":{"type":"string","description":"ID of the automation"},"executionId":{"type":"string","description":"ID of the execution to rerun"}},"required":["workspaceId","automationId","executionId"]},"AutomationNotification":{"type":"object","properties":{"id":{"type":"string","pattern":"^auto_notif_[0-9a-z]{24}$","description":"ID of the automation_notification","example":"auto_notif_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"automationId":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"executionId":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the automation_execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"destinationType":{"type":"string","enum":["email","slack","webhook"],"description":"Destination type"},"recipient":{"type":"string","description":"Recipient address or identifier"},"status":{"type":"string","enum":["sent","failed"],"description":"Delivery status"},"error":{"type":"string","nullable":true,"description":"Error message if failed"},"sentAt":{"type":"string","nullable":true,"format":"date-time","description":"When the notification was sent"},"created":{"type":"string","nullable":true,"format":"date-time","description":"Created timestamp"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_notification"]}},"required":["id","workspaceId","automationId","executionId","destinationType","recipient","status","error","sentAt","created","_object"],"additionalProperties":false},"AutomationActionExecution":{"type":"object","properties":{"id":{"type":"string","pattern":"^auto_action_[0-9a-z]{24}$","description":"ID of the automation_action_execution","example":"auto_action_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"automationId":{"type":"string","pattern":"^auto_[0-9a-z]{24}$","description":"ID of the automation","example":"auto_38mg3o4ibc92h8t2efn8csrh"},"executionId":{"type":"string","pattern":"^auto_exec_[0-9a-z]{24}$","description":"ID of the automation_execution","example":"auto_exec_38mg3o4ibc92h8t2efn8csrh"},"actionType":{"type":"string","enum":["submitPr","commentPr","commentGithubIssue","mergePr","createGithubIssue","rollbackCloudflareDeployment","rollbackVercelDeployment","rollbackRenderDeployment","rollbackFlyDeployment","openIssue","autofix","handoffToDevin","handoffToCursor","handoffToFactory"],"description":"Action type"},"targetKey":{"type":"string","description":"Stable grouping key — `owner/repo#resource` or similar"},"metadata":{"oneOf":[{"type":"object","properties":{"actionType":{"type":"string","enum":["submitPr"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"type":"string"},"sha":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"draft":{"type":"boolean"}},"required":["branch","sha","title","body"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["commentPr"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"body":{"type":"string"}},"required":["pullNumber","body"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["commentGithubIssue"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"issueNumber":{"type":"number"},"body":{"type":"string"}},"required":["issueNumber","body"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["mergePr"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"pullNumber":{"type":"number"},"method":{"type":"string","enum":["merge","squash","rebase"]},"commitTitle":{"type":"string"}},"required":["pullNumber","method"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["createGithubIssue"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}}},"required":["title","body"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["rollbackCloudflareDeployment"]},"input":{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_version"]},"versionId":{"type":"string"}},"required":["strategy"]},"target":{"type":"object","properties":{"accountId":{"type":"string"},"resourceType":{"type":"string","enum":["workers.script","workers.deployments.deployment","pages.deployment","containers.application"]},"resourceId":{"type":"string"},"failingDeployId":{"type":"string"}},"required":["accountId","resourceType","resourceId"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","target","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["rollbackVercelDeployment"]},"input":{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_deployment"]},"deploymentId":{"type":"string"}},"required":["strategy"]},"target":{"type":"object","properties":{"accountId":{"type":"string"},"projectId":{"type":"string"},"environment":{"type":"string","enum":["production","preview","development"]},"failingDeploymentId":{"type":"string"}},"required":["accountId","projectId","environment"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","target","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["rollbackRenderDeployment"]},"input":{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous","pin_to_commit"]},"commitId":{"type":"string"}},"required":["strategy"]},"target":{"type":"object","properties":{"accountId":{"type":"string"},"serviceId":{"type":"string"},"failingDeployId":{"type":"string"}},"required":["accountId","serviceId"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","target","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["rollbackFlyDeployment"]},"input":{"type":"object","properties":{"strategy":{"type":"string","enum":["redeploy_previous_image","pin_to_image"]},"imageRef":{"type":"string"}},"required":["strategy"]},"target":{"type":"object","properties":{"accountId":{"type":"string"},"appId":{"type":"string"},"failingImageRef":{"type":"string"},"regions":{"type":"array","items":{"type":"string"}}},"required":["accountId","appId"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","target","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["openIssue"]},"input":{"type":"object","properties":{"title":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low","info"]},"prompt":{"type":"string"}},"required":["title","severity","prompt"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["autofix"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["handoffToDevin"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["handoffToCursor"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]},{"type":"object","properties":{"actionType":{"type":"string","enum":["handoffToFactory"]},"input":{"type":"object","properties":{"owner":{"type":"string"},"repo":{"type":"string"},"baseBranch":{"type":"string"},"title":{"type":"string"},"instructions":{"type":"string"}},"required":["title","instructions"]},"mergedFrom":{"type":"array","items":{"type":"object","properties":{"threadId":{"type":"string"},"artifactId":{"type":"string"},"passIndex":{"type":"integer","minimum":0}},"required":["threadId","artifactId","passIndex"]}},"mergeStrategy":{"type":"string","enum":["single","vote","llm-synthesis","union","strict-agreement","blocked-disagreement"]},"mergeNote":{"type":"string"}},"required":["actionType","input","mergedFrom","mergeStrategy"]}],"description":"Full merged action payload and provenance"},"status":{"type":"string","enum":["pending","running","succeeded","failed","skipped"],"description":"Execution status"},"statusDetail":{"type":"string","nullable":true,"description":"Status detail (e.g. failure reason)"},"attempt":{"type":"integer","nullable":true,"minimum":0,"description":"Execution attempt counter"},"externalRef":{"type":"object","nullable":true,"properties":{"provider":{"type":"string","enum":["github","vercel","render","fly","cloudflare","nominal","devin","cursor","factory"]},"kind":{"type":"string","enum":["pr","review","comment","deployment","issue","incident","session"]},"url":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"number"}]}},"required":["provider","kind","url","id"],"additionalProperties":false},"resolvedTarget":{"type":"object","nullable":true,"properties":{"owner":{"type":"string"},"repo":{"type":"string"},"integrationId":{"type":"string"}},"required":["owner","repo","integrationId"],"additionalProperties":false},"created":{"type":"string","nullable":true,"format":"date-time","description":"Created timestamp"},"updated":{"type":"string","nullable":true,"format":"date-time","description":"Last update timestamp"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["automation_action_execution"]}},"required":["id","workspaceId","automationId","executionId","actionType","targetKey","metadata","status","statusDetail","attempt","externalRef","resolvedTarget","created","updated","_object"],"additionalProperties":false},"AutofixTimelineEventsList":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AutofixTimelineEvent"}},"total":{"type":"number"}},"required":["items","total"],"additionalProperties":false},"AutofixTimelineEvent":{"type":"object","properties":{"id":{"type":"string","pattern":"^tle_[0-9a-z]{32}$","description":"ID of the timeline_event","example":"tle_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"autofixId":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["autofix.started","autofix.branch_pushed","autofix.pr_opened","autofix.merged","autofix.closed","autofix.failed","autofix.no_fix_needed","autofix.already_in_flight","autofix.quota_exhausted","autofix.investigation_thread_linked","note","milestone"],"description":"Event type"},"at":{"type":"string","nullable":true,"format":"date-time","description":"When the event happened"},"title":{"type":"string","nullable":true,"description":"Optional human title"},"body":{"type":"string","nullable":true,"description":"Optional markdown body"},"data":{"type":"object","nullable":true,"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]},"description":"Type-specific payload"},"refType":{"type":"string","nullable":true,"enum":["thread","automation","investigation","pull_request",null],"description":"Linked entity type"},"refId":{"type":"string","nullable":true,"description":"Linked entity id"},"createdBy":{"type":"string","description":"User id or 'system'"},"deleted":{"type":"string","nullable":true,"format":"date-time","description":"Delete timestamp"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["timeline_event"]}},"required":["id","workspaceId","autofixId","type","at","title","body","data","refType","refId","createdBy","deleted","created","updated","_object"],"additionalProperties":false},"Autofix":{"type":"object","properties":{"id":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the autofix","example":"fix_38mg3o4ibc92h8t2efn8csrh"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"provider":{"type":"string","enum":["github"]},"owner":{"type":"string"},"repo":{"type":"string"},"branch":{"type":"string"},"status":{"type":"string","enum":["started","branch_pushed","pr_opened","merged","closed","failed","no_fix_needed","already_in_flight","quota_exhausted"]},"origin":{"type":"string","enum":["automation","chat","investigation","system"]},"trigger":{"type":"string","nullable":true,"enum":["repo_connect","pr_review","ci_failure",null],"description":"Which system flow created the autofix; null for user-initiated autofixes"},"executor":{"type":"string","enum":["native","devin","cursor","factory"]},"commitSha":{"type":"string","nullable":true},"baseBranch":{"type":"string","nullable":true},"automationId":{"type":"string","nullable":true},"executionId":{"type":"string","nullable":true},"actionRowId":{"type":"string","nullable":true},"actionPlanId":{"type":"string","nullable":true},"hypothesisId":{"type":"string","nullable":true},"runId":{"type":"string","nullable":true},"investigationThreadId":{"type":"string","nullable":true},"pullNumber":{"type":"integer","nullable":true},"threadId":{"type":"string","nullable":true},"parentThreadId":{"type":"string","nullable":true},"parentMessageId":{"type":"string","nullable":true},"artifactId":{"type":"string","nullable":true},"findingsCount":{"type":"integer","nullable":true},"title":{"type":"string","nullable":true},"prompt":{"type":"string","nullable":true},"failureReason":{"type":"string","nullable":true},"skippedReason":{"type":"string","nullable":true},"coveringPrNumber":{"type":"integer","nullable":true,"description":"For already_in_flight autofixes, the open pull request that already covers the fix"},"coveringPrUrl":{"type":"string","nullable":true,"description":"For already_in_flight autofixes, the URL of the open pull request that already covers the fix"},"submittedPrNumber":{"type":"integer","nullable":true},"submittedPrUrl":{"type":"string","nullable":true},"submittedAt":{"type":"string","nullable":true,"format":"date-time"},"mergedPrNumber":{"type":"integer","nullable":true},"mergedPrUrl":{"type":"string","nullable":true},"mergedAt":{"type":"string","nullable":true,"format":"date-time"},"mergedBy":{"type":"string","nullable":true},"closedAt":{"type":"string","nullable":true,"format":"date-time"},"closedBy":{"type":"string","nullable":true},"closeReason":{"type":"string","nullable":true,"enum":["incorrect_fix","superseded_by_human","not_a_real_issue","stale","intentional_behavior","unexplained",null],"description":"Why the pull request was closed without merging, classified from its comments, reviews, and close context"},"closeReasonDetail":{"type":"string","nullable":true,"description":"Short rationale for the close reason, quoting the evidence it was derived from"},"closeEvidence":{"type":"string","nullable":true,"description":"JSON snapshot of the discussion signals (comments, reviews, commits) the close reason was classified from"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"devinUrl":{"type":"string","nullable":true,"description":"Devin session URL (present for devin-executed autofixes)"},"cursorUrl":{"type":"string","nullable":true,"description":"Cursor agent URL (present for cursor-executed autofixes)"},"factoryUrl":{"type":"string","nullable":true,"description":"Factory session URL (present for factory-executed autofixes)"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["autofix"]}},"required":["id","workspaceId","provider","owner","repo","branch","status","origin","trigger","executor","commitSha","baseBranch","automationId","executionId","actionRowId","actionPlanId","hypothesisId","runId","investigationThreadId","pullNumber","threadId","parentThreadId","parentMessageId","artifactId","findingsCount","title","prompt","failureReason","skippedReason","coveringPrNumber","coveringPrUrl","submittedPrNumber","submittedPrUrl","submittedAt","mergedPrNumber","mergedPrUrl","mergedAt","mergedBy","closedAt","closedBy","closeReason","closeReasonDetail","closeEvidence","created","updated","_object"],"additionalProperties":false},"AutofixRerun":{"type":"object","properties":{"id":{"type":"string"},"autofixId":{"type":"string"}},"required":["id","autofixId"]},"RerunAutofixRequest":{"type":"object","properties":{"workspaceId":{"type":"string","description":"ID of the workspace"},"id":{"type":"string","pattern":"^fix_[0-9a-z]{24}$","description":"ID of the skipped autofix to run again","example":"fix_38mg3o4ibc92h8t2efn8csrh"}},"required":["workspaceId","id"]},"IssueTimelineEventsList":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/IssueTimelineEvent"}},"total":{"type":"number"}},"required":["items","total"],"additionalProperties":false},"IssueTimelineEvent":{"type":"object","properties":{"id":{"type":"string","pattern":"^tle_[0-9a-z]{32}$","description":"ID of the timeline_event","example":"tle_d18564pxsvozx979j3532mii2kk7pmw6"},"workspaceId":{"type":"string","pattern":"^ws_[0-9a-z]{32}$","description":"ID of the workspace","example":"ws_rii32455qptezc7467usm3f3hq31qkwp"},"issueId":{"type":"string","pattern":"^iss_[0-9a-z]{24}$","description":"ID of the issue","example":"iss_38mg3o4ibc92h8t2efn8csrh"},"type":{"type":"string","enum":["issue.detected","issue.re_detected","issue.triaging","issue.triaged","issue.resolved","issue.investigation_linked","issue.investigation_unlinked","issue.correlated","investigation.started","investigation.held","investigation.run_started","investigation.run_completed","investigation.hypothesis_completed","autofix.started","autofix.branch_pushed","autofix.pr_opened","autofix.failed","autofix.merged","autofix.closed","note","milestone"],"description":"Event type"},"at":{"type":"string","nullable":true,"format":"date-time","description":"When the event happened"},"title":{"type":"string","nullable":true,"description":"Optional human title"},"body":{"type":"string","nullable":true,"description":"Optional markdown body"},"data":{"type":"object","nullable":true,"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"nullable":true}]},"description":"Type-specific payload"},"refType":{"type":"string","nullable":true,"enum":["investigation","thread","memory","automation","run","hypothesis","autofix","pull_request","artifact","issue",null],"description":"Linked entity type"},"refId":{"type":"string","nullable":true,"description":"Linked entity id"},"createdBy":{"type":"string","description":"User id or 'system'"},"deleted":{"type":"string","nullable":true,"format":"date-time","description":"Delete timestamp"},"created":{"type":"string","nullable":true,"format":"date-time"},"updated":{"type":"string","nullable":true,"format":"date-time"},"_html_url":{"type":"string"},"_links":{"type":"object","additionalProperties":{"type":"string"},"description":"Related API endpoints for this resource, discovered at runtime so consumers (including agents) never have to guess a path. Each key is a named relation; each value is a fully-qualified HTTPS URL to a JSON API endpoint on this workspace's API origin (these are API routes that return JSON — the human-viewable browser page is in the sibling `_html_url` field). `self` (when present) is the canonical GET for the current resource. Plural relations point to list endpoints that return a paginated `{ items, count }` payload when GET'ed. Singular relations point to a single-resource endpoint. Follow any link with the same authentication (Authorization bearer token or x-api-key header) you used for this request."},"_object":{"type":"string","enum":["timeline_event"]}},"required":["id","workspaceId","issueId","type","at","title","body","data","refType","refId","createdBy","deleted","created","updated","_object"],"additionalProperties":false},"InvestigateIssueResponse":{"type":"object","properties":{"issueId":{"type":"string"},"investigationThreadId":{"type":"string"},"deduped":{"type":"boolean"}},"required":["issueId","investigationThreadId","deduped"]},"IssueWithDetails":{"allOf":[{"$ref":"#/components/schemas/Issue"},{"type":"object","properties":{"raw":{"type":"object","nullable":true,"additionalProperties":{"nullable":true}},"analysisMarkdown":{"type":"string","nullable":true},"logs":{"$ref":"#/components/schemas/IssueLogsBlob"},"traces":{"$ref":"#/components/schemas/IssueTracesBlob"},"sourceQuery":{"type":"string","nullable":true},"sourceUrl":{"type":"string","nullable":true}},"required":["raw","analysisMarkdown","logs","traces","sourceQuery","sourceUrl"],"additionalProperties":false}]},"IssueLogsBlob":{"type":"object","nullable":true,"properties":{"version":{"type":"number","enum":[1]},"windowMs":{"type":"number"},"bucketMs":{"type":"number"},"totalCount":{"type":"number"},"severityTotals":{"type":"object","properties":{"ERROR":{"type":"number"},"WARN":{"type":"number"},"INFO":{"type":"number"},"DEBUG":{"type":"number"},"UNKNOWN":{"type":"number"}}},"buckets":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"error":{"type":"number"},"warn":{"type":"number"},"info":{"type":"number"}},"required":["time","error","warn","info"],"additionalProperties":false}},"topTemplates":{"type":"array","items":{"type":"object","properties":{"template":{"type":"string"},"severity":{"type":"string","enum":["ERROR","WARN","INFO","DEBUG","UNKNOWN"]},"count":{"type":"number"},"firstSeenMs":{"type":"number"},"lastSeenMs":{"type":"number"},"sample":{"type":"string"}},"required":["template","severity","count","firstSeenMs","lastSeenMs","sample"],"additionalProperties":false}},"newTemplates":{"type":"array","items":{"type":"object","properties":{"template":{"type":"string"},"severity":{"type":"string","enum":["ERROR","WARN","INFO","DEBUG","UNKNOWN"]},"count":{"type":"number"},"firstSeenMs":{"type":"number"},"lastSeenMs":{"type":"number"},"sample":{"type":"string"}},"required":["template","severity","count","firstSeenMs","lastSeenMs","sample"],"additionalProperties":false}},"contextTemplates":{"type":"array","items":{"type":"object","properties":{"template":{"type":"string"},"severity":{"type":"string","enum":["ERROR","WARN","INFO","DEBUG","UNKNOWN"]},"count":{"type":"number"},"firstSeenMs":{"type":"number"},"lastSeenMs":{"type":"number"},"sample":{"type":"string"}},"required":["template","severity","count","firstSeenMs","lastSeenMs","sample"],"additionalProperties":false}}},"required":["version","windowMs","bucketMs","totalCount","severityTotals","buckets","topTemplates","newTemplates"],"additionalProperties":false},"IssueTracesBlob":{"type":"object","nullable":true,"properties":{"version":{"type":"number","enum":[1]},"resourceContext":{"type":"object","properties":{"kind":{"type":"string","enum":["infra_node","cloud_account","integration","repository"]},"provider":{"type":"string"},"account":{"type":"string"},"region":{"type":"string"},"type":{"type":"string"},"id":{"type":"string"}},"required":["kind","id"],"additionalProperties":false},"digest":{"type":"object","properties":{"source":{"type":"string","enum":["aws.xray","cloudflare.workers-observability"]},"windowMs":{"type":"number"},"bucketMs":{"type":"number"},"totalCount":{"type":"number"},"errorCount":{"type":"number"},"faultCount":{"type":"number"},"throttleCount":{"type":"number"},"errorRate":{"type":"number"},"latency":{"type":"array","items":{"type":"object","properties":{"statistic":{"type":"string","enum":["p50","p90","p95","p99"]},"unit":{"type":"string","enum":["ms"]},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["time","value"]}}},"required":["statistic","unit","points"]}},"counts":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","enum":["ok","errors","faults","throttles","total"]},"points":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["time","value"]}}},"required":["label","points"]}},"operations":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"number"},"errorCount":{"type":"number"},"latencyMsP50":{"type":"number","nullable":true},"latencyMsP95":{"type":"number","nullable":true},"latencyMsP99":{"type":"number","nullable":true}},"required":["name","count","errorCount","latencyMsP50","latencyMsP95","latencyMsP99"]}},"handlers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"number"},"errorCount":{"type":"number"},"latencyMsP50":{"type":"number","nullable":true},"latencyMsP95":{"type":"number","nullable":true},"latencyMsP99":{"type":"number","nullable":true}},"required":["name","count","errorCount","latencyMsP50","latencyMsP95","latencyMsP99"]}},"topErrors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startedAt":{"type":"string","nullable":true},"durationMs":{"type":"number","nullable":true},"outcome":{"type":"string","enum":["ok","error","fault","throttle","unknown"]},"httpStatus":{"type":"number","nullable":true},"errorMessage":{"type":"string","nullable":true},"url":{"type":"string","nullable":true}},"required":["id","startedAt","durationMs","outcome"]}},"topSlow":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startedAt":{"type":"string","nullable":true},"durationMs":{"type":"number","nullable":true},"outcome":{"type":"string","enum":["ok","error","fault","throttle","unknown"]},"httpStatus":{"type":"number","nullable":true},"errorMessage":{"type":"string","nullable":true},"url":{"type":"string","nullable":true}},"required":["id","startedAt","durationMs","outcome"]}}},"required":["source","windowMs","bucketMs","totalCount","errorCount","faultCount","throttleCount","errorRate","latency","counts","operations","handlers","topErrors","topSlow"]},"exemplars":{"type":"array","items":{"type":"object","properties":{"trace":{"type":"object","properties":{"id":{"type":"string"},"startedAt":{"type":"string","nullable":true},"durationMs":{"type":"number","nullable":true},"outcome":{"type":"string","enum":["ok","error","fault","throttle","unknown"]},"httpStatus":{"type":"number","nullable":true},"errorMessage":{"type":"string","nullable":true},"url":{"type":"string","nullable":true}},"required":["id","startedAt","durationMs","outcome"]},"logs":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"number"},"message":{"type":"string"},"level":{"type":"string","nullable":true}},"required":["timestamp","message"]}},"correlation":{"type":"string","enum":["trace-id","time-window"]}},"required":["trace","logs","correlation"]}}},"required":["version","resourceContext","digest"],"additionalProperties":false},"IssueTriageRulesListResult":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/IssueTriageRule"}},"count":{"type":"integer"},"root":{"$ref":"#/components/schemas/IssueTriageRulesRoot"}},"required":["items","count","root"],"additionalProperties":false},"IssueTriageRule":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string","nullable":true},"enabledInProvider":{"type":"boolean"},"triageEnabled":{"type":"boolean"}},"required":["id","name","group","enabledInProvider","triageEnabled"],"additionalProperties":false},"IssueTriageRulesRoot":{"type":"object","properties":{"triageEnabled":{"type":"boolean"}},"required":["triageEnabled"],"additionalProperties":false},"IssueTriagePatchResult":{"type":"object","properties":{"integrationId":{"type":"string"},"scope":{"type":"string","enum":["root","rule"]},"ruleExternalId":{"type":"string","nullable":true},"triageEnabled":{"type":"boolean"}},"required":["integrationId","scope","ruleExternalId","triageEnabled"],"additionalProperties":false},"CheckRun":{"type":"object","properties":{"id":{"type":"string"},"resourceKind":{"type":"string","enum":["infra_node","cloud_account","integration"]},"resourceId":{"type":"string"},"provider":{"type":"string","nullable":true},"account":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"nodeType":{"type":"string","nullable":true},"status":{"type":"string","enum":["healthy","breached","stable"]},"skipReason":{"type":"string","nullable":true,"enum":["no_signal","warmup","cold_start","clean_cache","suppressed_volume","suppressed_sustained",null]},"agentRanAt":{"type":"string","nullable":true,"format":"date-time"},"conclusion":{"type":"string","nullable":true},"contributingCheckIds":{"type":"array","items":{"type":"string"}},"checkCount":{"type":"integer"},"signalCount":{"type":"integer"},"issueId":{"type":"string","nullable":true},"runCount":{"type":"integer","nullable":true},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/CheckRunMetricSummary"}},"executedAt":{"type":"string","format":"date-time"},"metricsComputedAt":{"type":"string","nullable":true,"format":"date-time"}},"required":["id","resourceKind","resourceId","provider","account","region","nodeType","status","skipReason","agentRanAt","conclusion","contributingCheckIds","checkCount","signalCount","issueId","runCount","metrics","executedAt","metricsComputedAt"],"additionalProperties":false},"CheckRunMetricSummary":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string","nullable":true},"calculation":{"type":"string"},"value":{"type":"number","nullable":true},"current":{"type":"number","nullable":true},"min":{"type":"number","nullable":true},"avg":{"type":"number","nullable":true},"max":{"type":"number","nullable":true},"unit":{"type":"string","nullable":true},"chartGroup":{"type":"string","nullable":true}},"required":["id","label","calculation","current","min","avg","max"],"additionalProperties":false},"CheckRunWithSignals":{"allOf":[{"$ref":"#/components/schemas/CheckRunWithMetrics"},{"type":"object","properties":{"logs":{"$ref":"#/components/schemas/IssueLogsBlob"},"traces":{"$ref":"#/components/schemas/IssueTracesBlob"}},"required":["logs","traces"],"additionalProperties":false}]},"CheckRunWithMetrics":{"allOf":[{"$ref":"#/components/schemas/CheckRun"},{"type":"object","properties":{"metrics":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/CheckRunMetricSummary"},{"type":"object","properties":{"query":{"type":"string"},"series":{"type":"array","items":{"type":"object","properties":{"time":{"type":"string"},"value":{"type":"number","nullable":true}},"required":["time","value"],"additionalProperties":false}}},"additionalProperties":false}]}}},"additionalProperties":false}]},"CheckRunTriggerResult":{"type":"object","properties":{"triggered":{"type":"boolean"}},"required":["triggered"],"additionalProperties":false},"AdminCheckRunWithSignals":{"allOf":[{"$ref":"#/components/schemas/CheckRunWithMetrics"},{"type":"object","properties":{"logs":{"$ref":"#/components/schemas/IssueLogsBlob"},"traces":{"$ref":"#/components/schemas/IssueTracesBlob"}},"required":["logs","traces"],"additionalProperties":false}]},"AgentToolSearchResult":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/AgentToolCatalogEntry"}},"count":{"type":"number"},"enums":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["results","count"]},"AgentToolCatalogEntry":{"type":"object","properties":{"name":{"type":"string"},"summary":{"type":"string"},"description":{"type":"string"},"requiredIntegrations":{"type":"array","items":{"type":"string"}},"requiredProviders":{"type":"array","items":{"type":"string"}},"schema":{"type":"object","additionalProperties":{"nullable":true}}},"required":["name","summary","description"]},"AgentToolRunResult":{"type":"object","properties":{"success":{"type":"boolean"},"durationMs":{"type":"number"},"result":{"nullable":true},"error":{"nullable":true}},"required":["success","durationMs"]}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"auth_session"}}},"tags":[],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}]}