{"openapi":"3.0.3","info":{"title":"Elysia Documentation","description":"Development documentation","version":"0.0.0"},"paths":{"/track":{"post":{"tags":["Track"],"description":"Ingest a tracking event (track, identify, group, increment, decrement, replay).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["track"]},"payload":{"type":"object","properties":{"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]}},"required":["name"]}},"required":["type","payload"],"title":"Track"},{"type":"object","properties":{"type":{"type":"string","enum":["identify"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"firstName":{"type":"string","maxLength":256},"lastName":{"type":"string","maxLength":256},"email":{"type":"string","maxLength":320,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatar":{"type":"string","maxLength":2048,"format":"uri"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["profileId"]}},"required":["type","payload"],"title":"Identify"},{"type":"object","properties":{"type":{"type":"string","enum":["increment"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Increment"},{"type":"object","properties":{"type":{"type":"string","enum":["decrement"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Decrement"},{"type":"object","properties":{"type":{"type":"string","enum":["alias"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"alias":{"type":"string","minLength":1}},"required":["profileId","alias"]}},"required":["type","payload"],"title":"Alias"},{"type":"object","properties":{"type":{"type":"string","enum":["replay"]},"payload":{"type":"object","properties":{"chunk_index":{"type":"integer","minimum":0,"maximum":65535},"events_count":{"type":"integer","minimum":1,"maximum":9007199254740991},"is_full_snapshot":{"type":"boolean"},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"ended_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"payload":{"type":"string","maxLength":2097152},"sessionId":{"type":"string","maxLength":64}},"required":["chunk_index","events_count","is_full_snapshot","started_at","ended_at","payload"]}},"required":["type","payload"],"title":"Replay"},{"type":"object","properties":{"type":{"type":"string","enum":["group"]},"payload":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","name"]}},"required":["type","payload"],"title":"Group"},{"type":"object","properties":{"type":{"type":"string","enum":["assign_group"]},"payload":{"type":"object","properties":{"groupIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]}},"required":["groupIds"]}},"required":["type","payload"],"title":"Assign Group"},{"type":"object","properties":{"type":{"type":"string","enum":["ai"]},"payload":{"type":"object","properties":{"kind":{"type":"string","enum":["generation","embedding","span","trace"]},"traceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"spanId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"parentId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"name":{"type":"string","minLength":1,"maxLength":200},"conversationId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"model":{"type":"string","minLength":1,"maxLength":200},"provider":{"type":"string","minLength":1,"maxLength":200},"input":{},"output":{},"tools":{},"usage":{"type":"object","properties":{"inputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"outputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheReadTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheWriteTokens":{"type":"integer","minimum":0,"maximum":4294967295},"reasoningTokens":{"type":"integer","minimum":0,"maximum":4294967295}}},"cost":{"type":"number","minimum":0},"latencyMs":{"type":"number","minimum":0,"maximum":4294967295},"timeToFirstTokenMs":{"type":"number","minimum":0,"maximum":4294967295},"error":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string","maxLength":200},"httpStatus":{"type":"integer","minimum":100,"maximum":599}},"required":["message"]},{"type":"null"}]},"stopReason":{"type":"string","maxLength":200},"stream":{"type":"boolean"},"modelParameters":{"type":"object","properties":{"temperature":{"type":"number"},"maxTokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"topP":{"type":"number"},"topK":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"frequencyPenalty":{"type":"number"},"presencePenalty":{"type":"number"},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stopSequences":{"type":"array","items":{"type":"string"}}},"additionalProperties":{}},"privacyMode":{"type":"boolean"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]},"deviceId":{"type":"string","minLength":1,"maxLength":64},"timestamp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["kind","traceId"]}},"required":["type","payload"],"title":"AI"}]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["track"]},"payload":{"type":"object","properties":{"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]}},"required":["name"]}},"required":["type","payload"],"title":"Track"},{"type":"object","properties":{"type":{"type":"string","enum":["identify"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"firstName":{"type":"string","maxLength":256},"lastName":{"type":"string","maxLength":256},"email":{"type":"string","maxLength":320,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatar":{"type":"string","maxLength":2048,"format":"uri"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["profileId"]}},"required":["type","payload"],"title":"Identify"},{"type":"object","properties":{"type":{"type":"string","enum":["increment"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Increment"},{"type":"object","properties":{"type":{"type":"string","enum":["decrement"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Decrement"},{"type":"object","properties":{"type":{"type":"string","enum":["alias"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"alias":{"type":"string","minLength":1}},"required":["profileId","alias"]}},"required":["type","payload"],"title":"Alias"},{"type":"object","properties":{"type":{"type":"string","enum":["replay"]},"payload":{"type":"object","properties":{"chunk_index":{"type":"integer","minimum":0,"maximum":65535},"events_count":{"type":"integer","minimum":1,"maximum":9007199254740991},"is_full_snapshot":{"type":"boolean"},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"ended_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"payload":{"type":"string","maxLength":2097152},"sessionId":{"type":"string","maxLength":64}},"required":["chunk_index","events_count","is_full_snapshot","started_at","ended_at","payload"]}},"required":["type","payload"],"title":"Replay"},{"type":"object","properties":{"type":{"type":"string","enum":["group"]},"payload":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","name"]}},"required":["type","payload"],"title":"Group"},{"type":"object","properties":{"type":{"type":"string","enum":["assign_group"]},"payload":{"type":"object","properties":{"groupIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]}},"required":["groupIds"]}},"required":["type","payload"],"title":"Assign Group"},{"type":"object","properties":{"type":{"type":"string","enum":["ai"]},"payload":{"type":"object","properties":{"kind":{"type":"string","enum":["generation","embedding","span","trace"]},"traceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"spanId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"parentId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"name":{"type":"string","minLength":1,"maxLength":200},"conversationId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"model":{"type":"string","minLength":1,"maxLength":200},"provider":{"type":"string","minLength":1,"maxLength":200},"input":{},"output":{},"tools":{},"usage":{"type":"object","properties":{"inputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"outputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheReadTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheWriteTokens":{"type":"integer","minimum":0,"maximum":4294967295},"reasoningTokens":{"type":"integer","minimum":0,"maximum":4294967295}}},"cost":{"type":"number","minimum":0},"latencyMs":{"type":"number","minimum":0,"maximum":4294967295},"timeToFirstTokenMs":{"type":"number","minimum":0,"maximum":4294967295},"error":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string","maxLength":200},"httpStatus":{"type":"integer","minimum":100,"maximum":599}},"required":["message"]},{"type":"null"}]},"stopReason":{"type":"string","maxLength":200},"stream":{"type":"boolean"},"modelParameters":{"type":"object","properties":{"temperature":{"type":"number"},"maxTokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"topP":{"type":"number"},"topK":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"frequencyPenalty":{"type":"number"},"presencePenalty":{"type":"number"},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stopSequences":{"type":"array","items":{"type":"string"}}},"additionalProperties":{}},"privacyMode":{"type":"boolean"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]},"deviceId":{"type":"string","minLength":1,"maxLength":64},"timestamp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["kind","traceId"]}},"required":["type","payload"],"title":"AI"}]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["track"]},"payload":{"type":"object","properties":{"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]}},"required":["name"]}},"required":["type","payload"],"title":"Track"},{"type":"object","properties":{"type":{"type":"string","enum":["identify"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"firstName":{"type":"string","maxLength":256},"lastName":{"type":"string","maxLength":256},"email":{"type":"string","maxLength":320,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatar":{"type":"string","maxLength":2048,"format":"uri"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["profileId"]}},"required":["type","payload"],"title":"Identify"},{"type":"object","properties":{"type":{"type":"string","enum":["increment"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Increment"},{"type":"object","properties":{"type":{"type":"string","enum":["decrement"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number","exclusiveMinimum":0}},"required":["profileId","property"]}},"required":["type","payload"],"title":"Decrement"},{"type":"object","properties":{"type":{"type":"string","enum":["alias"]},"payload":{"type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"alias":{"type":"string","minLength":1}},"required":["profileId","alias"]}},"required":["type","payload"],"title":"Alias"},{"type":"object","properties":{"type":{"type":"string","enum":["replay"]},"payload":{"type":"object","properties":{"chunk_index":{"type":"integer","minimum":0,"maximum":65535},"events_count":{"type":"integer","minimum":1,"maximum":9007199254740991},"is_full_snapshot":{"type":"boolean"},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"ended_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"payload":{"type":"string","maxLength":2097152},"sessionId":{"type":"string","maxLength":64}},"required":["chunk_index","events_count","is_full_snapshot","started_at","ended_at","payload"]}},"required":["type","payload"],"title":"Replay"},{"type":"object","properties":{"type":{"type":"string","enum":["group"]},"payload":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","name"]}},"required":["type","payload"],"title":"Group"},{"type":"object","properties":{"type":{"type":"string","enum":["assign_group"]},"payload":{"type":"object","properties":{"groupIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]}},"required":["groupIds"]}},"required":["type","payload"],"title":"Assign Group"},{"type":"object","properties":{"type":{"type":"string","enum":["ai"]},"payload":{"type":"object","properties":{"kind":{"type":"string","enum":["generation","embedding","span","trace"]},"traceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"spanId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"parentId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"name":{"type":"string","minLength":1,"maxLength":200},"conversationId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9._:@()!'|~-]+$"},"model":{"type":"string","minLength":1,"maxLength":200},"provider":{"type":"string","minLength":1,"maxLength":200},"input":{},"output":{},"tools":{},"usage":{"type":"object","properties":{"inputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"outputTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheReadTokens":{"type":"integer","minimum":0,"maximum":4294967295},"cacheWriteTokens":{"type":"integer","minimum":0,"maximum":4294967295},"reasoningTokens":{"type":"integer","minimum":0,"maximum":4294967295}}},"cost":{"type":"number","minimum":0},"latencyMs":{"type":"number","minimum":0,"maximum":4294967295},"timeToFirstTokenMs":{"type":"number","minimum":0,"maximum":4294967295},"error":{"anyOf":[{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string","maxLength":200},"httpStatus":{"type":"integer","minimum":100,"maximum":599}},"required":["message"]},{"type":"null"}]},"stopReason":{"type":"string","maxLength":200},"stream":{"type":"boolean"},"modelParameters":{"type":"object","properties":{"temperature":{"type":"number"},"maxTokens":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"topP":{"type":"number"},"topK":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"frequencyPenalty":{"type":"number"},"presencePenalty":{"type":"number"},"seed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stopSequences":{"type":"array","items":{"type":"string"}}},"additionalProperties":{}},"privacyMode":{"type":"boolean"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"groups":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},{"type":"null"}]},"deviceId":{"type":"string","minLength":1,"maxLength":64},"timestamp":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["kind","traceId"]}},"required":["type","payload"],"title":"AI"}]}}}},"operationId":"postTrack"}},"/track/device-id":{"get":{"tags":["Track"],"description":"Get or generate a stable device ID and session ID for the current visitor.","operationId":"getTrackDevice-id"}},"/event":{"post":{"tags":["Event"],"description":"Deprecated direct event ingestion endpoint. Use /track instead.","operationId":"postEvent"}},"/import/events":{"post":{"tags":["Import"],"description":"Bulk import historical events.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{}}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{}}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"array","items":{}}}}},"operationId":"postImportEvents"}},"/manage/projects":{"get":{"tags":["Manage"],"operationId":"getManageProjects"},"post":{"tags":["Manage"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"default":[],"type":"array","items":{"type":"string"}},"crossDomain":{"default":false,"type":"boolean"},"types":{"default":[],"type":"array","items":{"type":"string","enum":["website","app","backend"]}}},"required":["name"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"default":[],"type":"array","items":{"type":"string"}},"crossDomain":{"default":false,"type":"boolean"},"types":{"default":[],"type":"array","items":{"type":"string","enum":["website","app","backend"]}}},"required":["name"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"default":[],"type":"array","items":{"type":"string"}},"crossDomain":{"default":false,"type":"boolean"},"types":{"default":[],"type":"array","items":{"type":"string","enum":["website","app","backend"]}}},"required":["name"]}}}},"operationId":"postManageProjects"}},"/manage/projects/{id}":{"get":{"tags":["Manage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getManageProjectsById"},"patch":{"tags":["Manage"],"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},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"type":"array","items":{"type":"string"}},"crossDomain":{"type":"boolean"},"allowUnsafeRevenueTracking":{"type":"boolean"},"aiStoreContent":{"type":"boolean"}}}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"type":"array","items":{"type":"string"}},"crossDomain":{"type":"boolean"},"allowUnsafeRevenueTracking":{"type":"boolean"},"aiStoreContent":{"type":"boolean"}}}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"anyOf":[{"anyOf":[{"type":"string","format":"uri"},{"type":"string","const":""}]},{"type":"null"}]},"cors":{"type":"array","items":{"type":"string"}},"crossDomain":{"type":"boolean"},"allowUnsafeRevenueTracking":{"type":"boolean"},"aiStoreContent":{"type":"boolean"}}}}}},"operationId":"patchManageProjectsById"},"delete":{"tags":["Manage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"deleteManageProjectsById"}},"/manage/clients":{"get":{"tags":["Manage"],"parameters":[{"name":"projectId","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getManageClients"},"post":{"tags":["Manage"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"projectId":{"type":"string"},"type":{"default":"write","type":"string","enum":["read","write","root"]}},"required":["name"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"projectId":{"type":"string"},"type":{"default":"write","type":"string","enum":["read","write","root"]}},"required":["name"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"projectId":{"type":"string"},"type":{"default":"write","type":"string","enum":["read","write","root"]}},"required":["name"]}}}},"operationId":"postManageClients"}},"/manage/clients/{id}":{"get":{"tags":["Manage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getManageClientsById"},"patch":{"tags":["Manage"],"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}}}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1}}}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1}}}}}},"operationId":"patchManageClientsById"},"delete":{"tags":["Manage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"deleteManageClientsById"}},"/manage/references":{"get":{"tags":["Manage"],"description":"List annotation references for a project.","parameters":[{"name":"projectId","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getManageReferences"},"post":{"tags":["Manage"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string"},"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}},"required":["projectId","title","datetime"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string"},"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}},"required":["projectId","title","datetime"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string"},"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}},"required":["projectId","title","datetime"]}}}},"operationId":"postManageReferences"}},"/manage/references/{id}":{"get":{"tags":["Manage"],"description":"Get a single annotation reference by ID.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getManageReferencesById"},"patch":{"tags":["Manage"],"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":{"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}}}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}}}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1},"description":{"type":"string"},"datetime":{"type":"string"}}}}}},"operationId":"patchManageReferencesById"},"delete":{"tags":["Manage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"deleteManageReferencesById"}},"/manage/projects/{id}/dashboards":{"get":{"tags":["Manage"],"description":"List all dashboards for a project.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getManageProjectsByIdDashboards"}},"/manage/projects/{id}/dashboards/{dashboardId}/reports":{"get":{"tags":["Manage"],"description":"List all reports in a dashboard.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getManageProjectsByIdDashboardsByDashboardIdReports"}},"/profile":{"post":{"tags":["Profile"],"description":"Identify or update a user profile.","operationId":"postProfile"}},"/profile/increment":{"post":{"tags":["Profile"],"description":"Increment a numeric property on a user profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}}}},"operationId":"postProfileIncrement"}},"/profile/decrement":{"post":{"tags":["Profile"],"description":"Decrement a numeric property on a user profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profileId":{"anyOf":[{"type":"string","minLength":1},{"type":"number"}]},"property":{"type":"string","minLength":1},"value":{"type":"number"}},"required":["profileId","property","value"]}}}},"operationId":"postProfileDecrement"}},"/export/events":{"get":{"tags":["Export"],"description":"Export a paginated list of raw events with optional filtering by date, profile, and event type.","parameters":[{"name":"project_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string"}},{"name":"profileId","in":"query","required":false,"schema":{"type":"string"}},{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},{"name":"start","in":"query","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"number"}},{"name":"filters","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"includes","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"operationId":"getExportEvents"}},"/export/charts":{"get":{"tags":["Export"],"description":"Export aggregated chart/analytics data for a series of events over a time range.","parameters":[{"name":"breakdowns","in":"query","required":false,"schema":{"default":[],"description":"Array of dimensions to break down the data by","type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"step":{"description":"Funnel only: 1-based step whose event the value is read from. Defaults to the first step.","type":"integer","minimum":1,"maximum":9007199254740991}},"required":["name"]}}},{"name":"interval","in":"query","required":false,"schema":{"default":"day","description":"The time interval for data aggregation (e.g., day, week, month)","type":"string","enum":["minute","day","hour","week","month"]}},{"name":"range","in":"query","required":false,"schema":{"default":"30d","description":"The time range for which data should be displayed","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"previous","in":"query","required":false,"schema":{"default":false,"description":"Whether to show data from the previous period for comparison","type":"boolean"}},{"name":"startDate","in":"query","required":false,"schema":{"description":"Custom start date for the data range (overrides range if provided)","anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"description":"Custom end date for the data range (overrides range if provided)","anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"project_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"filters":{"default":[],"description":"Filters applied specifically to this event","type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}},"segment":{"default":"event","description":"Defines how the event data should be segmented or aggregated","type":"string","enum":["event","user","session","group","user_average","one_event_per_user","property_sum","property_average","property_max","property_min","property_p50","property_p95","property_p99"]},"property":{"description":"Optional property of the event used for specific segment calculations (e.g., value for property_sum/average)","type":"string"}},"required":["name"]}}},{"name":"events","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"filters":{"default":[],"description":"Filters applied specifically to this event","type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}},"segment":{"default":"event","description":"Defines how the event data should be segmented or aggregated","type":"string","enum":["event","user","session","group","user_average","one_event_per_user","property_sum","property_average","property_max","property_min","property_p50","property_p95","property_p99"]},"property":{"description":"Optional property of the event used for specific segment calculations (e.g., value for property_sum/average)","type":"string"}},"required":["name"]}}}],"operationId":"getExportCharts"}},"/insights/{projectId}/overview":{"get":{"tags":["Insights"],"description":"Get an overview of key metrics for the project (sessions, pageviews, bounce rate, duration).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["hour","day","week","month"]}}],"operationId":"getInsightsByProjectIdOverview"}},"/insights/{projectId}/active_users":{"get":{"tags":["Insights"],"description":"Get rolling active user counts over the last N days.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"default":7,"type":"integer","minimum":1,"maximum":90}}],"operationId":"getInsightsByProjectIdActive_users"}},"/insights/{projectId}/retention":{"get":{"tags":["Insights"],"description":"Get weekly retention series data within the date range (default `3m`).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}}],"operationId":"getInsightsByProjectIdRetention"}},"/insights/{projectId}/retention/cohort":{"get":{"tags":["Insights"],"description":"Get retention cohort data.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdRetentionCohort"}},"/insights/{projectId}/pages/top":{"get":{"tags":["Insights"],"description":"Get the top pages by pageviews for the given date range.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}}],"operationId":"getInsightsByProjectIdPagesTop"}},"/insights/{projectId}/pages/entry_exit":{"get":{"tags":["Insights"],"description":"Get entry or exit pages ranked by session count.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"mode","in":"query","required":false,"schema":{"default":"entry","type":"string","enum":["entry","exit"]}}],"operationId":"getInsightsByProjectIdPagesEntry_exit"}},"/insights/{projectId}/pages/performance":{"get":{"tags":["Insights"],"description":"Get page-level performance metrics (bounce rate, avg duration, sessions).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["sessions","pageviews","bounce_rate","avg_duration"]}},{"name":"sortOrder","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":500}}],"operationId":"getInsightsByProjectIdPagesPerformance"}},"/insights/{projectId}/metrics":{"get":{"tags":["Insights"],"description":"Get aggregated website metrics including sessions, pageviews, and bounce rate.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}}],"operationId":"getInsightsByProjectIdMetrics"}},"/insights/{projectId}/live":{"get":{"tags":["Insights"],"description":"Get the current number of live (active) visitors.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdLive"}},"/insights/{projectId}/pages":{"get":{"tags":["Insights"],"description":"Get top pages with pageview counts for the selected date range.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdPages"}},"/insights/{projectId}/referrer":{"get":{"tags":["Insights"],"description":"Get top values for the \"referrer\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdReferrer"}},"/insights/{projectId}/referrer_name":{"get":{"tags":["Insights"],"description":"Get top values for the \"referrer_name\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdReferrer_name"}},"/insights/{projectId}/referrer_type":{"get":{"tags":["Insights"],"description":"Get top values for the \"referrer_type\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdReferrer_type"}},"/insights/{projectId}/utm_source":{"get":{"tags":["Insights"],"description":"Get top values for the \"utm_source\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdUtm_source"}},"/insights/{projectId}/utm_medium":{"get":{"tags":["Insights"],"description":"Get top values for the \"utm_medium\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdUtm_medium"}},"/insights/{projectId}/utm_campaign":{"get":{"tags":["Insights"],"description":"Get top values for the \"utm_campaign\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdUtm_campaign"}},"/insights/{projectId}/utm_term":{"get":{"tags":["Insights"],"description":"Get top values for the \"utm_term\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdUtm_term"}},"/insights/{projectId}/utm_content":{"get":{"tags":["Insights"],"description":"Get top values for the \"utm_content\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdUtm_content"}},"/insights/{projectId}/region":{"get":{"tags":["Insights"],"description":"Get top values for the \"region\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdRegion"}},"/insights/{projectId}/country":{"get":{"tags":["Insights"],"description":"Get top values for the \"country\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdCountry"}},"/insights/{projectId}/city":{"get":{"tags":["Insights"],"description":"Get top values for the \"city\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdCity"}},"/insights/{projectId}/device":{"get":{"tags":["Insights"],"description":"Get top values for the \"device\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdDevice"}},"/insights/{projectId}/brand":{"get":{"tags":["Insights"],"description":"Get top values for the \"brand\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdBrand"}},"/insights/{projectId}/model":{"get":{"tags":["Insights"],"description":"Get top values for the \"model\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdModel"}},"/insights/{projectId}/browser":{"get":{"tags":["Insights"],"description":"Get top values for the \"browser\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdBrowser"}},"/insights/{projectId}/browser_version":{"get":{"tags":["Insights"],"description":"Get top values for the \"browser_version\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdBrowser_version"}},"/insights/{projectId}/os":{"get":{"tags":["Insights"],"description":"Get top values for the \"os\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdOs"}},"/insights/{projectId}/os_version":{"get":{"tags":["Insights"],"description":"Get top values for the \"os_version\" dimension.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"startDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"endDate","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}]}},{"name":"range","in":"query","required":false,"schema":{"default":"7d","type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"schema":{"default":10,"type":"number"}}],"operationId":"getInsightsByProjectIdOs_version"}},"/insights/{projectId}/funnel":{"get":{"tags":["Insights"],"description":"Get funnel conversion rates for a sequence of events.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"steps","in":"query","required":true,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]}},{"name":"windowHours","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":720}},{"name":"groupBy","in":"query","required":false,"schema":{"default":"session_id","type":"string","enum":["session_id","profile_id"]}}],"operationId":"getInsightsByProjectIdFunnel"}},"/insights/{projectId}/traffic/referrers":{"get":{"tags":["Insights"],"description":"Get traffic breakdown by referrer source.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"breakdown","in":"query","required":false,"schema":{"default":"referrer_name","type":"string","enum":["referrer_name","referrer_type","referrer","utm_source","utm_medium","utm_campaign"]}}],"operationId":"getInsightsByProjectIdTrafficReferrers"}},"/insights/{projectId}/traffic/geo":{"get":{"tags":["Insights"],"description":"Get traffic breakdown by geographic dimension (country, region, city).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"breakdown","in":"query","required":false,"schema":{"default":"country","type":"string","enum":["country","region","city"]}}],"operationId":"getInsightsByProjectIdTrafficGeo"}},"/insights/{projectId}/traffic/devices":{"get":{"tags":["Insights"],"description":"Get traffic breakdown by device type, browser, or OS.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"breakdown","in":"query","required":false,"schema":{"default":"device","type":"string","enum":["device","browser","os"]}}],"operationId":"getInsightsByProjectIdTrafficDevices"}},"/insights/{projectId}/user_flow":{"get":{"tags":["Insights"],"description":"Get user flow paths before, after, or between specified events.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"startEvent","in":"query","required":true,"schema":{"type":"string"}},{"name":"endEvent","in":"query","required":false,"schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"schema":{"default":"after","type":"string","enum":["after","before","between"]}},{"name":"steps","in":"query","required":false,"schema":{"default":5,"type":"integer","minimum":2,"maximum":10}},{"name":"exclude","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]}}],"operationId":"getInsightsByProjectIdUser_flow"}},"/insights/{projectId}/engagement":{"get":{"tags":["Insights"],"description":"Get engagement metrics for profiles seen within the date range (default `3m`).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}}],"operationId":"getInsightsByProjectIdEngagement"}},"/insights/{projectId}/events":{"get":{"tags":["Insights"],"description":"Query events with optional filters for date range, profile, and properties.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"eventNames","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]}},{"name":"path","in":"query","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"device","in":"query","required":false,"schema":{"type":"string"}},{"name":"browser","in":"query","required":false,"schema":{"type":"string"}},{"name":"os","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrer","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrerName","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrerType","in":"query","required":false,"schema":{"type":"string"}},{"name":"profileId","in":"query","required":false,"schema":{"type":"string"}},{"name":"properties","in":"query","required":false,"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},{"name":"filters","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdEvents"}},"/insights/{projectId}/events/names":{"get":{"tags":["Insights"],"description":"List all distinct event names tracked in the project.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdEventsNames"}},"/insights/{projectId}/events/properties":{"get":{"tags":["Insights"],"description":"List all property keys for a given event name.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"eventName","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdEventsProperties"}},"/insights/{projectId}/events/property_values":{"get":{"tags":["Insights"],"description":"Get the top values for a specific event property key.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"eventName","in":"query","required":true,"schema":{"type":"string"}},{"name":"propertyKey","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdEventsProperty_values"}},"/insights/{projectId}/profiles":{"get":{"tags":["Insights"],"description":"Search and filter user profiles.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"email","in":"query","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"device","in":"query","required":false,"schema":{"type":"string"}},{"name":"browser","in":"query","required":false,"schema":{"type":"string"}},{"name":"inactiveDays","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"minSessions","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"performedEvent","in":"query","required":false,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"sortOrder","in":"query","required":false,"schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdProfiles"}},"/insights/{projectId}/profiles/{profileId}":{"get":{"tags":["Insights"],"description":"Get a single user profile with their recent events.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"profileId","in":"path","required":true,"schema":{"type":"string"}},{"name":"eventLimit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdProfilesByProfileId"}},"/insights/{projectId}/profiles/{profileId}/sessions":{"get":{"tags":["Insights"],"description":"Get sessions for a specific user profile.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"profileId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdProfilesByProfileIdSessions"}},"/insights/{projectId}/profiles/{profileId}/metrics":{"get":{"tags":["Insights"],"description":"Get aggregated metrics for a specific user profile.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"profileId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdProfilesByProfileIdMetrics"}},"/insights/{projectId}/sessions":{"get":{"tags":["Insights"],"description":"Query sessions with optional filters.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"device","in":"query","required":false,"schema":{"type":"string"}},{"name":"browser","in":"query","required":false,"schema":{"type":"string"}},{"name":"os","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrer","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrerName","in":"query","required":false,"schema":{"type":"string"}},{"name":"referrerType","in":"query","required":false,"schema":{"type":"string"}},{"name":"profileId","in":"query","required":false,"schema":{"type":"string"}},{"name":"filters","in":"query","required":false,"schema":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Unique identifier for the filter","type":"string"},"name":{"type":"string","description":"The property name to filter on"},"operator":{"type":"string","enum":["is","isNot","contains","doesNotContain","startsWith","endsWith","regex","isNull","isNotNull","gt","lt","gte","lte","inCohort","notInCohort"],"description":"The operator to use for the filter"},"value":{"type":"array","items":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"}]},{"type":"boolean"}]},{"type":"null"}]},"description":"The values to filter on"},"type":{"description":"Cast type for the column/value in equality & comparison operators (string/number/date/datetime/boolean). Absent = legacy behavior.","type":"string","enum":["string","number","date","datetime","boolean"]},"cohortId":{"description":"DEPRECATED: legacy single-cohort id, kept for saved reports. New code reads cohortIds via getCohortIds(filter).","type":"string"},"cohortIds":{"description":"Cohort IDs for inCohort/notInCohort. Multiple ids OR-match (matches profiles in any of the listed cohorts).","type":"array","items":{"type":"string"}}},"required":["name","operator","value"]}}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdSessions"}},"/insights/{projectId}/groups/types":{"get":{"tags":["Insights"],"description":"List all group types defined in the project.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdGroupsTypes"}},"/insights/{projectId}/groups":{"get":{"tags":["Insights"],"description":"Search and filter groups.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"getInsightsByProjectIdGroups"}},"/insights/{projectId}/groups/{groupId}":{"get":{"tags":["Insights"],"description":"Get a single group with its members.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberLimit","in":"query","required":false,"schema":{"default":10,"type":"integer","minimum":1,"maximum":50}}],"operationId":"getInsightsByProjectIdGroupsByGroupId"}},"/insights/{projectId}/reports/{reportId}/data":{"get":{"tags":["Insights"],"description":"Get the data for a saved report.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"reportId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdReportsByReportIdData"}},"/insights/{projectId}/gsc/overview":{"get":{"tags":["Insights"],"description":"Get a Google Search Console performance overview (clicks, impressions, CTR, position).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"interval","in":"query","required":false,"schema":{"default":"day","type":"string","enum":["day","week","month"]}}],"operationId":"getInsightsByProjectIdGscOverview"}},"/insights/{projectId}/gsc/pages":{"get":{"tags":["Insights"],"description":"Get top pages from Google Search Console.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":1000}}],"operationId":"getInsightsByProjectIdGscPages"}},"/insights/{projectId}/gsc/pages/details":{"get":{"tags":["Insights"],"description":"Get detailed GSC metrics for a specific page URL.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"page","in":"query","required":true,"schema":{"type":"string","format":"uri"}}],"operationId":"getInsightsByProjectIdGscPagesDetails"}},"/insights/{projectId}/gsc/queries":{"get":{"tags":["Insights"],"description":"Get top search queries from Google Search Console.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":1000}}],"operationId":"getInsightsByProjectIdGscQueries"}},"/insights/{projectId}/gsc/queries/details":{"get":{"tags":["Insights"],"description":"Get detailed GSC metrics for a specific search query.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"query","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"getInsightsByProjectIdGscQueriesDetails"}},"/insights/{projectId}/gsc/queries/opportunities":{"get":{"tags":["Insights"],"description":"Get GSC query opportunities (high impressions, low CTR).","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}},{"name":"minImpressions","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":9007199254740991}}],"operationId":"getInsightsByProjectIdGscQueriesOpportunities"}},"/insights/{projectId}/gsc/cannibalization":{"get":{"tags":["Insights"],"description":"Detect keyword cannibalization across pages in Google Search Console.","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["30min","lastHour","last24h","today","yesterday","7d","30d","3m","6m","12m","monthToDate","lastMonth","yearToDate","lastYear","custom"]}}],"operationId":"getInsightsByProjectIdGscCannibalization"}},"/mcp":{"get":{"operationId":"getMcp"},"delete":{"operationId":"deleteMcp"},"post":{"operationId":"postMcp"}},"/webhook/polar":{"post":{"operationId":"postWebhookPolar"}},"/live/visitors/{projectId}":{"ws":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}},{"name":"shareId","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"wsLiveVisitorsByProjectId"}},"/live/events/{projectId}":{"ws":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"wsLiveEventsByProjectId"}},"/live/notifications/{projectId}":{"ws":{"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"wsLiveNotificationsByProjectId"}},"/live/organization/{organizationId}":{"ws":{"parameters":[{"name":"organizationId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"wsLiveOrganizationByOrganizationId"}},"/misc/ping":{"post":{"tags":["Misc"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"domain":{"type":"string"},"count":{"type":"number"}},"required":["domain","count"]}},"application/x-www-form-urlencoded":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"domain":{"type":"string"},"count":{"type":"number"}},"required":["domain","count"]}},"multipart/form-data":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"domain":{"type":"string"},"count":{"type":"number"}},"required":["domain","count"]}}}},"operationId":"postMiscPing"}},"/misc/stats":{"get":{"tags":["Misc"],"operationId":"getMiscStats"}},"/misc/favicon":{"get":{"tags":["Misc"],"parameters":[{"name":"url","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getMiscFavicon"}},"/misc/geo":{"get":{"tags":["Misc"],"operationId":"getMiscGeo"}},"/trpc/*":{"get":{"operationId":"allTrpc*"},"post":{"operationId":"allTrpc*"},"put":{"operationId":"allTrpc*"},"delete":{"operationId":"allTrpc*"},"patch":{"operationId":"allTrpc*"},"head":{"operationId":"allTrpc*"},"options":{"operationId":"allTrpc*"},"trace":{"operationId":"allTrpc*"}}},"components":{"schemas":{}}}