{"openapi":"3.1.0","info":{"title":"PureStats Analytics API","version":"1.0.0"},"paths":{"/api/v1/management/actions/analytics.overview":{"get":{"operationId":"analytics.overview","tags":["analytics"],"summary":"Analytics overview","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.realtime":{"get":{"operationId":"analytics.realtime","tags":["analytics"],"summary":"Analytics realtime","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"since","required":false,"schema":{"type":["string","null"]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.retention":{"get":{"operationId":"analytics.retention","tags":["analytics"],"summary":"Analytics retention","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.vitals":{"get":{"operationId":"analytics.vitals","tags":["analytics"],"summary":"Analytics vitals","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.events":{"get":{"operationId":"analytics.events","tags":["analytics"],"summary":"Analytics events","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"event","required":false,"schema":{"type":["string","null"],"maxLength":255}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.campaigns":{"get":{"operationId":"analytics.campaigns","tags":["analytics"],"summary":"Analytics campaigns","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.commerce":{"get":{"operationId":"analytics.commerce","tags":["analytics"],"summary":"Analytics commerce","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.experiments":{"get":{"operationId":"analytics.experiments","tags":["analytics"],"summary":"Analytics experiments","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.site_search":{"get":{"operationId":"analytics.site_search","tags":["analytics"],"summary":"Analytics site_search","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.funnels":{"get":{"operationId":"analytics.funnels","tags":["analytics"],"summary":"Analytics funnels","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"funnel","required":false,"schema":{"type":["string","null"],"maxLength":191}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.funnels.advanced":{"get":{"operationId":"analytics.funnels.advanced","tags":["analytics"],"summary":"Analytics funnels advanced","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"funnel","required":false,"schema":{"type":["string","null"],"maxLength":191}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.journeys":{"get":{"operationId":"analytics.journeys","tags":["analytics"],"summary":"Analytics journeys","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"funnel","required":false,"schema":{"type":["string","null"],"maxLength":191}},{"in":"query","name":"start","required":false,"schema":{"type":["string","null"],"maxLength":2048}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.chart":{"get":{"operationId":"analytics.chart","tags":["analytics"],"summary":"Analytics chart","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"interval","required":false,"schema":{"type":["string","null"],"enum":["minute","hour","day","week","month",null]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.filter_options":{"get":{"operationId":"analytics.filter_options","tags":["analytics"],"summary":"Analytics filter_options","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"field","required":true,"schema":{"type":"string","maxLength":96}},{"in":"query","name":"q","required":false,"schema":{"type":["string","null"],"maxLength":255}},{"in":"query","name":"search","required":false,"schema":{"type":["string","null"],"maxLength":255}},{"in":"query","name":"limit","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":100}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.seo":{"get":{"operationId":"analytics.seo","tags":["analytics"],"summary":"Analytics seo","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"provider","required":false,"schema":{"type":["string","null"],"enum":["all","google","bing",null]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.explore":{"get":{"operationId":"analytics.explore","tags":["analytics"],"summary":"Analytics explore","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"metric","required":false,"schema":{"type":["string","null"],"enum":["pageviews","visitors","sessions","events","revenue",null]}},{"in":"query","name":"dimension","required":false,"schema":{"type":["string","null"],"maxLength":96}},{"in":"query","name":"saved","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.campaigns.chart":{"get":{"operationId":"analytics.campaigns.chart","tags":["analytics"],"summary":"Analytics campaigns chart","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"interval","required":false,"schema":{"type":["string","null"],"enum":["hour","day","week","month",null]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.actions":{"get":{"operationId":"analytics.actions","tags":["analytics"],"summary":"Analytics actions","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.actions.save":{"post":{"operationId":"analytics.actions.save","tags":["analytics"],"summary":"Analytics actions save","description":"Requires sites:write. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}}],"x-required-scopes":["sites:write"],"x-site-role":"manager","x-risk":"write","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentInput76d813063a1f6bdaa30b"}}}}}},"/api/v1/management/actions/analytics.actions.delete":{"post":{"operationId":"analytics.actions.delete","tags":["analytics"],"summary":"Analytics actions delete","description":"Requires sites:write. Payload-bound human approval is required.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}},{"in":"header","name":"X-Agent-Approval-ID","schema":{"type":"string"}}],"x-required-scopes":["sites:write"],"x-site-role":"manager","x-risk":"destructive","x-interactive":false,"x-human-approval-required":true,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["id","site_id"]}}}}}},"/api/v1/management/actions/analytics.navigation":{"post":{"operationId":"analytics.navigation","tags":["analytics"],"summary":"Analytics navigation","description":"Requires account:write. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}}],"x-required-scopes":["account:write"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tabs":{"type":"array","items":{"type":"string","enum":["/seo","/retention","/performance","/experiments","/commerce","/explore","/site-search","/replays","/actions"]},"maxItems":5}},"additionalProperties":false,"required":["tabs"]}}}}}},"/api/v1/management/actions/analytics.consolidated":{"get":{"operationId":"analytics.consolidated","tags":["analytics"],"summary":"Analytics consolidated","description":"Requires analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"enum":["today","7d","30d","90d",null]}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}}],"x-required-scopes":["analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/analytics.consolidated.settings":{"post":{"operationId":"analytics.consolidated.settings","tags":["analytics"],"summary":"Analytics consolidated settings","description":"Requires dashboards:write. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}}],"x-required-scopes":["dashboards:write"],"x-site-role":"manager","x-risk":"write","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":160},"timezone":{"type":"string"},"traffic":{"type":"string","enum":["human","all","bot","ai","spam","suspicious"]}},"additionalProperties":false,"required":["name","timezone","traffic"]}}}}}},"/api/v1/management/actions/visitors.list":{"get":{"operationId":"visitors.list","tags":["visitors"],"summary":"Visitors list","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"page","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":100000}},{"in":"query","name":"per_page","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":100}},{"in":"query","name":"type","required":true,"schema":{"type":"string","enum":["source","channel","page","entry","exit","country","region","city","device","browser","os"]}},{"in":"query","name":"value","required":false,"schema":{"type":["string","null"],"maxLength":255}},{"in":"query","name":"country","required":false,"schema":{"type":["string","null"],"minLength":2,"maxLength":2}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/visitors.get":{"get":{"operationId":"visitors.get","tags":["visitors"],"summary":"Visitors get","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"session_id","required":true,"schema":{"type":"integer","minimum":1}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/visitors.pageviews":{"get":{"operationId":"visitors.pageviews","tags":["visitors"],"summary":"Visitors pageviews","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":100000}},{"in":"query","name":"session_id","required":true,"schema":{"type":"integer","minimum":1}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/visitors.realtime":{"get":{"operationId":"visitors.realtime","tags":["visitors"],"summary":"Visitors realtime","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"since","required":false,"schema":{"type":["string","null"]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/visitors.events":{"get":{"operationId":"visitors.events","tags":["visitors"],"summary":"Visitors events","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"event","required":false,"schema":{"type":["string","null"],"maxLength":255}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/commerce.orders":{"get":{"operationId":"commerce.orders","tags":["commerce"],"summary":"Commerce orders","description":"Requires visitors:read, analytics:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"period","required":false,"schema":{"type":["string","null"],"maxLength":32}},{"in":"query","name":"from","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"to","required":false,"schema":{"type":["string","null"],"format":"date"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"filters","required":false,"schema":{"type":["object","null"],"additionalProperties":true}},{"in":"query","name":"compare","required":false,"schema":{"type":["string","null"],"enum":["none","previous_period","year_over_year",null]}},{"in":"query","name":"segment","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"dashboard","required":false,"schema":{"type":["string","null"],"format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["visitors:read","analytics:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/experiments.list":{"get":{"operationId":"experiments.list","tags":["experiments"],"summary":"Experiments list","description":"Requires experiments:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"query","name":"traffic","required":false,"schema":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["experiments:read"],"x-site-role":"viewer","x-risk":"none","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}}}},"/api/v1/management/actions/experiments.save":{"post":{"operationId":"experiments.save","tags":["experiments"],"summary":"Experiments save","description":"Requires experiments:write. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}}],"x-required-scopes":["experiments:write"],"x-site-role":"manager","x-risk":"write","x-interactive":false,"x-human-approval-required":false,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentInputb3652e6a42212ff710e8"}}}}}},"/api/v1/management/actions/experiments.status":{"post":{"operationId":"experiments.status","tags":["experiments"],"summary":"Experiments status","description":"Requires experiments:write. Payload-bound human approval is required.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}},{"in":"header","name":"X-Agent-Approval-ID","schema":{"type":"string"}}],"x-required-scopes":["experiments:write"],"x-site-role":"manager","x-risk":"configuration","x-interactive":false,"x-human-approval-required":true,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"experiment_id":{"type":"integer","minimum":1},"status":{"type":"string","enum":["draft","running","paused","completed"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["experiment_id","status","site_id"]}}}}}},"/api/v1/management/actions/experiments.delete":{"post":{"operationId":"experiments.delete","tags":["experiments"],"summary":"Experiments delete","description":"Requires experiments:write. Payload-bound human approval is required.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":8,"maxLength":200}},{"in":"header","name":"X-Agent-Approval-ID","schema":{"type":"string"}}],"x-required-scopes":["experiments:write"],"x-site-role":"manager","x-risk":"destructive","x-interactive":false,"x-human-approval-required":true,"responses":{"200":{"description":"JSON result with data, operationId, replayed, and request_id."},"401":{"description":"Missing or invalid bearer principal."},"403":{"description":"Scope, site grant, or membership denied."},"404":{"description":"Operation or site-scoped resource not found."},"409":{"description":"approval_required, interactive_required, idempotency_conflict, or operation_in_progress."},"422":{"description":"Invalid input or missing Idempotency-Key."},"429":{"description":"Rate limited.","headers":{"Retry-After":{"schema":{"type":"integer"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"experiment_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["experiment_id","site_id"]}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"agentClientBasic":{"type":"http","scheme":"basic"}},"schemas":{"AgentInput76d813063a1f6bdaa30b":{"type":"object","properties":{"id":{"type":["integer","null"],"minimum":1},"title":{"type":"string","maxLength":160},"description":{"type":["string","null"],"maxLength":4000},"status":{"type":"string","enum":["planned","in_progress","done","dismissed"]},"assignee_id":{"type":["integer","null"],"minimum":1},"source":{"type":"string","enum":["manual","seo","insight"]},"source_key":{"type":["string","null"],"maxLength":255},"landing_page":{"type":["string","null"],"maxLength":2048},"changed_on":{"type":["string","null"],"format":"date"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["title","status","source","site_id"]},"AgentInputb3652e6a42212ff710e8":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"experiment_id":{"type":["integer","null"],"minimum":1},"experiment_key":{"type":"string","maxLength":80,"pattern":"^[a-zA-Z0-9_-]+$"},"name":{"type":"string","maxLength":160},"hypothesis":{"type":["string","null"],"maxLength":500},"target_type":{"type":"string","enum":["goal","event","revenue"]},"goal_id":{"type":["integer","null"],"minimum":1},"event_name":{"type":["string","null"],"maxLength":255},"currency":{"type":["string","null"],"minLength":3,"maxLength":3},"variants":{"type":"array","items":{"properties":{"key":{"type":"string","maxLength":80,"pattern":"^[a-zA-Z0-9_-]+$"},"name":{"type":"string","maxLength":120},"weight":{"type":"integer","minimum":1,"maximum":9999},"is_control":{"type":"boolean"}},"required":["key","name","weight","is_control"]},"minItems":2,"maxItems":10}},"additionalProperties":false,"required":["site_id","experiment_key","name","target_type","variants"]}}},"servers":[{"url":"https://purestats.io"}],"externalDocs":{"description":"PureStats machine API documentation","url":"https://purestats.io/docs/agents/api.md"}}