{"openapi":"3.1.0","info":{"title":"PureStats Agent API","version":"1.0.0"},"paths":{"/api/v1/management/actions/sites.list":{"get":{"operationId":"sites.list","tags":["sites"],"summary":"Sites list","description":"Requires sites: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":"per_page","required":false,"schema":{"type":["integer","null"],"minimum":1,"maximum":100}}],"x-required-scopes":["sites: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/sites.create":{"post":{"operationId":"sites.create","tags":["sites"],"summary":"Sites create","description":"Requires sites:create. 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:create"],"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":{"domain":{"type":"string","maxLength":269},"name":{"type":["string","null"],"maxLength":255},"timezone":{"$ref":"#/components/schemas/AgentInputeb9b25e9028135bc7873"},"public":{"type":"boolean"}},"additionalProperties":false,"required":["domain","timezone","public"]}}}}}},"/api/v1/management/actions/sites.installation":{"get":{"operationId":"sites.installation","tags":["sites"],"summary":"Sites installation","description":"Requires sites: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":"framework","required":false,"schema":{"type":["string","null"],"enum":["html","laravel","react","nextjs","vue","wordpress","shopify","gtm",null]}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["sites:read"],"x-site-role":"manager","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/sites.installation.tests.start":{"post":{"operationId":"sites.installation.tests.start","tags":["sites"],"summary":"Sites installation tests start","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":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/sites.installation.tests.status":{"get":{"operationId":"sites.installation.tests.status","tags":["sites"],"summary":"Sites installation tests status","description":"Requires sites: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":"id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["sites:read"],"x-site-role":"manager","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/sites.installation.tests.stop":{"post":{"operationId":"sites.installation.tests.stop","tags":["sites"],"summary":"Sites installation tests stop","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":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["id","site_id"]}}}}}},"/api/v1/management/actions/sites.tracking_test.overview":{"get":{"operationId":"sites.tracking_test.overview","tags":["sites"],"summary":"Sites tracking_test overview","description":"Requires sites: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":["sites:read"],"x-site-role":"manager","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/sites.tracking_test.start":{"post":{"operationId":"sites.tracking_test.start","tags":["sites"],"summary":"Sites tracking_test start","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":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/sites.tracking_test.stop":{"post":{"operationId":"sites.tracking_test.stop","tags":["sites"],"summary":"Sites tracking_test stop","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":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/sites.monitoring":{"post":{"operationId":"sites.monitoring","tags":["sites"],"summary":"Sites monitoring","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":"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":{"enabled":{"type":"boolean"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["enabled","site_id"]}}}}}},"/api/v1/management/actions/sites.verify":{"post":{"operationId":"sites.verify","tags":["sites"],"summary":"Sites verify","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":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/sites.settings.get":{"get":{"operationId":"sites.settings.get","tags":["sites"],"summary":"Sites settings get","description":"Requires sites: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":["sites:read"],"x-site-role":"manager","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/sites.settings.update":{"post":{"operationId":"sites.settings.update","tags":["sites"],"summary":"Sites settings update","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":"sharing","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":{"name":{"type":"string","maxLength":255},"timezone":{"$ref":"#/components/schemas/AgentInputeb9b25e9028135bc7873"},"reporting_currency":{"type":"string","minLength":3,"maxLength":3},"public":{"type":"boolean"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["name","timezone","reporting_currency","public","site_id"]}}}}}},"/api/v1/management/actions/sites.domains.add":{"post":{"operationId":"sites.domains.add","tags":["sites"],"summary":"Sites domains add","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":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"domain":{"type":"string","maxLength":269}},"additionalProperties":false,"required":["site_id","domain"]}}}}}},"/api/v1/management/actions/sites.domains.primary":{"post":{"operationId":"sites.domains.primary","tags":["sites"],"summary":"Sites domains primary","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":"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":{"domain_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["domain_id","site_id"]}}}}}},"/api/v1/management/actions/sites.domains.delete":{"post":{"operationId":"sites.domains.delete","tags":["sites"],"summary":"Sites domains 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":{"domain_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["domain_id","site_id"]}}}}}},"/api/v1/management/actions/sites.delete":{"post":{"operationId":"sites.delete","tags":["sites"],"summary":"Sites delete","description":"Requires sites:delete. 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:delete"],"x-site-role":"owner","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":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/sites.ownership.transfer":{"post":{"operationId":"sites.ownership.transfer","tags":["sites"],"summary":"Sites ownership transfer","description":"Requires teams: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":["teams:write"],"x-site-role":"owner","x-risk":"access","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":{"new_owner_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["new_owner_id","site_id"]}}}}}},"/api/v1/management/actions/sites.proxy.update":{"post":{"operationId":"sites.proxy.update","tags":["sites"],"summary":"Sites proxy update","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":"owner","x-risk":"security","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":{"trusted_proxy_ips":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":100},"require_signature":{"type":"boolean"},"rotate_signing_key":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["trusted_proxy_ips","require_signature","site_id"]}}}}}},"/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/replays.list":{"get":{"operationId":"replays.list","tags":["replays"],"summary":"Replays list","description":"Requires replays: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":"path","required":false,"schema":{"type":["string","null"],"maxLength":2048}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["replays:read"],"x-site-role":"owner","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/replays.events":{"get":{"operationId":"replays.events","tags":["replays"],"summary":"Replays events","description":"Requires replays: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":"uuid","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["replays:read"],"x-site-role":"owner","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/replays.delete":{"post":{"operationId":"replays.delete","tags":["replays"],"summary":"Replays delete","description":"Requires replays: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":["replays:write"],"x-site-role":"owner","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":{"uuid":{"type":"string","pattern":"^[a-f0-9]{32}$"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/goals.list":{"get":{"operationId":"goals.list","tags":["goals"],"summary":"Goals list","description":"Requires goals: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":["goals:read"],"x-site-role":"manager","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/goals.save":{"post":{"operationId":"goals.save","tags":["goals"],"summary":"Goals save","description":"Requires goals: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":["goals: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/AgentInput2464aca46538ce5ee309"}}}}}},"/api/v1/management/actions/goals.delete":{"post":{"operationId":"goals.delete","tags":["goals"],"summary":"Goals delete","description":"Requires goals: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":["goals: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":{"goal_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["goal_id","site_id"]}}}}}},"/api/v1/management/actions/custom_dimensions.list":{"get":{"operationId":"custom_dimensions.list","tags":["custom_dimensions"],"summary":"Custom_dimensions list","description":"Requires custom_dimensions: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":["custom_dimensions:read"],"x-site-role":"manager","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/custom_dimensions.save":{"post":{"operationId":"custom_dimensions.save","tags":["custom_dimensions"],"summary":"Custom_dimensions save","description":"Requires custom_dimensions: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":["custom_dimensions: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/AgentInputbf2697e96268ff95b154"}}}}}},"/api/v1/management/actions/custom_dimensions.delete":{"post":{"operationId":"custom_dimensions.delete","tags":["custom_dimensions"],"summary":"Custom_dimensions delete","description":"Requires custom_dimensions: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":["custom_dimensions: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":{"dimension_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["dimension_id","site_id"]}}}}}},"/api/v1/management/actions/funnels.list":{"get":{"operationId":"funnels.list","tags":["funnels"],"summary":"Funnels list","description":"Requires funnels: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":["funnels:read"],"x-site-role":"manager","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/funnels.save":{"post":{"operationId":"funnels.save","tags":["funnels"],"summary":"Funnels save","description":"Requires funnels: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":["funnels: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/AgentInput9679e5f0922cd08298c0"}}}}}},"/api/v1/management/actions/funnels.delete":{"post":{"operationId":"funnels.delete","tags":["funnels"],"summary":"Funnels delete","description":"Requires funnels: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":["funnels: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":{"funnel_name":{"type":"string","maxLength":191},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["funnel_name","site_id"]}}}}}},"/api/v1/management/actions/privacy.get":{"get":{"operationId":"privacy.get","tags":["privacy"],"summary":"Privacy get","description":"Requires privacy:read, visitors: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":["privacy:read","visitors:read"],"x-site-role":"manager","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/privacy.update":{"post":{"operationId":"privacy.update","tags":["privacy"],"summary":"Privacy update","description":"Requires privacy: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":["privacy:write"],"x-site-role":"manager","x-risk":"privacy","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":{"$ref":"#/components/schemas/AgentInput2703e1060ef277aad7c4"}}}}}},"/api/v1/management/actions/privacy.requests.create":{"post":{"operationId":"privacy.requests.create","tags":["privacy"],"summary":"Privacy requests create","description":"Requires privacy:write, visitors:read. 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":["privacy:write","visitors:read"],"x-site-role":"manager","x-risk":"privacy","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":{"$ref":"#/components/schemas/AgentInput0d9b81e93e502f2b159c"}}}}}},"/api/v1/management/actions/privacy.requests.process":{"post":{"operationId":"privacy.requests.process","tags":["privacy"],"summary":"Privacy requests process","description":"Requires privacy:write, visitors:read. 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":["privacy:write","visitors:read"],"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":{"request_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["request_id","site_id"]}}}}}},"/api/v1/management/actions/privacy.requests.download":{"get":{"operationId":"privacy.requests.download","tags":["privacy"],"summary":"Privacy requests download","description":"Requires privacy:read, visitors:read. Payload-bound human approval is required.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"X-Agent-Approval-ID","schema":{"type":"string"}},{"in":"query","name":"request_id","required":true,"schema":{"type":"integer","minimum":1}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["privacy:read","visitors:read"],"x-site-role":"manager","x-risk":"export","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"}}}}}}},"/api/v1/management/actions/site_search.get":{"get":{"operationId":"site_search.get","tags":["site_search"],"summary":"Site_search get","description":"Requires site_search: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":["site_search:read"],"x-site-role":"manager","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/site_search.update":{"post":{"operationId":"site_search.update","tags":["site_search"],"summary":"Site_search update","description":"Requires site_search: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":["site_search: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":{"site_id":{"type":"integer","minimum":1},"enabled":{"type":"boolean"},"auto_detect":{"type":"boolean"},"query_parameters":{"type":["string","null"],"maxLength":1000}},"additionalProperties":false,"required":["site_id","enabled","auto_detect"]}}}}}},"/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"]}}}}}},"/api/v1/management/actions/annotations.list":{"get":{"operationId":"annotations.list","tags":["annotations"],"summary":"Annotations list","description":"Requires annotations: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":["annotations: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/annotations.save":{"post":{"operationId":"annotations.save","tags":["annotations"],"summary":"Annotations save","description":"Requires annotations: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":["annotations: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/AgentInput92a4b4c4634be38ff246"}}}}}},"/api/v1/management/actions/annotations.delete":{"post":{"operationId":"annotations.delete","tags":["annotations"],"summary":"Annotations delete","description":"Requires annotations: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":["annotations: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":{"annotation_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["annotation_id","site_id"]}}}}}},"/api/v1/management/actions/segments.list":{"get":{"operationId":"segments.list","tags":["segments"],"summary":"Segments list","description":"Requires segments: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":["segments: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/segments.save":{"post":{"operationId":"segments.save","tags":["segments"],"summary":"Segments save","description":"Requires segments: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":["segments:write"],"x-site-role":"viewer","x-risk":"sharing","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":{"$ref":"#/components/schemas/AgentInput0076226090fa2a4ef9dd"}}}}}},"/api/v1/management/actions/segments.delete":{"post":{"operationId":"segments.delete","tags":["segments"],"summary":"Segments delete","description":"Requires segments: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":["segments:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/segments.favorite":{"post":{"operationId":"segments.favorite","tags":["segments"],"summary":"Segments favorite","description":"Requires segments: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":["segments:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/segments.default":{"post":{"operationId":"segments.default","tags":["segments"],"summary":"Segments default","description":"Requires segments: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":["segments:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/dashboards.list":{"get":{"operationId":"dashboards.list","tags":["dashboards"],"summary":"Dashboards list","description":"Requires dashboards: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":["dashboards: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/dashboards.save":{"post":{"operationId":"dashboards.save","tags":["dashboards"],"summary":"Dashboards save","description":"Requires dashboards: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":["dashboards:write"],"x-site-role":"viewer","x-risk":"sharing","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":{"$ref":"#/components/schemas/AgentInput529f04125371dfa2e248"}}}}}},"/api/v1/management/actions/dashboards.delete":{"post":{"operationId":"dashboards.delete","tags":["dashboards"],"summary":"Dashboards delete","description":"Requires dashboards: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":["dashboards:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/dashboards.favorite":{"post":{"operationId":"dashboards.favorite","tags":["dashboards"],"summary":"Dashboards favorite","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":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/dashboards.default":{"post":{"operationId":"dashboards.default","tags":["dashboards"],"summary":"Dashboards default","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":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"favorite":{"type":["boolean","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/dashboards.widget":{"get":{"operationId":"dashboards.widget","tags":["dashboards"],"summary":"Dashboards widget","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":"widget","required":true,"schema":{"type":"string","enum":["metrics","timeseries","sources","pages","locations","devices","goals"]}},{"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/explorations.save":{"post":{"operationId":"explorations.save","tags":["explorations"],"summary":"Explorations save","description":"Requires explorations: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":["explorations:write"],"x-site-role":"viewer","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/AgentInput1ba91a1f9f136e39f67c"}}}}}},"/api/v1/management/actions/explorations.delete":{"post":{"operationId":"explorations.delete","tags":["explorations"],"summary":"Explorations delete","description":"Requires explorations: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":["explorations:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/dashboard.get":{"get":{"operationId":"dashboard.get","tags":["dashboard"],"summary":"Dashboard get","description":"Requires dashboards:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["dashboards: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/dashboard.period":{"post":{"operationId":"dashboard.period","tags":["dashboard"],"summary":"Dashboard period","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":"viewer","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":{"summary_period":{"type":"string","enum":["today","yesterday","this_week","last_week","this_month","last_month","this_year","last_year"]}},"additionalProperties":false,"required":["summary_period"]}}}}}},"/api/v1/management/actions/dashboard.order":{"post":{"operationId":"dashboard.order","tags":["dashboard"],"summary":"Dashboard order","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":"viewer","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":{"site_ids":{"type":"array","items":{"type":"integer","minimum":1},"maxItems":1000}},"additionalProperties":false,"required":["site_ids"]}}}}}},"/api/v1/management/actions/teams.list":{"get":{"operationId":"teams.list","tags":["teams"],"summary":"Teams list","description":"Requires teams: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":["teams:read"],"x-site-role":"manager","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/teams.invite":{"post":{"operationId":"teams.invite","tags":["teams"],"summary":"Teams invite","description":"Requires teams: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":["teams:write"],"x-site-role":"manager","x-risk":"access","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":{"site_id":{"type":"integer","minimum":1},"email":{"type":"string","format":"email","maxLength":255},"role":{"type":"string","enum":["admin","viewer"]}},"additionalProperties":false,"required":["site_id","email","role"]}}}}}},"/api/v1/management/actions/teams.update":{"post":{"operationId":"teams.update","tags":["teams"],"summary":"Teams update","description":"Requires teams: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":["teams:write"],"x-site-role":"manager","x-risk":"access","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":{"site_id":{"type":"integer","minimum":1},"member_user_id":{"type":"integer","minimum":1},"role":{"type":"string","enum":["admin","viewer"]}},"additionalProperties":false,"required":["site_id","member_user_id","role"]}}}}}},"/api/v1/management/actions/teams.remove":{"post":{"operationId":"teams.remove","tags":["teams"],"summary":"Teams remove","description":"Requires teams: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":["teams:write"],"x-site-role":"manager","x-risk":"access","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":{"member_user_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["member_user_id","site_id"]}}}}}},"/api/v1/management/actions/teams.invites.cancel":{"post":{"operationId":"teams.invites.cancel","tags":["teams"],"summary":"Teams invites cancel","description":"Requires teams: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":["teams:write"],"x-site-role":"manager","x-risk":"access","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":{"invite_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["invite_id","site_id"]}}}}}},"/api/v1/management/actions/teams.invites.accept":{"post":{"operationId":"teams.invites.accept","tags":["teams"],"summary":"Teams invites accept","description":"Requires teams: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":["teams:write"],"x-site-role":"manager","x-risk":"access","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":{"token":{"type":"string","minLength":16,"maxLength":512,"writeOnly":true}},"additionalProperties":false,"required":["token"]}}}}}},"/api/v1/management/actions/alerts.list":{"get":{"operationId":"alerts.list","tags":["alerts"],"summary":"Alerts list","description":"Requires alerts: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":["alerts:read"],"x-site-role":"manager","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/alerts.save":{"post":{"operationId":"alerts.save","tags":["alerts"],"summary":"Alerts save","description":"Requires alerts: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":["alerts:write"],"x-site-role":"manager","x-risk":"external","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":{"$ref":"#/components/schemas/AgentInputa52ab0d284da4a660f2f"}}}}}},"/api/v1/management/actions/alerts.pause":{"post":{"operationId":"alerts.pause","tags":["alerts"],"summary":"Alerts pause","description":"Requires alerts: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":["alerts: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":{"rule_id":{"type":"integer","minimum":1},"minutes":{"type":["integer","null"],"minimum":5,"maximum":10080},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["rule_id","site_id"]}}}}}},"/api/v1/management/actions/alerts.resume":{"post":{"operationId":"alerts.resume","tags":["alerts"],"summary":"Alerts resume","description":"Requires alerts: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":["alerts: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":{"rule_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["rule_id","site_id"]}}}}}},"/api/v1/management/actions/alerts.acknowledge":{"post":{"operationId":"alerts.acknowledge","tags":["alerts"],"summary":"Alerts acknowledge","description":"Requires alerts: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":["alerts: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":{"event_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["event_id","site_id"]}}}}}},"/api/v1/management/actions/alerts.resolve":{"post":{"operationId":"alerts.resolve","tags":["alerts"],"summary":"Alerts resolve","description":"Requires alerts: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":["alerts: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":{"event_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["event_id","site_id"]}}}}}},"/api/v1/management/actions/reports.list":{"get":{"operationId":"reports.list","tags":["reports"],"summary":"Reports list","description":"Requires reports: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":["reports:read"],"x-site-role":"manager","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/reports.save":{"post":{"operationId":"reports.save","tags":["reports"],"summary":"Reports save","description":"Requires reports: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":["reports:write"],"x-site-role":"manager","x-risk":"external","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":{"$ref":"#/components/schemas/AgentInput168cc1939757cfe6fc77"}}}}}},"/api/v1/management/actions/reports.delete":{"post":{"operationId":"reports.delete","tags":["reports"],"summary":"Reports delete","description":"Requires reports: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":["reports: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":{"schedule_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["schedule_id","site_id"]}}}}}},"/api/v1/management/actions/reports.test":{"post":{"operationId":"reports.test","tags":["reports"],"summary":"Reports test","description":"Requires reports: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":["reports:write"],"x-site-role":"manager","x-risk":"external","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":{"schedule_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["schedule_id","site_id"]}}}}}},"/api/v1/management/actions/search_console.get":{"get":{"operationId":"search_console.get","tags":["search_console"],"summary":"Search_console get","description":"Requires search_console: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":["search_console:read"],"x-site-role":"manager","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/search_console.oauth":{"post":{"operationId":"search_console.oauth","tags":["search_console"],"summary":"Search_console oauth","description":"Requires search_console:write. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["search_console:write"],"x-site-role":"manager","x-risk":"interactive","x-interactive":true,"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":{"provider":{"type":["string","null"],"enum":["google","bing",null]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/search_console.bing_key":{"post":{"operationId":"search_console.bing_key","tags":["search_console"],"summary":"Search_console bing_key","description":"Requires search_console: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":["search_console:write"],"x-site-role":"manager","x-risk":"external","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":{"site_id":{"type":"integer","minimum":1},"api_key":{"type":"string","minLength":16,"maxLength":512,"writeOnly":true}},"additionalProperties":false,"required":["site_id","api_key"]}}}}}},"/api/v1/management/actions/search_console.property":{"post":{"operationId":"search_console.property","tags":["search_console"],"summary":"Search_console property","description":"Requires search_console: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":["search_console: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":{"provider":{"type":["string","null"],"enum":["google","bing",null]},"property_url":{"type":"string","maxLength":2048},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["property_url","site_id"]}}}}}},"/api/v1/management/actions/search_console.disconnect":{"post":{"operationId":"search_console.disconnect","tags":["search_console"],"summary":"Search_console disconnect","description":"Requires search_console: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":["search_console: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":{"provider":{"type":["string","null"],"enum":["google","bing",null]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/search_console.sync":{"post":{"operationId":"search_console.sync","tags":["search_console"],"summary":"Search_console sync","description":"Requires search_console: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":["search_console: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":{"provider":{"type":["string","null"],"enum":["google","bing",null]},"days":{"type":["integer","null"],"minimum":1,"maximum":180},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/destinations.list":{"get":{"operationId":"destinations.list","tags":["destinations"],"summary":"Destinations list","description":"Requires destinations: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":["destinations:read"],"x-site-role":"manager","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/destinations.save":{"post":{"operationId":"destinations.save","tags":["destinations"],"summary":"Destinations save","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"$ref":"#/components/schemas/AgentInputb06e7cb1d509f8080b54"}}}}}},"/api/v1/management/actions/destinations.test":{"post":{"operationId":"destinations.test","tags":["destinations"],"summary":"Destinations test","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"destination_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["destination_id","site_id"]}}}}}},"/api/v1/management/actions/destinations.toggle":{"post":{"operationId":"destinations.toggle","tags":["destinations"],"summary":"Destinations toggle","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"destination_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["destination_id","site_id"]}}}}}},"/api/v1/management/actions/destinations.delete":{"post":{"operationId":"destinations.delete","tags":["destinations"],"summary":"Destinations delete","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"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":{"destination_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["destination_id","site_id"]}}}}}},"/api/v1/management/actions/destinations.backfill":{"post":{"operationId":"destinations.backfill","tags":["destinations"],"summary":"Destinations backfill","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"destination_id":{"type":"integer","minimum":1},"date_start":{"type":"string","format":"date"},"date_end":{"type":"string","format":"date"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["destination_id","date_start","date_end","site_id"]}}}}}},"/api/v1/management/actions/destinations.retry":{"post":{"operationId":"destinations.retry","tags":["destinations"],"summary":"Destinations retry","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"delivery_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["delivery_id","site_id"]}}}}}},"/api/v1/management/actions/destinations.backfill.cancel":{"post":{"operationId":"destinations.backfill.cancel","tags":["destinations"],"summary":"Destinations backfill cancel","description":"Requires destinations:write, visitors:read. 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":["destinations:write","visitors:read"],"x-site-role":"manager","x-risk":"external","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":{"backfill_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["backfill_id","site_id"]}}}}}},"/api/v1/management/actions/imports.list":{"get":{"operationId":"imports.list","tags":["imports"],"summary":"Imports list","description":"Requires imports: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":["imports:read"],"x-site-role":"manager","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/imports.create":{"post":{"operationId":"imports.create","tags":["imports"],"summary":"Imports create","description":"Requires imports: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":["imports:write"],"x-site-role":"manager","x-risk":"external","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":{"$ref":"#/components/schemas/AgentInput997433f74a72ea212b21"}}}}}},"/api/v1/management/actions/imports.cancel":{"post":{"operationId":"imports.cancel","tags":["imports"],"summary":"Imports cancel","description":"Requires imports: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":["imports: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":{"uuid":{"type":"string","format":"uuid"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/imports.resume":{"post":{"operationId":"imports.resume","tags":["imports"],"summary":"Imports resume","description":"Requires imports: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":["imports: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":{"uuid":{"type":"string","format":"uuid"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/imports.delete":{"post":{"operationId":"imports.delete","tags":["imports"],"summary":"Imports delete","description":"Requires imports: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":["imports: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":{"connection_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["connection_id","site_id"]}}}}}},"/api/v1/management/actions/exports.list":{"get":{"operationId":"exports.list","tags":["exports"],"summary":"Exports list","description":"Requires exports: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":["exports: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/exports.status":{"get":{"operationId":"exports.status","tags":["exports"],"summary":"Exports status","description":"Requires exports: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":["exports: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/exports.create":{"post":{"operationId":"exports.create","tags":["exports"],"summary":"Exports create","description":"Requires exports: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":["exports:write"],"x-site-role":"viewer","x-risk":"export","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":{"$ref":"#/components/schemas/AgentInput582a7653f558060e34a1"}}}}}},"/api/v1/management/actions/exports.cancel":{"post":{"operationId":"exports.cancel","tags":["exports"],"summary":"Exports cancel","description":"Requires exports: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":["exports:write"],"x-site-role":"viewer","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":{"uuid":{"type":"string","format":"uuid"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["uuid","site_id"]}}}}}},"/api/v1/management/actions/exports.download":{"get":{"operationId":"exports.download","tags":["exports"],"summary":"Exports download","description":"Requires exports:read, visitors:read. Payload-bound human approval is required.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}},{"in":"header","name":"X-Agent-Approval-ID","schema":{"type":"string"}},{"in":"query","name":"uuid","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"site_id","required":true,"schema":{"type":"integer","minimum":1}}],"x-required-scopes":["exports:read","visitors:read"],"x-site-role":"viewer","x-risk":"export","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"}}}}}}},"/api/v1/management/actions/replay_settings.get":{"get":{"operationId":"replay_settings.get","tags":["replay_settings"],"summary":"Replay_settings get","description":"Requires replays:settings: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":["replays:settings:read"],"x-site-role":"owner","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/replay_settings.save":{"post":{"operationId":"replay_settings.save","tags":["replay_settings"],"summary":"Replay_settings save","description":"Requires replays:settings: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":["replays:settings:write"],"x-site-role":"owner","x-risk":"privacy","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":{"$ref":"#/components/schemas/AgentInput2c107cd5bcb373b5e764"}}}}}},"/api/v1/management/actions/replay_settings.test":{"post":{"operationId":"replay_settings.test","tags":["replay_settings"],"summary":"Replay_settings test","description":"Requires replays:settings: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":["replays:settings:write"],"x-site-role":"owner","x-risk":"external","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":{"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["site_id"]}}}}}},"/api/v1/management/actions/replay_settings.toggle":{"post":{"operationId":"replay_settings.toggle","tags":["replay_settings"],"summary":"Replay_settings toggle","description":"Requires replays:settings: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":["replays:settings:write"],"x-site-role":"owner","x-risk":"privacy","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":{"enabled":{"type":"boolean"},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["enabled","site_id"]}}}}}},"/api/v1/management/actions/measurement_keys.list":{"get":{"operationId":"measurement_keys.list","tags":["measurement_keys"],"summary":"Measurement_keys list","description":"Requires measurement_keys: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":["measurement_keys:read"],"x-site-role":"manager","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/measurement_keys.create":{"post":{"operationId":"measurement_keys.create","tags":["measurement_keys"],"summary":"Measurement_keys create","description":"Requires measurement_keys: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":["measurement_keys:write"],"x-site-role":"manager","x-risk":"security","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":{"name":{"type":"string","maxLength":120},"expires_at":{"type":["string","null"]},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["name","site_id"]}}}}}},"/api/v1/management/actions/measurement_keys.revoke":{"post":{"operationId":"measurement_keys.revoke","tags":["measurement_keys"],"summary":"Measurement_keys revoke","description":"Requires measurement_keys: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":["measurement_keys:write"],"x-site-role":"manager","x-risk":"security","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":{"key_id":{"type":"integer","minimum":1},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["key_id","site_id"]}}}}}},"/api/v1/management/actions/account.get":{"get":{"operationId":"account.get","tags":["account"],"summary":"Account get","description":"Requires account:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account: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/account.capabilities":{"get":{"operationId":"account.capabilities","tags":["account"],"summary":"Account capabilities","description":"Requires account:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account: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/account.profile":{"get":{"operationId":"account.profile","tags":["account"],"summary":"Account profile","description":"Requires account:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account: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/account.profile.update":{"post":{"operationId":"account.profile.update","tags":["account"],"summary":"Account profile update","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":"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","minLength":2,"maxLength":255}},"additionalProperties":false,"required":["name"]}}}}}},"/api/v1/management/actions/account.preferences.get":{"get":{"operationId":"account.preferences.get","tags":["account"],"summary":"Account preferences get","description":"Requires account:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account: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/account.reports.preferences":{"post":{"operationId":"account.reports.preferences","tags":["account"],"summary":"Account reports preferences","description":"Requires account: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":["account:write"],"x-site-role":"viewer","x-risk":"external","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":{"enabled":{"type":"boolean"},"email":{"type":["string","null"],"format":"email","maxLength":255}},"additionalProperties":false,"required":["enabled"]}}}}}},"/api/v1/management/actions/account.alerts.preferences":{"post":{"operationId":"account.alerts.preferences","tags":["account"],"summary":"Account alerts preferences","description":"Requires account: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":["account:write"],"x-site-role":"viewer","x-risk":"external","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":{"preferences":{"$ref":"#/components/schemas/AgentInput4f4b29e2b3f8a2ea279f"}},"additionalProperties":false,"required":["preferences"]}}}}}},"/api/v1/management/actions/account.two_factor":{"get":{"operationId":"account.two_factor","tags":["account"],"summary":"Account two_factor","description":"Requires account:security:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account:security: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/account.sso":{"get":{"operationId":"account.sso","tags":["account"],"summary":"Account sso","description":"Requires account:security:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account:security: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/account.sessions":{"get":{"operationId":"account.sessions","tags":["account"],"summary":"Account sessions","description":"Requires account:security:read. Current site membership and granted capabilities are checked on every request.","security":[{"bearerAuth":[]}],"parameters":[{"in":"header","name":"X-Request-ID","schema":{"type":"string"}}],"x-required-scopes":["account:security: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/account.password.update":{"post":{"operationId":"account.password.update","tags":["account"],"summary":"Account password update","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{"password":{"type":"string","minLength":8,"maxLength":4096,"writeOnly":true},"password_confirmation":{"type":"string","writeOnly":true}},"additionalProperties":false,"required":["password","password_confirmation"]}}}}}},"/api/v1/management/actions/account.two_factor.setup":{"post":{"operationId":"account.two_factor.setup","tags":["account"],"summary":"Account two_factor setup","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{},"additionalProperties":false}}}}}},"/api/v1/management/actions/account.two_factor.enable":{"post":{"operationId":"account.two_factor.enable","tags":["account"],"summary":"Account two_factor enable","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{"setup_id":{"type":"string","format":"uuid"},"code":{"type":"string","maxLength":32,"writeOnly":true}},"additionalProperties":false,"required":["setup_id","code"]}}}}}},"/api/v1/management/actions/account.two_factor.cancel":{"post":{"operationId":"account.two_factor.cancel","tags":["account"],"summary":"Account two_factor cancel","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{"setup_id":{"type":"string","format":"uuid"}},"additionalProperties":false,"required":["setup_id"]}}}}}},"/api/v1/management/actions/account.two_factor.disable":{"post":{"operationId":"account.two_factor.disable","tags":["account"],"summary":"Account two_factor disable","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{},"additionalProperties":false}}}}}},"/api/v1/management/actions/account.recovery_codes.regenerate":{"post":{"operationId":"account.recovery_codes.regenerate","tags":["account"],"summary":"Account recovery_codes regenerate","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{},"additionalProperties":false}}}}}},"/api/v1/management/actions/account.sso.disconnect":{"post":{"operationId":"account.sso.disconnect","tags":["account"],"summary":"Account sso disconnect","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{"provider":{"type":"string","enum":["google","github"]}},"additionalProperties":false,"required":["provider"]}}}}}},"/api/v1/management/actions/account.sessions.revoke":{"post":{"operationId":"account.sessions.revoke","tags":["account"],"summary":"Account sessions revoke","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{"session_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["session_id"]}}}}}},"/api/v1/management/actions/account.sessions.revoke_others":{"post":{"operationId":"account.sessions.revoke_others","tags":["account"],"summary":"Account sessions revoke_others","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{},"additionalProperties":false}}}}}},"/api/v1/management/actions/account.sessions.revoke_all":{"post":{"operationId":"account.sessions.revoke_all","tags":["account"],"summary":"Account sessions revoke_all","description":"Requires account:security: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":["account:security:write"],"x-site-role":"viewer","x-risk":"security","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":{},"additionalProperties":false}}}}}},"/api/v1/agents/identity/challenges":{"post":{"operationId":"identity.challenge","tags":["identity"],"security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Independent client-generated 32-byte random secret; keep private because it authorizes encrypted response replay.","schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityChallengeRequest"}}}},"responses":{"201":{"description":"Created or replayed confidential result.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityChallengeResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"403":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"409":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"413":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"415":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"422":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"503":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}},"/api/v1/agents/identity/registrations":{"post":{"operationId":"identity.register","tags":["identity"],"security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Independent client-generated 32-byte random secret; keep private because it authorizes encrypted response replay.","schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityRegistrationRequest"}}}},"responses":{"201":{"description":"Created or replayed confidential result.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityCredentialResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"403":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"409":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"413":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"415":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"422":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"503":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}},"/api/v1/agents/identity/recoveries":{"post":{"operationId":"identity.recover","tags":["identity"],"security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Independent client-generated 32-byte random secret; keep private because it authorizes encrypted response replay.","schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityRecoveryRequest"}}}},"responses":{"201":{"description":"Created or replayed confidential result.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityCredentialResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"403":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"409":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"413":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"415":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"422":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"503":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}},"/api/v1/agents/identity/delegations":{"post":{"operationId":"identity.delegation","tags":["identity"],"security":[],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Independent client-generated 32-byte random secret; keep private because it authorizes encrypted response replay.","schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityDelegationRequest"}}}},"responses":{"201":{"description":"Created or replayed confidential result.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityCredentialResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"403":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"409":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"413":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"415":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"422":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}},"503":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}},"/oauth/device/code":{"post":{"operationId":"oauth.device","tags":["oauth"],"security":[[],{"agentClientBasic":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthDeviceRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/AgentOAuthDeviceRequest"}}}},"responses":{"200":{"description":"Native Passport OAuth response.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthDeviceResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"401":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}},"/oauth/token":{"post":{"operationId":"oauth.token","tags":["oauth"],"security":[[],{"agentClientBasic":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthTokenRequest"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/AgentOAuthTokenRequest"}}}},"responses":{"200":{"description":"Native Passport OAuth response.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthTokenResponse"}}}},"400":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"401":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"404":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"429":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}},"500":{"description":"Request denied or unavailable.","headers":{"Cache-Control":{"description":"Includes no-store; responses never issue session cookies.","schema":{"type":"string","pattern":"(^|,\\s*)no-store(,|$)"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentOAuthError"}}}}},"x-cookie-authentication":false,"x-sensitive-response":true}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"agentClientBasic":{"type":"http","scheme":"basic"}},"schemas":{"AgentInputeb9b25e9028135bc7873":{"type":"string","enum":["Africa/Abidjan","Africa/Accra","Africa/Addis_Ababa","Africa/Algiers","Africa/Asmara","Africa/Bamako","Africa/Bangui","Africa/Banjul","Africa/Bissau","Africa/Blantyre","Africa/Brazzaville","Africa/Bujumbura","Africa/Cairo","Africa/Casablanca","Africa/Ceuta","Africa/Conakry","Africa/Dakar","Africa/Dar_es_Salaam","Africa/Djibouti","Africa/Douala","Africa/El_Aaiun","Africa/Freetown","Africa/Gaborone","Africa/Harare","Africa/Johannesburg","Africa/Juba","Africa/Kampala","Africa/Khartoum","Africa/Kigali","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Lome","Africa/Luanda","Africa/Lubumbashi","Africa/Lusaka","Africa/Malabo","Africa/Maputo","Africa/Maseru","Africa/Mbabane","Africa/Mogadishu","Africa/Monrovia","Africa/Nairobi","Africa/Ndjamena","Africa/Niamey","Africa/Nouakchott","Africa/Ouagadougou","Africa/Porto-Novo","Africa/Sao_Tome","Africa/Tripoli","Africa/Tunis","Africa/Windhoek","America/Adak","America/Anchorage","America/Anguilla","America/Antigua","America/Araguaina","America/Argentina/Buenos_Aires","America/Argentina/Catamarca","America/Argentina/Cordoba","America/Argentina/Jujuy","America/Argentina/La_Rioja","America/Argentina/Mendoza","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Aruba","America/Asuncion","America/Atikokan","America/Bahia","America/Bahia_Banderas","America/Barbados","America/Belem","America/Belize","America/Blanc-Sablon","America/Boa_Vista","America/Bogota","America/Boise","America/Cambridge_Bay","America/Campo_Grande","America/Cancun","America/Caracas","America/Cayenne","America/Cayman","America/Chicago","America/Chihuahua","America/Ciudad_Juarez","America/Costa_Rica","America/Coyhaique","America/Creston","America/Cuiaba","America/Curacao","America/Danmarkshavn","America/Dawson","America/Dawson_Creek","America/Denver","America/Detroit","America/Dominica","America/Edmonton","America/Eirunepe","America/El_Salvador","America/Fort_Nelson","America/Fortaleza","America/Glace_Bay","America/Goose_Bay","America/Grand_Turk","America/Grenada","America/Guadeloupe","America/Guatemala","America/Guayaquil","America/Guyana","America/Halifax","America/Havana","America/Hermosillo","America/Indiana/Indianapolis","America/Indiana/Knox","America/Indiana/Marengo","America/Indiana/Petersburg","America/Indiana/Tell_City","America/Indiana/Vevay","America/Indiana/Vincennes","America/Indiana/Winamac","America/Inuvik","America/Iqaluit","America/Jamaica","America/Juneau","America/Kentucky/Louisville","America/Kentucky/Monticello","America/Kralendijk","America/La_Paz","America/Lima","America/Los_Angeles","America/Lower_Princes","America/Maceio","America/Managua","America/Manaus","America/Marigot","America/Martinique","America/Matamoros","America/Mazatlan","America/Menominee","America/Merida","America/Metlakatla","America/Mexico_City","America/Miquelon","America/Moncton","America/Monterrey","America/Montevideo","America/Montserrat","America/Nassau","America/New_York","America/Nome","America/Noronha","America/North_Dakota/Beulah","America/North_Dakota/Center","America/North_Dakota/New_Salem","America/Nuuk","America/Ojinaga","America/Panama","America/Paramaribo","America/Phoenix","America/Port-au-Prince","America/Port_of_Spain","America/Porto_Velho","America/Puerto_Rico","America/Punta_Arenas","America/Rankin_Inlet","America/Recife","America/Regina","America/Resolute","America/Rio_Branco","America/Santarem","America/Santiago","America/Santo_Domingo","America/Sao_Paulo","America/Scoresbysund","America/Sitka","America/St_Barthelemy","America/St_Johns","America/St_Kitts","America/St_Lucia","America/St_Thomas","America/St_Vincent","America/Swift_Current","America/Tegucigalpa","America/Thule","America/Tijuana","America/Toronto","America/Tortola","America/Vancouver","America/Whitehorse","America/Winnipeg","America/Yakutat","Antarctica/Casey","Antarctica/Davis","Antarctica/DumontDUrville","Antarctica/Macquarie","Antarctica/Mawson","Antarctica/McMurdo","Antarctica/Palmer","Antarctica/Rothera","Antarctica/Syowa","Antarctica/Troll","Antarctica/Vostok","Arctic/Longyearbyen","Asia/Aden","Asia/Almaty","Asia/Amman","Asia/Anadyr","Asia/Aqtau","Asia/Aqtobe","Asia/Ashgabat","Asia/Atyrau","Asia/Baghdad","Asia/Bahrain","Asia/Baku","Asia/Bangkok","Asia/Barnaul","Asia/Beirut","Asia/Bishkek","Asia/Brunei","Asia/Chita","Asia/Colombo","Asia/Damascus","Asia/Dhaka","Asia/Dili","Asia/Dubai","Asia/Dushanbe","Asia/Famagusta","Asia/Gaza","Asia/Hebron","Asia/Ho_Chi_Minh","Asia/Hong_Kong","Asia/Hovd","Asia/Irkutsk","Asia/Jakarta","Asia/Jayapura","Asia/Jerusalem","Asia/Kabul","Asia/Kamchatka","Asia/Karachi","Asia/Kathmandu","Asia/Khandyga","Asia/Kolkata","Asia/Krasnoyarsk","Asia/Kuala_Lumpur","Asia/Kuching","Asia/Kuwait","Asia/Macau","Asia/Magadan","Asia/Makassar","Asia/Manila","Asia/Muscat","Asia/Nicosia","Asia/Novokuznetsk","Asia/Novosibirsk","Asia/Omsk","Asia/Oral","Asia/Phnom_Penh","Asia/Pontianak","Asia/Pyongyang","Asia/Qatar","Asia/Qostanay","Asia/Qyzylorda","Asia/Riyadh","Asia/Sakhalin","Asia/Samarkand","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Srednekolymsk","Asia/Taipei","Asia/Tashkent","Asia/Tbilisi","Asia/Tehran","Asia/Thimphu","Asia/Tokyo","Asia/Tomsk","Asia/Ulaanbaatar","Asia/Urumqi","Asia/Ust-Nera","Asia/Vientiane","Asia/Vladivostok","Asia/Yakutsk","Asia/Yangon","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/Bermuda","Atlantic/Canary","Atlantic/Cape_Verde","Atlantic/Faroe","Atlantic/Madeira","Atlantic/Reykjavik","Atlantic/South_Georgia","Atlantic/St_Helena","Atlantic/Stanley","Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Eucla","Australia/Hobart","Australia/Lindeman","Australia/Lord_Howe","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Andorra","Europe/Astrakhan","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Bratislava","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Busingen","Europe/Chisinau","Europe/Copenhagen","Europe/Dublin","Europe/Gibraltar","Europe/Guernsey","Europe/Helsinki","Europe/Isle_of_Man","Europe/Istanbul","Europe/Jersey","Europe/Kaliningrad","Europe/Kirov","Europe/Kyiv","Europe/Lisbon","Europe/Ljubljana","Europe/London","Europe/Luxembourg","Europe/Madrid","Europe/Malta","Europe/Mariehamn","Europe/Minsk","Europe/Monaco","Europe/Moscow","Europe/Oslo","Europe/Paris","Europe/Podgorica","Europe/Prague","Europe/Riga","Europe/Rome","Europe/Samara","Europe/San_Marino","Europe/Sarajevo","Europe/Saratov","Europe/Simferopol","Europe/Skopje","Europe/Sofia","Europe/Stockholm","Europe/Tallinn","Europe/Tirane","Europe/Ulyanovsk","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Vilnius","Europe/Volgograd","Europe/Warsaw","Europe/Zagreb","Europe/Zurich","Indian/Antananarivo","Indian/Chagos","Indian/Christmas","Indian/Cocos","Indian/Comoro","Indian/Kerguelen","Indian/Mahe","Indian/Maldives","Indian/Mauritius","Indian/Mayotte","Indian/Reunion","Pacific/Apia","Pacific/Auckland","Pacific/Bougainville","Pacific/Chatham","Pacific/Chuuk","Pacific/Easter","Pacific/Efate","Pacific/Fakaofo","Pacific/Fiji","Pacific/Funafuti","Pacific/Galapagos","Pacific/Gambier","Pacific/Guadalcanal","Pacific/Guam","Pacific/Honolulu","Pacific/Kanton","Pacific/Kiritimati","Pacific/Kosrae","Pacific/Kwajalein","Pacific/Majuro","Pacific/Marquesas","Pacific/Midway","Pacific/Nauru","Pacific/Niue","Pacific/Norfolk","Pacific/Noumea","Pacific/Pago_Pago","Pacific/Palau","Pacific/Pitcairn","Pacific/Pohnpei","Pacific/Port_Moresby","Pacific/Rarotonga","Pacific/Saipan","Pacific/Tahiti","Pacific/Tarawa","Pacific/Tongatapu","Pacific/Wake","Pacific/Wallis","UTC"]},"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"]},"AgentInput2464aca46538ce5ee309":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"goal_id":{"type":["integer","null"],"minimum":1},"name":{"type":"string","maxLength":255},"type":{"type":"string","enum":["pageview","event","outbound","download","404","scroll"]},"event_name":{"type":["string","null"],"maxLength":255},"page_path":{"type":["string","null"],"maxLength":1024},"comparison":{"type":["string","null"],"enum":["is","is_not","contains","does_not_contain","matches","does_not_match",null]},"scroll_percentage":{"type":["integer","null"],"minimum":1,"maximum":100},"revenue_enabled":{"type":"boolean"},"revenue_currency":{"type":["string","null"],"minLength":3,"maxLength":3},"revenue_value":{"type":["number","null"],"minimum":0,"maximum":99999999.99},"active":{"type":["boolean","null"]},"return_to":{"type":["string","null"],"enum":["onboarding",null]}},"additionalProperties":false,"required":["site_id","name","type","revenue_enabled"]},"AgentInputbf2697e96268ff95b154":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"dimension_id":{"type":["integer","null"],"minimum":1},"name":{"type":"string","maxLength":120},"property_key":{"type":"string","maxLength":80},"scope":{"type":"string","enum":["event","session","visitor"]},"value_type":{"type":"string","enum":["string","number","boolean","date"]},"cardinality_limit":{"type":"integer","minimum":100,"maximum":100000},"active":{"type":"boolean"}},"additionalProperties":false,"required":["site_id","name","property_key","scope","value_type","cardinality_limit","active"]},"AgentInput9679e5f0922cd08298c0":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"funnel_name":{"type":"string","maxLength":191},"original_funnel_name":{"type":["string","null"],"maxLength":191},"mode":{"type":["string","null"],"enum":["ordered","strict","loose",null]},"conversion_window_minutes":{"type":["integer","null"],"minimum":1,"maximum":525600},"max_step_gap_minutes":{"type":["integer","null"],"minimum":1,"maximum":525600},"attribution_model":{"type":["string","null"],"enum":["session","first_touch","last_touch",null]},"active":{"type":["boolean","null"]},"steps":{"type":"array","items":{"properties":{"name":{"type":"string","maxLength":255},"type":{"type":"string","enum":["pageview","event"]},"target":{"type":"string","maxLength":1024},"comparison":{"type":"string","enum":["is","contains","matches"]}},"required":["name","type","target","comparison"]},"minItems":2,"maxItems":8}},"additionalProperties":false,"required":["site_id","funnel_name","steps"]},"AgentInput2703e1060ef277aad7c4":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"ip_anonymization_mode":{"type":"string","enum":["standard","strict"]},"geo_precision":{"type":"string","enum":["city","region","country","none"]},"consent_mode":{"type":"string","enum":["none_required","manual_required","disabled"]},"respect_dnt":{"type":"boolean"},"web_vitals_enabled":{"type":"boolean"},"excluded_path_rules":{"type":["string","null"],"maxLength":65535},"public_privacy_center_enabled":{"type":"boolean"},"privacy_contact_email":{"type":["string","null"],"format":"email","maxLength":255},"raw_retention_days":{"type":"integer","minimum":30,"maximum":3650},"rollup_retention_days":{"type":"integer","minimum":30,"maximum":3650},"retention_enabled":{"type":"boolean"},"bot_filter_mode":{"type":"string","enum":["off","standard","strict"]},"exclude_bot_traffic":{"type":"boolean"},"exclude_ai_traffic":{"type":"boolean"},"cross_domain_stitching_enabled":{"type":"boolean"},"cross_domain_linker_enabled":{"type":"boolean"}},"additionalProperties":false,"required":["site_id","ip_anonymization_mode","geo_precision","consent_mode","respect_dnt","web_vitals_enabled","public_privacy_center_enabled","raw_retention_days","rollup_retention_days","retention_enabled","bot_filter_mode","exclude_bot_traffic","exclude_ai_traffic","cross_domain_stitching_enabled","cross_domain_linker_enabled"]},"AgentInput0d9b81e93e502f2b159c":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"type":{"type":"string","enum":["export","delete"]},"requester_email":{"type":["string","null"],"format":"email","maxLength":255},"lookup_type":{"type":"string","enum":["visitor_hash","client_visitor_hash","user_identity_hash","session_hash","date_range","manual"]},"lookup_value":{"type":["string","null"],"maxLength":512},"date_from":{"type":["string","null"],"format":"date"},"date_to":{"type":["string","null"],"format":"date"},"requester_note":{"type":["string","null"],"maxLength":4000}},"additionalProperties":false,"required":["site_id","type","lookup_type"]},"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"]},"AgentInput92a4b4c4634be38ff246":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"annotation_id":{"type":["integer","null"],"minimum":1},"return_to":{"type":["string","null"],"maxLength":64},"starts_at":{"type":"string"},"ends_at":{"type":["string","null"]},"category":{"type":"string","enum":["deployment","product","marketing","incident","import","data_gap","note"]},"title":{"type":"string","maxLength":160},"description":{"type":["string","null"],"maxLength":1000}},"additionalProperties":false,"required":["site_id","starts_at","category","title"]},"AgentInput0076226090fa2a4ef9dd":{"type":"object","properties":{"uuid":{"type":["string","null"],"format":"uuid"},"name":{"type":"string","maxLength":120},"description":{"type":["string","null"],"maxLength":500},"scope":{"type":["string","null"],"enum":["dashboard","campaign","event","funnel","journey","global",null]},"filters":{"type":["object","null"],"additionalProperties":true},"traffic_mode":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]},"period_key":{"type":["string","null"],"maxLength":32},"visibility":{"type":["string","null"],"enum":["private","site","public_link",null]},"is_favorite":{"type":["boolean","null"]},"is_default":{"type":["boolean","null"]},"rotate_share_token":{"type":["boolean","null"],"writeOnly":true},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["name","site_id"]},"AgentInput529f04125371dfa2e248":{"type":"object","properties":{"uuid":{"type":["string","null"],"format":"uuid"},"name":{"type":"string","maxLength":120},"description":{"type":["string","null"],"maxLength":500},"widgets":{"type":["array","null"],"items":{"properties":{"widget_key":{"type":["string","null"],"maxLength":80},"type":{"type":["string","null"],"maxLength":80},"title":{"type":["string","null"],"maxLength":160},"config":{"type":["object","null"],"additionalProperties":true},"x_pos":{"type":["integer","null"],"minimum":0,"maximum":12},"y_pos":{"type":["integer","null"],"minimum":0},"width":{"type":["integer","null"],"minimum":3,"maximum":12},"height":{"type":["integer","null"],"minimum":2,"maximum":12}}}},"global_filters":{"type":["object","null"],"additionalProperties":true},"traffic_mode":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]},"period_key":{"type":["string","null"],"maxLength":32},"visibility":{"type":["string","null"],"enum":["private","site","public_link",null]},"is_favorite":{"type":["boolean","null"]},"is_default":{"type":["boolean","null"]},"rotate_share_token":{"type":["boolean","null"],"writeOnly":true},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["name","site_id"]},"AgentInput1ba91a1f9f136e39f67c":{"type":"object","properties":{"uuid":{"type":["string","null"],"format":"uuid"},"name":{"type":"string","maxLength":120},"metric":{"type":"string","enum":["pageviews","visitors","sessions","events","revenue"]},"dimension":{"type":"string","maxLength":96},"period":{"type":["string","null"],"maxLength":32},"comparison":{"type":["string","null"],"maxLength":32},"filters":{"type":["object","null"],"additionalProperties":true},"site_id":{"type":"integer","minimum":1}},"additionalProperties":false,"required":["name","metric","dimension","site_id"]},"AgentInputa52ab0d284da4a660f2f":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"rule_id":{"type":"integer","minimum":1},"type":{"type":"string","enum":["tracking_stopped","traffic_spike","traffic_drop","goal_drop","goal_spike","revenue_drop"]},"name":{"type":"string","maxLength":160},"severity":{"type":"string","enum":["info","warning","critical"]},"target_id":{"type":["integer","null"],"minimum":1},"threshold_value":{"type":["number","null"],"minimum":0,"maximum":9999999999.99},"window_minutes":{"type":"integer","minimum":5,"maximum":43200},"baseline_window_minutes":{"type":"integer","minimum":60,"maximum":129600},"baseline_mode":{"type":["string","null"],"enum":["previous_window","same_weekday",null]},"cooldown_minutes":{"type":"integer","minimum":5,"maximum":43200},"email_enabled":{"type":"boolean"},"recipients":{"type":["string","null"],"maxLength":4000},"enabled":{"type":"boolean"}},"additionalProperties":false,"required":["site_id","rule_id","type","name","severity","window_minutes","baseline_window_minutes","cooldown_minutes","email_enabled","enabled"]},"AgentInput168cc1939757cfe6fc77":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"schedule_id":{"type":["integer","null"],"minimum":1},"name":{"type":"string","maxLength":160},"frequency":{"type":"string","enum":["weekly","monthly"]},"period_mode":{"type":"string","enum":["previous_period","rolling"]},"send_day_of_week":{"type":["integer","null"],"minimum":1,"maximum":7},"send_day_of_month":{"type":["integer","null"],"minimum":1,"maximum":31},"send_time":{"type":"string"},"timezone":{"type":"string"},"recipients":{"type":"string","maxLength":4000},"sections":{"type":"array","items":{"type":"string","enum":["traffic","top_pages","campaigns","goals","commerce","insights"]},"minItems":1},"enabled":{"type":"boolean"}},"additionalProperties":false,"required":["site_id","name","frequency","period_mode","send_time","timezone","recipients","sections","enabled"]},"AgentInputb06e7cb1d509f8080b54":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"destination_id":{"type":["integer","null"],"minimum":1},"provider":{"type":"string","enum":["webhook","s3","bigquery","clickhouse"]},"name":{"type":"string","maxLength":120},"endpoint":{"type":["string","null"],"maxLength":2048},"signing_secret":{"type":["string","null"],"minLength":24,"maxLength":4096,"writeOnly":true},"bucket":{"type":["string","null"],"pattern":"^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$","maxLength":63},"region":{"type":["string","null"],"maxLength":64},"prefix":{"type":["string","null"],"maxLength":512},"path_style":{"type":["boolean","null"]},"access_key":{"type":["string","null"],"maxLength":512,"writeOnly":true},"secret_key":{"type":["string","null"],"maxLength":4096,"writeOnly":true},"project_id":{"type":["string","null"],"pattern":"^[a-z][a-z0-9-]{4,62}$","maxLength":63},"dataset_id":{"type":["string","null"],"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":1024},"table_id":{"type":["string","null"],"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":1024},"access_token":{"type":["string","null"],"maxLength":8192,"writeOnly":true},"database":{"type":["string","null"],"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":255},"table":{"type":["string","null"],"pattern":"^[A-Za-z_][A-Za-z0-9_]*$","maxLength":255},"username":{"type":["string","null"],"maxLength":255},"password":{"type":["string","null"],"maxLength":4096,"writeOnly":true}},"additionalProperties":false,"required":["site_id","provider","name"]},"AgentInput997433f74a72ea212b21":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"provider":{"type":"string","enum":["ga4","plausible","matomo","csv"]},"name":{"type":["string","null"],"maxLength":120},"date_start":{"type":"string","format":"date"},"date_end":{"type":"string","format":"date"},"access_token":{"type":["string","null"],"maxLength":4096,"writeOnly":true},"property_id":{"type":["string","null"],"pattern":"^\\d+$","maxLength":32},"api_key":{"type":["string","null"],"maxLength":4096,"writeOnly":true},"token_auth":{"type":["string","null"],"maxLength":4096,"writeOnly":true},"site_identifier":{"type":["string","null"],"maxLength":255},"base_url":{"type":["string","null"],"maxLength":2048},"mapping":{"type":["object","null"],"additionalProperties":true,"items":{"type":["string","null"],"properties":{},"maxLength":120}},"csv":{"type":["string","null"],"maxLength":10485760}},"additionalProperties":false,"required":["site_id","provider","date_start","date_end"]},"AgentInput582a7653f558060e34a1":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"type":{"type":"string","enum":["overview","campaigns","events","commerce","explore","site_search","funnels","funnel_segments","funnel_paths","journeys","pageviews","raw_events"]},"period":{"type":["string","null"],"maxLength":32},"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"traffic":{"type":["string","null"],"enum":["human","all","bot","ai","spam","suspicious",null]},"filters":{"type":["object","null"],"additionalProperties":true},"funnel":{"type":["string","null"],"maxLength":191},"metric":{"type":["string","null"],"enum":["pageviews","visitors","sessions","events","revenue",null]},"dimension":{"type":["string","null"],"maxLength":96,"pattern":"^(page|source|country|device|browser|os|event_name|custom:\\d+)$"}},"additionalProperties":false,"required":["site_id","type"]},"AgentInput2c107cd5bcb373b5e764":{"type":"object","properties":{"site_id":{"type":"integer","minimum":1},"endpoint":{"type":"string","maxLength":2048},"bucket":{"type":"string","maxLength":255,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9._-]+$"},"region":{"type":"string","maxLength":64,"pattern":"^[a-zA-Z0-9-]+$"},"prefix":{"type":"string","maxLength":255,"pattern":"^[a-zA-Z0-9][a-zA-Z0-9._\\/-]*$"},"path_style":{"type":"boolean"},"access_key":{"type":["string","null"],"maxLength":512,"writeOnly":true},"secret_key":{"type":["string","null"],"maxLength":1024,"writeOnly":true},"storage_watermark_gb":{"type":"integer","minimum":1,"maximum":1024}},"additionalProperties":false,"required":["site_id","endpoint","bucket","region","prefix","path_style","storage_watermark_gb"]},"AgentInput4f4b29e2b3f8a2ea279f":{"type":"object","additionalProperties":true,"properties":{"tracking_stopped":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"traffic_spike":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"traffic_drop":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"goal_drop":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"goal_spike":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"revenue_drop":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"rollup_stuck":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]},"cron_failed":{"properties":{"enabled":{"type":"boolean"},"delivery":{"type":"string","enum":["immediate","daily_digest"]}},"required":["enabled","delivery"]}}},"AgentIdentityChallengeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"domain":{"type":"string"},"method":{"enum":["dns","https"]},"purpose":{"enum":["register","recover"]},"expires_at":{"type":"string","format":"date-time"},"dns_name":{"type":"string"},"https_url":{"type":"string","format":"uri"},"value":{"type":"string"}},"required":["challenge_id","domain","method","purpose","expires_at","dns_name","https_url","value"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","request_id"],"additionalProperties":false},"AgentIdentityCredentialResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"credential_id":{"type":"string","format":"uuid"},"client_id":{"type":"string","format":"uuid"},"client_secret":{"type":"string"},"owner_id":{"type":["integer","null"]},"account_type":{"enum":["human","machine"]},"scopes":{"type":"array","items":{"type":"string"}},"requested_scopes":{"type":"array","items":{"type":"string"}},"site_ids":{"type":"array","items":{"type":"integer"}},"grant_type":{"enum":["client_credentials","urn:ietf:params:oauth:grant-type:device_code"]},"token_endpoint":{"type":"string","format":"uri"},"device_authorization_endpoint":{"type":"string","format":"uri"},"resource":{"type":"string","format":"uri"}},"required":["credential_id","client_id","client_secret","owner_id","account_type","scopes","requested_scopes","site_ids","grant_type","token_endpoint","device_authorization_endpoint","resource"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","request_id"],"additionalProperties":false},"AgentIdentityError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"details":{"type":["object","array"],"additionalProperties":true}},"required":["code","details"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["error","request_id"],"additionalProperties":false},"AgentOAuthTokenResponse":{"type":"object","properties":{"token_type":{"type":"string","const":"Bearer"},"expires_in":{"type":"integer","maximum":900},"access_token":{"type":"string"},"refresh_token":{"type":"string"}},"required":["token_type","expires_in","access_token"],"additionalProperties":false},"AgentOAuthDeviceResponse":{"type":"object","properties":{"device_code":{"type":"string"},"user_code":{"type":"string"},"verification_uri":{"type":"string","format":"uri"},"verification_uri_complete":{"type":"string","format":"uri"},"expires_in":{"type":"integer","maximum":600},"interval":{"type":"integer"}},"required":["device_code","user_code","verification_uri","verification_uri_complete","expires_in","interval"],"additionalProperties":false},"AgentOAuthError":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"},"hint":{"type":"string"},"message":{"type":"string"}},"required":["error"],"additionalProperties":false},"AgentIdentityChallengeRequest":{"type":"object","properties":{"domain":{"type":"string","maxLength":253},"method":{"type":"string","enum":["dns","https"]},"purpose":{"type":"string","enum":["register","recover"]},"client_id":{"type":["string","null"],"format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":255},"contact_email":{"type":["string","null"],"format":"email","maxLength":255},"recovery_key":{"type":"string","minLength":64,"maxLength":68,"pattern":"^(?:psr_)?[a-f0-9]{64}$","writeOnly":true,"description":"Generate and persist 32 random bytes as 64 lowercase hex characters before starting registration or recovery. Never publish this key."}},"additionalProperties":false,"required":["domain","method","recovery_key"]},"AgentIdentityRegistrationRequest":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"scopes":{"type":"array","items":{"type":"string","enum":["analytics:read","sites:read","sites:create","sites:write","sites:delete","settings:read","settings:write","goals:read","goals:write","experiments:read","experiments:write","alerts:read","alerts:write","annotations:read","annotations:write","exports:read","exports:write","reports:read","reports:write","privacy:read","privacy:write","team:read","team:write","integrations:read","integrations:write","imports:read","imports:write","replays:read","replays:write","teams:read","teams:write","dashboards:read","dashboards:write","destinations:read","destinations:write","explorations:write","funnels:read","funnels:write","measurement_keys:read","measurement_keys:write","search_console:read","search_console:write","site_search:read","site_search:write","visitors:read","account:read","account:write","account:security:read","account:security:write","account:interactive","custom_dimensions:read","custom_dimensions:write","replays:settings:read","replays:settings:write","segments:read","segments:write"]},"minItems":1,"maxItems":56},"recovery_key":{"type":"string","minLength":64,"maxLength":68,"pattern":"^(?:psr_)?[a-f0-9]{64}$","writeOnly":true,"description":"Generate and persist 32 random bytes as 64 lowercase hex characters before starting registration or recovery. Never publish this key."}},"additionalProperties":false,"required":["challenge_id","scopes","recovery_key"]},"AgentIdentityRecoveryRequest":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"client_id":{"type":["string","null"],"format":"uuid"},"recovery_key":{"type":"string","minLength":64,"maxLength":68,"pattern":"^(?:psr_)?[a-f0-9]{64}$","writeOnly":true,"description":"Existing recovery key; the challenge already binds a different client-generated replacement key."}},"additionalProperties":false,"required":["challenge_id","recovery_key"]},"AgentIdentityDelegationRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"scopes":{"type":"array","items":{"type":"string","enum":["analytics:read","sites:read","sites:create","sites:write","sites:delete","settings:read","settings:write","goals:read","goals:write","experiments:read","experiments:write","alerts:read","alerts:write","annotations:read","annotations:write","exports:read","exports:write","reports:read","reports:write","privacy:read","privacy:write","team:read","team:write","integrations:read","integrations:write","imports:read","imports:write","replays:read","replays:write","teams:read","teams:write","dashboards:read","dashboards:write","destinations:read","destinations:write","explorations:write","funnels:read","funnels:write","measurement_keys:read","measurement_keys:write","search_console:read","search_console:write","site_search:read","site_search:write","visitors:read","account:read","account:write","account:security:read","account:security:write","account:interactive","custom_dimensions:read","custom_dimensions:write","replays:settings:read","replays:settings:write","segments:read","segments:write"]},"minItems":1,"maxItems":56},"resource":{"type":"string","maxLength":2048,"enum":["https://purestats.io/api/v1/management","https://purestats.io/mcp"]}},"additionalProperties":false,"required":["name","scopes"]},"AgentOAuthDeviceRequest":{"type":"object","properties":{"client_id":{"type":"string","format":"uuid","description":"Client UUID, required unless supplied through HTTP Basic client authentication."},"client_secret":{"type":"string","maxLength":4096,"writeOnly":true},"scope":{"type":"string","minLength":1,"maxLength":8192},"resource":{"type":"string","maxLength":2048}},"additionalProperties":true,"required":["scope"]},"AgentOAuthTokenRequest":{"type":"object","properties":{"grant_type":{"type":"string","enum":["client_credentials","urn:ietf:params:oauth:grant-type:device_code","refresh_token"]},"client_id":{"type":"string","format":"uuid","description":"Client UUID, required unless supplied through HTTP Basic client authentication."},"client_secret":{"type":"string","maxLength":4096,"writeOnly":true},"scope":{"type":"string","minLength":1,"maxLength":8192},"resource":{"type":"string","maxLength":2048},"device_code":{"type":"string","maxLength":8192},"refresh_token":{"type":"string","maxLength":8192,"writeOnly":true}},"additionalProperties":true,"required":["grant_type"],"oneOf":[{"properties":{"grant_type":{"const":"client_credentials"}},"required":["grant_type"]},{"properties":{"grant_type":{"const":"urn:ietf:params:oauth:grant-type:device_code"}},"required":["grant_type","device_code"]},{"properties":{"grant_type":{"const":"refresh_token"}},"required":["grant_type","refresh_token"]}]}}},"servers":[{"url":"https://purestats.io"}],"externalDocs":{"description":"PureStats machine API documentation","url":"https://purestats.io/docs/agents/api.md"}}