{"openapi":"3.1.0","info":{"title":"Faultsnare API","version":"1.0.0"},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"fs_tok_…"}}},"paths":{"/projects":{"get":{"summary":"List projects","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:read","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create a project and its first DSN key","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,58}[a-z0-9]$|^[a-z0-9]$"},"platform":{"type":"string","enum":["browser","node","php"]},"environments":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"allowedOrigins":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":200}},"notInApp":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":200}},"fingerprintRules":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"match":{"type":"object","properties":{"type":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":300},"module":{"type":"string","maxLength":200},"function":{"type":"string","maxLength":200},"level":{"type":"string","maxLength":10}},"additionalProperties":false},"fingerprint":{"type":"string","minLength":1,"maxLength":200}},"required":["match","fingerprint"],"additionalProperties":false}},"scrub":{"default":{"extraKeys":[],"keepUserId":false,"keepFeedbackName":false,"feedbackPerDay":200},"type":"object","properties":{"extraKeys":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":60}},"keepUserId":{"default":false,"type":"boolean"},"keepFeedbackName":{"default":false,"type":"boolean"},"feedbackPerDay":{"default":200,"type":"integer","minimum":1,"maximum":5000}},"required":["extraKeys","keepUserId","keepFeedbackName","feedbackPerDay"],"additionalProperties":false}},"required":["name","platform","environments","allowedOrigins","notInApp","fingerprintRules","scrub"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/projects/{id}":{"get":{"summary":"Retrieve a project","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"patch":{"summary":"Update project settings (origins, environments, scrub, fingerprint rules, compat toggle)","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,58}[a-z0-9]$|^[a-z0-9]$"},"platform":{"type":"string","enum":["browser","node","php"]},"environments":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"allowedOrigins":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":200}},"notInApp":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":200}},"fingerprintRules":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"match":{"type":"object","properties":{"type":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":300},"module":{"type":"string","maxLength":200},"function":{"type":"string","maxLength":200},"level":{"type":"string","maxLength":10}},"additionalProperties":false},"fingerprint":{"type":"string","minLength":1,"maxLength":200}},"required":["match","fingerprint"],"additionalProperties":false}},"scrub":{"default":{"extraKeys":[],"keepUserId":false,"keepFeedbackName":false,"feedbackPerDay":200},"type":"object","properties":{"extraKeys":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","maxLength":60}},"keepUserId":{"default":false,"type":"boolean"},"keepFeedbackName":{"default":false,"type":"boolean"},"feedbackPerDay":{"default":200,"type":"integer","minimum":1,"maximum":5000}},"required":["extraKeys","keepUserId","keepFeedbackName","feedbackPerDay"],"additionalProperties":false},"compatEnvelope":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"delete":{"summary":"Archive a project (it stops accepting events)","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/projects/{id}/keys":{"post":{"summary":"Create a DSN key (the secret of a server key is shown once)","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"label":{"type":"string","maxLength":60},"rateLimitPerMin":{"type":"integer","minimum":1,"maximum":100000}},"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/projects/{id}/keys/{keyId}/rotate":{"post":{"summary":"Rotate a DSN key (the old key works for 7 more days)","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/projects/{id}/keys/{keyId}":{"delete":{"summary":"Revoke a DSN key","tags":["Projects"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/issues":{"get":{"summary":"List issues; q uses the search language (is:unresolved release:4.19.0 level:error)","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"issues:read","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":400}},{"name":"project_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["lastSeen","count","firstSeen"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/issues/{id}":{"get":{"summary":"Retrieve an issue","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"issues:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"patch":{"summary":"Update state, assignee or priority (send the version you read: 409 on conflict)","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"issues:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"state":{"type":"string","enum":["unresolved","resolved","resolved_next_release","ignored","archived"]},"release":{"type":"string","maxLength":120},"ignore":{"type":"object","properties":{"until":{"type":"string","enum":["forever","count","time","users"]},"n":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"at":{"type":"string"}},"required":["until"],"additionalProperties":false},"assigneeId":{"type":["string","null"]},"priority":{"type":"string","enum":["critical","high","normal","low"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"delete":{"summary":"Delete an issue and its events","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"issues:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/issues/{id}/merge":{"post":{"summary":"Merge other issues of the same project into this one","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"issues:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sourceIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string"}}},"required":["sourceIds"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/issues/{id}/events":{"get":{"summary":"List the events of an issue (newest first)","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"events:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/events/{eventId}":{"get":{"summary":"Retrieve one event (scrubbed, de-minified)","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"events:read","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/releases":{"get":{"summary":"List releases with crash-free sessions","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"project:read","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create a release (idempotent)","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"releases:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":120},"projectId":{"type":"string"},"commitsNote":{"type":"string","maxLength":4000}},"required":["version"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/releases/{version}/deploys":{"post":{"summary":"Record a deploy of a release","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"releases:write","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"environment":{"type":"string","minLength":1,"maxLength":60},"projectId":{"type":"string"},"at":{"type":"string"}},"required":["environment"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/releases/{version}/files":{"get":{"summary":"List source-map artifacts of a release","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"project:read","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Upload a source map (multipart: file, name, project_id, dist)","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"releases:write","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"delete":{"summary":"Delete a source-map artifact (query: project_id, name, dist)","tags":["Releases"],"security":[{"bearer":[]}],"x-scope":"releases:write","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"name":"project_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"dist","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/alert-rules":{"get":{"summary":"List alert rules","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create an alert rule (new_issue, regression, spike, frequency)","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","enum":["new_issue","regression","spike","frequency"]},"projectId":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{24}$"},{"type":"null"}]},"conditions":{"default":{"windowMin":5},"type":"object","properties":{"windowMin":{"default":5,"type":"integer","minimum":1,"maximum":1440},"count":{"type":"integer","minimum":1,"maximum":10000000},"multiplier":{"type":"number","minimum":1.5,"maximum":1000},"minCount":{"type":"integer","minimum":1,"maximum":1000000}},"required":["windowMin"],"additionalProperties":false},"filters":{"default":{},"type":"object","properties":{"environment":{"type":"string","maxLength":60},"level":{"type":"string","enum":["fatal","error","warning","info","debug"]},"tag":{"type":"object","properties":{"key":{"type":"string","maxLength":32},"value":{"type":"string","maxLength":200}},"required":["key","value"],"additionalProperties":false}},"additionalProperties":false},"actions":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{24}$"}},"cooldownMin":{"default":30,"type":"integer","minimum":1,"maximum":1440},"status":{"default":"active","type":"string","enum":["active","muted"]}},"required":["name","type","conditions","filters","actions","cooldownMin","status"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/alert-rules/{id}":{"patch":{"summary":"Update an alert rule (send version)","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","enum":["new_issue","regression","spike","frequency"]},"projectId":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{24}$"},{"type":"null"}]},"conditions":{"default":{"windowMin":5},"type":"object","properties":{"windowMin":{"default":5,"type":"integer","minimum":1,"maximum":1440},"count":{"type":"integer","minimum":1,"maximum":10000000},"multiplier":{"type":"number","minimum":1.5,"maximum":1000},"minCount":{"type":"integer","minimum":1,"maximum":1000000}},"required":["windowMin"],"additionalProperties":false},"filters":{"default":{},"type":"object","properties":{"environment":{"type":"string","maxLength":60},"level":{"type":"string","enum":["fatal","error","warning","info","debug"]},"tag":{"type":"object","properties":{"key":{"type":"string","maxLength":32},"value":{"type":"string","maxLength":200}},"required":["key","value"],"additionalProperties":false}},"additionalProperties":false},"actions":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{24}$"}},"cooldownMin":{"default":30,"type":"integer","minimum":1,"maximum":1440},"status":{"default":"active","type":"string","enum":["active","muted"]},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["version"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"delete":{"summary":"Delete an alert rule","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/channels":{"get":{"summary":"List notification channels (targets are never returned)","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create a notification channel (email, webhook, Slack-compatible incoming webhook)","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"simulated"},"label":{"type":"string","minLength":1,"maxLength":80}},"required":["type","label"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"email"},"label":{"type":"string","minLength":1,"maxLength":80},"to":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}}},"required":["type","label","to"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"webhook"},"label":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string","maxLength":500,"format":"uri"},"secret":{"type":"string","maxLength":200}},"required":["type","label","url"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"slack_compatible"},"label":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string","maxLength":500,"format":"uri"}},"required":["type","label","url"],"additionalProperties":false}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/channels/{id}":{"delete":{"summary":"Delete a channel","tags":["Alerts"],"security":[{"bearer":[]}],"x-scope":"project:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/usage":{"get":{"summary":"Event usage and quota for the current month","tags":["Usage"],"security":[{"bearer":[]}],"x-scope":"project:read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":{}}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/feedback":{"get":{"summary":"List user feedback","tags":["Issues"],"security":[{"bearer":[]}],"x-scope":"events:read","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"total":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["total","data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}}}}