{"openapi":"3.1.0","info":{"title":"Vault56 API","version":"1.0.0","description":"Auto-generated API specification from route metadata.\n\n(Public specification: administrative endpoints are not listed.)"},"servers":[{"url":"{protocol}://{host}","variables":{"protocol":{"default":"https","enum":["https","http"]},"host":{"default":"api.ng.vault56.com","description":"API host. Change this if you target a different environment."}}}],"paths":{"/.well-known/jwks.json":{"get":{"tags":[".well known"],"summary":"production while working locally. See [[project_nginx_apng_block_drift]].","operationId":"getWellKnownJwksJson","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"tags":[".well known"],"summary":"List oauth authorization server","operationId":"getWellKnownOauthAuthorizationServer","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"tags":[".well known"],"summary":"Discovery (RFC 9728 / RFC 8414)","operationId":"getWellKnownOauthProtectedResource","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/.well-known/openid-configuration":{"get":{"tags":[".well known"],"summary":"exception for this path was added with the JWKS one in phase 0.","operationId":"getWellKnownOpenidConfiguration","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/account/data-export/{token}":{"get":{"tags":["Account"],"summary":"rest and time-boxed; resolveToken() is the only authorization.","operationId":"getAccountDataExportBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/admin":{"get":{"tags":["Admin"],"summary":"in 'advanced' mode (default for super-admins). See AdminBaseController::getUiMode.","operationId":"getAdmin","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/_union/{endpoints}":{"get":{"tags":[" union"],"summary":"Ad-hoc union query (comma-separated endpoint names)","operationId":"getApiUnionByendpoints","security":[],"parameters":[{"name":"endpoints","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/access-policies/counts":{"get":{"tags":["Access policies"],"summary":"Policy counts (total + active) per endpoint in one query. Before /@policyId.","operationId":"getApiAccessPoliciesCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/access-policies/{policyId}":{"get":{"tags":["Access policies"],"summary":"Get access policie","operationId":"getApiAccessPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Access policies"],"summary":"Update access policie","operationId":"putApiAccessPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Access policies"],"summary":"Delete access policie","operationId":"deleteApiAccessPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/account/currency":{"get":{"tags":["Account"],"summary":"Get user currency preferences","operationId":"getApiAccountCurrency","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Account"],"summary":"Set user currency preferences","operationId":"putApiAccountCurrency","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/account/geo-blocking":{"get":{"tags":["Account"],"summary":"Get account-level geo blocking settings","operationId":"getApiAccountGeoBlocking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Account"],"summary":"Set account-level geo blocking settings","operationId":"putApiAccountGeoBlocking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/account/geo-blocking/logs":{"get":{"tags":["Account"],"summary":"Get geo blocking logs","operationId":"getApiAccountGeoBlockingLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/activity":{"get":{"tags":["Activity"],"summary":"----- Activity Stream Routes -----","operationId":"getApiActivity","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/activity/stats":{"get":{"tags":["Activity"],"summary":"List stats","operationId":"getApiActivityStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/advisories":{"get":{"tags":["Advisories"],"summary":"---- Public advisory feeds (no auth \u2014 public products only) ----","operationId":"getApiAdvisories","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/advisories/rss":{"get":{"tags":["Advisories"],"summary":"List rss","operationId":"getApiAdvisoriesRss","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups":{"get":{"tags":["Agent groups"],"summary":"Group CRUD","operationId":"getApiAgentGroups","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agent groups"],"summary":"Create agent groups","operationId":"postApiAgentGroups","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/tree":{"get":{"tags":["Agent groups"],"summary":"List tree","operationId":"getApiAgentGroupsTree","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/unassigned-agents":{"get":{"tags":["Agent groups"],"summary":"List unassigned agents","operationId":"getApiAgentGroupsUnassignedAgents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}":{"get":{"tags":["Agent groups"],"summary":"Get agent group","operationId":"getApiAgentGroupsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agent groups"],"summary":"Update agent group","operationId":"putApiAgentGroupsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent groups"],"summary":"Delete agent group","operationId":"deleteApiAgentGroupsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/assign":{"post":{"tags":["Agent groups"],"summary":"Agent assignment","operationId":"postApiAgentGroupsByidAssign","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/detail":{"get":{"tags":["Agent groups"],"summary":"List detail","operationId":"getApiAgentGroupsByidDetail","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/map-image":{"post":{"tags":["Agent groups"],"summary":"Map image upload","operationId":"postApiAgentGroupsByidMapImage","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/map-position":{"post":{"tags":["Agent groups"],"summary":"Create map position","operationId":"postApiAgentGroupsByidMapPosition","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent groups"],"summary":"Delete map position","operationId":"deleteApiAgentGroupsByidMapPosition","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/map-positions":{"get":{"tags":["Agent groups"],"summary":"Map positions","operationId":"getApiAgentGroupsByidMapPositions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-groups/{id}/unassign":{"post":{"tags":["Agent groups"],"summary":"Create unassign","operationId":"postApiAgentGroupsByidUnassign","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/alert-webhook":{"get":{"tags":["Agent telemetry"],"summary":"Alert webhook (D0): per-tenant push for high/critical detections. User session required.","operationId":"getApiAgentTelemetryAlertWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agent telemetry"],"summary":"Update alert webhook","operationId":"putApiAgentTelemetryAlertWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent telemetry"],"summary":"Delete alert webhook","operationId":"deleteApiAgentTelemetryAlertWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/detection-rules":{"get":{"tags":["Agent telemetry"],"summary":"Detection rules (D0): tenant rules + read-only built-ins. User session required.","operationId":"getApiAgentTelemetryDetectionRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agent telemetry"],"summary":"Create detection rules","operationId":"postApiAgentTelemetryDetectionRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/detection-rules/{id}":{"put":{"tags":["Agent telemetry"],"summary":"Update detection rule","operationId":"putApiAgentTelemetryDetectionRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent telemetry"],"summary":"Delete detection rule","operationId":"deleteApiAgentTelemetryDetectionRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/detections":{"get":{"tags":["Agent telemetry"],"summary":"Detections (D0): triage. User session required.","operationId":"getApiAgentTelemetryDetections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/detections/{id}":{"put":{"tags":["Agent telemetry"],"summary":"Update detection","operationId":"putApiAgentTelemetryDetectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/events":{"post":{"tags":["Agent telemetry"],"summary":"Create events","operationId":"postApiAgentTelemetryEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/quota":{"get":{"tags":["Agent telemetry"],"summary":"Quota (M0-6): self-service per-tenant ingest quota. User session required.","operationId":"getApiAgentTelemetryQuota","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agent telemetry"],"summary":"Update quota","operationId":"putApiAgentTelemetryQuota","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent telemetry"],"summary":"Delete quota","operationId":"deleteApiAgentTelemetryQuota","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-telemetry/retention":{"get":{"tags":["Agent telemetry"],"summary":"controller rejects agent tokens).","operationId":"getApiAgentTelemetryRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agent telemetry"],"summary":"Update retention","operationId":"putApiAgentTelemetryRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent telemetry"],"summary":"Delete retention","operationId":"deleteApiAgentTelemetryRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-tokens":{"get":{"tags":["Agent tokens"],"summary":"List agent tokens","operationId":"getApiAgentTokens","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agent tokens"],"summary":"Create agent tokens","operationId":"postApiAgentTokens","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-tokens/{id}":{"get":{"tags":["Agent tokens"],"summary":"Get agent token","operationId":"getApiAgentTokensByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agent tokens"],"summary":"Update agent token","operationId":"putApiAgentTokensByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agent tokens"],"summary":"Delete agent token","operationId":"deleteApiAgentTokensByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-tokens/{id}/install-command":{"get":{"tags":["Agent tokens"],"summary":"List install command","operationId":"getApiAgentTokensByidInstallCommand","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-tokens/{id}/revoke":{"post":{"tags":["Agent tokens"],"summary":"Create revoke","operationId":"postApiAgentTokensByidRevoke","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents":{"get":{"tags":["Agents"],"summary":"List agents","operationId":"getApiAgents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/reconnect":{"post":{"tags":["Agents"],"summary":"Create reconnect","operationId":"postApiAgentsReconnect","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/register":{"post":{"tags":["Agents"],"summary":"============================================","operationId":"postApiAgentsRegister","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/register-token":{"post":{"tags":["Agents"],"summary":"============================================","operationId":"postApiAgentsRegisterToken","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/script-hash":{"get":{"tags":["Agents"],"summary":"Returns the canonical synchronized hash; null when api1+api2 disagree.","operationId":"getApiAgentsScriptHash","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/transfer-requests":{"get":{"tags":["Agents"],"summary":"Pending agent transfer requests","description":"**Access:** signed in.\n\nincoming: agents offered to you; outgoing: offers you may withdraw.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsTransferRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/transfer-requests/{requestId}/{action}":{"post":{"tags":["Agents"],"summary":"Accept, decline or withdraw a transfer request","description":"**Access:** the receiver (accept/decline); the sender or an org admin (cancel).\n\naction = accept | decline | cancel. Accepting re-checks that the organization still owns the agent and the sender may still give it away.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsTransferRequestsByrequestidByaction","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"action","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Request not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"409":{"description":"The agent changed owner or is blocked","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/windows-installer.cmd":{"get":{"tags":["Agents"],"summary":"template; serving it directly would skip the token substitution).","operationId":"getApiAgentsWindowsInstallerCmd","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/alert-events":{"get":{"tags":["Agents"],"summary":"List alert events","operationId":"getApiAgentsByagentidAlertEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/alert-rules":{"get":{"tags":["Agents"],"summary":"Per-agent rules","operationId":"getApiAgentsByagentidAlertRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Create alert rules","operationId":"postApiAgentsByagentidAlertRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/default-deny":{"get":{"tags":["Agents"],"summary":"Default-deny state and readiness","description":"**Access:** view.\n\nstate: off|arming|active|reverted|failed. readiness.ok is false until inbound allow rules exist and are all applied.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByagentidFirewallDefaultDeny","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Enable default-deny (self-reverting)","description":"**Access:** manage.\n\nThe agent removes it again unless confirmed within revert_after_seconds.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByagentidFirewallDefaultDeny","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"revert_after_seconds":{"type":"integer","description":"60-3600","default":600}}}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"409":{"description":"Not ready; error.reasons explains why","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Disable default-deny","description":"**Access:** manage.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiAgentsByagentidFirewallDefaultDeny","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/default-deny/confirm":{"post":{"tags":["Agents"],"summary":"Confirm default-deny within the window","description":"**Access:** manage.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByagentidFirewallDefaultDenyConfirm","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"409":{"description":"Not awaiting confirmation, or the window has passed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/effective":{"get":{"tags":["Agents"],"summary":"(the exact set the agent will receive on next sync).","operationId":"getApiAgentsByagentidFirewallEffective","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/policies":{"get":{"tags":["Agents"],"summary":"============================ Policy assignments ============================","operationId":"getApiAgentsByagentidFirewallPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Create policies","operationId":"postApiAgentsByagentidFirewallPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/policies/{policyId}":{"delete":{"tags":["Agents"],"summary":"Delete policie","operationId":"deleteApiAgentsByagentidFirewallPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/refresh-state":{"post":{"tags":["Agents"],"summary":"Ask the agent for a host firewall snapshot","description":"**Access:** manage.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByagentidFirewallRefreshState","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/rules":{"get":{"tags":["Agents"],"summary":"List rules attached directly to an agent (not policy-derived).","operationId":"getApiAgentsByagentidFirewallRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Create a rule directly on an agent.","operationId":"postApiAgentsByagentidFirewallRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/state":{"get":{"tags":["Agents"],"summary":"Latest host firewall snapshot","description":"**Access:** view.\n\nnull until a snapshot has been reported.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByagentidFirewallState","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{agentId}/firewall/sync":{"post":{"tags":["Agents"],"summary":"Send the effective firewall ruleset to the agent","description":"**Access:** manage.\n\ndry_run defaults to true (parse and log only).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByagentidFirewallSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean","default":true}}}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}":{"patch":{"tags":["Agents"],"summary":"Edit agent details","description":"**Access:** admin.\n\nOnly the fields sent are changed; others are ignored.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"patchApiAgentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","description":"Up to 80 chars; empty clears it"},"description":{"type":"string","description":"Up to 2000 chars; empty clears it"},"tags":{"type":"array","description":"Or a comma-separated string. Normalised; max 20 tags of 40 chars","items":{"type":"string"}},"metrics_retention_days":{"type":"integer","description":"1-3650; null inherits from the group","nullable":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required, or invalid metrics_retention_days","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Agents"],"summary":"Get agent","operationId":"getApiAgentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete agent","operationId":"deleteApiAgentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/apps":{"get":{"tags":["Agents"],"summary":"Time per application for a date range","description":"**Access:** admin.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidActivityApps","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"},"description":"First day, YYYY-MM-DD (default today)"},{"name":"end","in":"query","required":false,"schema":{"type":"string"},"description":"Last day, YYYY-MM-DD (default today); at most 366 days after start"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid date or range, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/config":{"get":{"tags":["Agents"],"summary":"Get collection settings","description":"**Access:** view.\n\nAll collection settings; defaults (without id) if never configured. Change with PUT (admin).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidActivityConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agents"],"summary":"Update config","operationId":"putApiAgentsByidActivityConfig","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/data":{"delete":{"tags":["Agents"],"summary":"Erase collected monitoring data","description":"**Access:** admin.\n\nActivity, process, installed-app, disk-scan, connectivity, metrics and alert history. Irreversible.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiAgentsByidActivityData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/disable":{"post":{"tags":["Agents"],"summary":"Disable employee-activity monitoring","description":"**Access:** admin.\n\nCollected data is kept until it expires or is erased.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidActivityDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/enable":{"post":{"tags":["Agents"],"summary":"Enable employee-activity monitoring","description":"**Access:** admin.\n\nRequires explicit consent acknowledgement; the caller and time are recorded as the consent.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidActivityEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"consent_acknowledged":{"type":"boolean"},"collect_apps":{"type":"boolean"},"collect_files":{"type":"boolean"},"collect_web_pages":{"type":"boolean"},"collect_keyboard_activity":{"type":"boolean","description":"Activity indicator only; keystrokes are not recorded"},"collect_process_list":{"type":"boolean"},"collect_installed_apps":{"type":"boolean"},"collect_disk_scan":{"type":"boolean"},"collect_os_updates":{"type":"boolean"},"auto_install_deps":{"type":"boolean"},"auto_install_security_updates":{"type":"boolean"},"retention_days":{"type":"integer","description":"1-3650; ignored outside that range"}},"required":["consent_acknowledged"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Consent not acknowledged, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/report":{"get":{"tags":["Agents"],"summary":"Activity report for a date range","description":"**Access:** admin.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidActivityReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"},"description":"First day, YYYY-MM-DD (default today)"},{"name":"end","in":"query","required":false,"schema":{"type":"string"},"description":"Last day, YYYY-MM-DD (default today); at most 366 days after start"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid date or range, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/activity/timeline":{"get":{"tags":["Agents"],"summary":"Raw activity snapshots for one day","description":"**Access:** admin.\n\nAt most 5000, in time order.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidActivityTimeline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD (default today)"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid date, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/agent-terminal":{"post":{"tags":["Agents"],"summary":"Open a login-free terminal session","description":"**Access:** admin.\n\nRequires the terminal to be enabled for the agent. Limited to the caller's IP, 30 minutes. Returns a one-time session_token.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidAgentTerminal","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Terminal disabled for this agent, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/agent-terminal/enabled":{"put":{"tags":["Agents"],"summary":"Enable/disable the login-free terminal","description":"**Access:** admin.\n\nOff by default. When on, an admin can open a root terminal through the agent without an SSH login.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidAgentTerminalEnabled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/alerts":{"get":{"tags":["Agents"],"summary":"Agent alerts","operationId":"getApiAgentsByidAlerts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agents"],"summary":"Update alerts","operationId":"putApiAgentsByidAlerts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/alerts/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidAlertsHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/allow-shared-install":{"put":{"tags":["Agents"],"summary":"Allow share holders to install software","description":"**Access:** owner only (shares of any level are refused).\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidAllowSharedInstall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow_shared_install":{"type":"boolean"}},"required":["allow_shared_install"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"allow_shared_install is required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Only the host owner can change this, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/apps":{"get":{"tags":["Agents"],"summary":"Installed applications","operationId":"getApiAgentsByidApps","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/apps/changes":{"get":{"tags":["Agents"],"summary":"List changes","operationId":"getApiAgentsByidAppsChanges","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/apps/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidAppsHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/banned-ips":{"get":{"tags":["Agents"],"summary":"Addresses seen or blocked by auto-blocking","description":"**Access:** view.\n\nUp to 100 rows, active blocks first. meta.mode is off|observe|enforce.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidBannedIps","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/certificates":{"get":{"tags":["Agents"],"summary":"List certificates on the host","description":"**Access:** view.\n\nManaged certificates plus ones observed on the host (source: observed, id null). Empty if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Request a certificate","description":"**Access:** manage.\n\nThe agent obtains and installs it on its next heartbeat; renewal is automatic.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"email":{"type":"string","format":"email"},"iis_site_name":{"type":"string","description":"Windows hosts only","default":"Default Web Site"}},"required":["domain"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid domain/email, already exists, manage access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Stop managing and remove a certificate","description":"**Access:** manage.\n\nSend the domain in the JSON body.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiAgentsByidCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/certificates/renew":{"post":{"tags":["Agents"],"summary":"Renew a managed certificate now","description":"**Access:** manage.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidCertificatesRenew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Certificate not found, manage access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/commands":{"get":{"tags":["Agents"],"summary":"List queued commands","description":"**Access:** view.\n\nThe 50 most recent commands, newest first, credentials redacted. display_status is queued|running|done|failed|sent; stop polling at done, failed or sent. Empty list if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidCommands","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Queue a raw command","description":"**Access:** admin.\n\nPrefer the dedicated endpoints where one exists. Sensitive commands are audit-logged.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidCommands","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"command":{"type":"string","enum":["run_command","read_file","open_port","close_port","ban_ip","unban_ip","open_tunnel","close_tunnel","install_cert","renew_cert","remove_cert","enable_activity","disable_activity","self_destruct","system_report","list_users","change_password","lock_session","network_scan","network_ping","traceroute","reconfigure_task","install_updates","device_scan","kill_duplicates","ssh_add_key","ssh_remove_key","mailcow_status","mailcow_update","ispconfig_status","ispconfig_update"]},"params":{"type":"object","description":"Command-specific parameters"}},"required":["command"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"command is required / Unknown command","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/commands/{cmdId}":{"get":{"tags":["Agents"],"summary":"Get one command and its result","description":"**Access:** view.\n\nSame fields as the list, with params and result decoded and credentials redacted.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidCommandsBycmdid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cmdId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Command not found (also when the agent is not visible to you)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/connect":{"post":{"tags":["Agents"],"summary":"Open SSH/RDP access for your IP","description":"**Access:** admin.\n\nOpens the port (direct) or a reverse tunnel (tunnel) for the caller's IP only, for 60 minutes.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidConnect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string","default":"ssh","enum":["ssh","rdp"]},"tunnel":{"type":"boolean","description":"Use a reverse tunnel (host behind NAT)","default":false}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Unsupported protocol, admin access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/connectivity":{"get":{"tags":["Agents"],"summary":"Connectivity history","description":"**Access:** view.\n\nUp to 50 offline/online/error events, newest first. Empty if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidConnectivity","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/custodia/install":{"post":{"tags":["Agents"],"summary":"Install the Custodia backup agent from the Release Manager + enroll into a fleet.","operationId":"postApiAgentsByidCustodiaInstall","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/custodia/status":{"get":{"tags":["Agents"],"summary":"Custodia backup agent presence and fleet","description":"**Access:** view.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidCustodiaStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/disk-prediction":{"get":{"tags":["Agents"],"summary":"Predict when the disk is full","description":"**Access:** view.\n\nTrend over up to 90 days of daily usage. prediction: critical|warning|healthy|shrinking|stable, or null with too little data.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidDiskPrediction","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/disk-scan":{"get":{"tags":["Agents"],"summary":"Latest disk-usage scan","description":"**Access:** view.\n\nLargest folders and files. null if no scan yet or the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidDiskScan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/file-watches":{"get":{"tags":["Agents"],"summary":"List file watches","description":"**Access:** admin (manage and view shares are refused).\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidFileWatches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Agent not found, or insufficient access","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Ship a host file to a data channel","description":"**Access:** admin (manage and view shares are refused).\n\nCredential and key files are refused. The destination channel must be yours, not server-encrypted, and schema-free.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidFileWatches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string","description":"Absolute path"},"destination_ref":{"type":"string","description":"Data channel public id"},"mode":{"type":"string","default":"tail","enum":["tail","snapshot"]},"interval_seconds":{"type":"integer","description":"Clamped to 15-86400","default":60},"max_bytes":{"type":"integer","description":"Clamped to 1024-1048576","default":262144},"destination_type":{"type":"string","default":"channel","enum":["channel"]},"enabled":{"type":"boolean","default":true}},"required":["path","destination_ref"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/file-watches/{watchId}":{"put":{"tags":["Agents"],"summary":"Update a file watch","description":"**Access:** admin (manage and view shares are refused).\n\nOnly the fields sent are changed.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidFileWatchesBywatchid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"watchId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string"},"destination_ref":{"type":"string"},"mode":{"type":"string","default":"tail","enum":["tail","snapshot"]},"interval_seconds":{"type":"integer","description":"Clamped to 15-86400","default":60},"max_bytes":{"type":"integer","description":"Clamped to 1024-1048576","default":262144},"destination_type":{"type":"string","default":"channel","enum":["channel"]},"enabled":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message, or File watch not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete a file watch","description":"**Access:** admin (manage and view shares are refused).\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiAgentsByidFileWatchesBywatchid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"watchId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"File watch not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/heartbeat":{"post":{"tags":["Agents"],"summary":"Heartbeat uses X-Agent-Key (permanent credential), NOT JWT","operationId":"postApiAgentsByidHeartbeat","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/ispconfig/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidIspconfigHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/ispconfig/status":{"get":{"tags":["Agents"],"summary":"ispconfig (roadmap #270)","operationId":"getApiAgentsByidIspconfigStatus","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/ispconfig/update":{"post":{"tags":["Agents"],"summary":"Create update","operationId":"postApiAgentsByidIspconfigUpdate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/issues":{"get":{"tags":["Agents"],"summary":"Recurring failures on the host","description":"**Access:** view.\n\nGrouped and counted, with a diagnosis where one has been established.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidIssues","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/issues/{issueId}/fix":{"post":{"tags":["Agents"],"summary":"Apply the offered fix for an issue","description":"**Access:** manage.\n\nWithout confirm:true only describes what would happen. Fixes: reload_webserver, restart_unit.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidIssuesByissueidFix","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"issueId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found (also when access is below manage)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"422":{"description":"Issue not found, or no automatic fix","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/location":{"get":{"tags":["Agents"],"summary":"Location tracking","operationId":"getApiAgentsByidLocation","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/location/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidLocationHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/log":{"get":{"tags":["Agents"],"summary":"The agent's own log","description":"**Access:** view.\n\nNewest first. Empty if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100},"description":"Entries, 1-500"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/logwatch":{"get":{"tags":["Agents"],"summary":"Logwatch reports (recent)","operationId":"getApiAgentsByidLogwatch","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/mailcow/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidMailcowHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/mailcow/status":{"get":{"tags":["Agents"],"summary":"mailcow (roadmap #266)","operationId":"getApiAgentsByidMailcowStatus","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/mailcow/update":{"post":{"tags":["Agents"],"summary":"Create update","operationId":"postApiAgentsByidMailcowUpdate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/metrics/report":{"get":{"tags":["Agents"],"summary":"Resource usage over a date range","description":"**Access:** view.\n\nHourly CPU, memory, disk and network series.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidMetricsReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"},"description":"First day, YYYY-MM-DD (default today)"},{"name":"end","in":"query","required":false,"schema":{"type":"string"},"description":"Last day, YYYY-MM-DD (default today); at most 366 days after start"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid date or range, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/metrics/summary":{"get":{"tags":["Agents"],"summary":"Latest resource reading and 24h averages","description":"**Access:** view.\n\ncurrent is null until the first sample.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidMetricsSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/metrics/timeline":{"get":{"tags":["Agents"],"summary":"List timeline","operationId":"getApiAgentsByidMetricsTimeline","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/os-updates":{"get":{"tags":["Agents"],"summary":"OS Updates","operationId":"getApiAgentsByidOsUpdates","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/os-updates/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidOsUpdatesHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/os-updates/install":{"post":{"tags":["Agents"],"summary":"Create install","operationId":"postApiAgentsByidOsUpdatesInstall","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/os-updates/install-history":{"get":{"tags":["Agents"],"summary":"Recent OS-update installs and reboots","description":"**Access:** view.\n\nWith a readable outcome and the tail of the installer output. Empty if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidOsUpdatesInstallHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5},"description":"Entries, 1-20"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/path-expectations":{"get":{"tags":["Agents"],"summary":"List path checks","description":"**Access:** owner only (shares do not apply).\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidPathExpectations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Agents"],"summary":"Create (or update) a path check","description":"**Access:** owner only (shares do not apply).\n\nTwo consecutive failed checks raise an issue (see /issues). Upserts on (path, kind).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidPathExpectations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string","description":"Absolute: /srv/data, D:\\data or \\\\server\\share"},"kind":{"type":"string","default":"dir","enum":["mount","dir","file"]},"label":{"type":"string","description":"Up to 200 chars"},"require_non_empty":{"type":"boolean","default":false},"max_age_seconds":{"type":"integer","description":"kind=file only, >= 1","nullable":true},"min_size_bytes":{"type":"integer","description":"kind=file only, >= 0","nullable":true},"is_enabled":{"type":"boolean","default":true}},"required":["path"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message, or Agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/path-expectations/{expectationId}":{"put":{"tags":["Agents"],"summary":"Update a path check","description":"**Access:** owner only (shares do not apply).\n\npath and kind cannot be changed.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidPathExpectationsByexpectationid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expectationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","description":"Up to 200 chars"},"require_non_empty":{"type":"boolean","default":false},"max_age_seconds":{"type":"integer","description":"kind=file only, >= 1","nullable":true},"min_size_bytes":{"type":"integer","description":"kind=file only, >= 0","nullable":true},"is_enabled":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message, or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete a path check","description":"**Access:** owner only (shares do not apply).\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiAgentsByidPathExpectationsByexpectationid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expectationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Agent not found or access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/port-scans":{"get":{"tags":["Agents"],"summary":"Inbound port-scan episodes this agent detected (Migration 753). View access.","operationId":"getApiAgentsByidPortScans","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/processes":{"get":{"tags":["Agents"],"summary":"Process list","operationId":"getApiAgentsByidProcesses","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/processes/history":{"get":{"tags":["Agents"],"summary":"List history","operationId":"getApiAgentsByidProcessesHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/reboot":{"post":{"tags":["Agents"],"summary":"Create reboot","operationId":"postApiAgentsByidReboot","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/rename-computer":{"post":{"tags":["Agents"],"summary":"Rename the computer","description":"Rename the machine itself (Linux hostname, macOS computer/host/Bonjour names, Windows computer name). Requires manage access to the agent. Not the friendly name (display_name).","operationId":"postApiAgentsByidRenameComputer","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["new_name"],"properties":{"new_name":{"type":"string","description":"One name without dots: 1-63 letters, digits and hyphens, no hyphen first or last, not only digits. Windows: at most 15 characters.","pattern":"^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$"},"restart":{"type":"string","enum":["later","now"],"description":"Windows only. later (default): the name applies at the next restart; now: restart after renaming."},"delay_seconds":{"type":"integer","minimum":0,"maximum":3600,"description":"Windows with restart=now: seconds before the restart (default 60)."}}}}}},"responses":{"201":{"description":"Rename queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"The name or a field is not valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Requires manage access to the agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The agent cannot do it now: agent version too old, a rename already queued, or already that name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/reboot-lock/{action}":{"post":{"tags":["Agents"],"summary":"@action = acquire | release","operationId":"postApiAgentsByidRebootLockByaction","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"action","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/rollout-ring":{"put":{"tags":["Agents"],"summary":"Set the agent-update rollout ring","description":"**Access:** manage.\n\nRing 0 (canary) receives new agent versions first, ring 3 last.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidRolloutRing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ring":{"type":"integer","description":"0-3"}},"required":["ring"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Field \"ring\" is required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Ring out of range, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/software-installs":{"get":{"tags":["Agents"],"summary":"Software installed through the platform, and by whom","description":"**Access:** view.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidSoftwareInstalls","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20},"description":"Entries, 1-100"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/ssh-host-keys":{"get":{"tags":["Agents"],"summary":"SSH host keys the browser terminal trusts for this agent (#477)","operationId":"getApiAgentsByidSshHostKeys","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Agents"],"summary":"Delete ssh host keys","operationId":"deleteApiAgentsByidSshHostKeys","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/summary-preview":{"post":{"tags":["Agents"],"summary":"Build a summary now without sending it","description":"**Access:** view.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidSummaryPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"cadence":{"type":"string","default":"monthly","enum":["daily","weekly","monthly","quarterly","yearly"]}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Unknown cadence, or no measurements yet","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/summary-subscription":{"get":{"tags":["Agents"],"summary":"Get host summary email settings","description":"**Access:** view.\n\nis_default:true means nothing has been saved yet.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidSummarySubscription","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Agents"],"summary":"Save host summary email settings","description":"**Access:** view.\n\nReplaces the whole subscription.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"putApiAgentsByidSummarySubscription","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","default":true},"cadences":{"type":"array","items":{"type":"string","enum":["daily","weekly","monthly","quarterly","yearly"]}},"recipients":{"type":"string","description":"Comma/semicolon-separated emails; empty = alert address and owner"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/system-report":{"post":{"tags":["Agents"],"summary":"Queue a full system inventory report","description":"**Access:** admin.\n\nDownload it with GET /api/agents/{id}/system-report/{cmdId} once the command has executed.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidSystemReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/system-report/{cmdId}":{"get":{"tags":["Agents"],"summary":"Download (or email) a system report PDF","description":"**Access:** view to download; manage to email.\n\nReturns application/pdf. With ?email= the report is emailed instead and a JSON confirmation returned.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidSystemReportBycmdid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cmdId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"email","in":"query","required":false,"schema":{"type":"string"},"description":"Email the PDF to this address instead (requires manage access)"}],"responses":{"200":{"description":"The PDF (application/pdf), or a JSON confirmation when email is given","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Invalid email address","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required to email","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Report not ready","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/threshold-simulation":{"get":{"tags":["Agents"],"summary":"What auto-blocking would do at other thresholds","description":"**Access:** view.\n\nBased on the failed-login sources recorded by the agent. Empty if the agent is not visible to you.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidThresholdSimulation","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/traceroute":{"post":{"tags":["Agents"],"summary":"Queue a traceroute from the host","description":"**Access:** manage.\n\nThe target must be an IP address; hostnames are refused.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidTraceroute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string"}},"required":["ip"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Target must be an IP address, manage access required, or Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/transfer":{"post":{"tags":["Agents"],"summary":"Transfer the agent","description":"**Access:** owner, or agents.admin + transfer-from-org.\n\nMoves at once (200, transfer=done) or, for another member of the owning organization, creates a request they accept (202, transfer=requested; expires after 7 days).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","description":"personal | org:<organization id> | user:<member id>"},"confirm_name":{"type":"string","description":"The agent's display name (else hostname), typed to confirm"},"message":{"type":"string","description":"Shown to the receiving member (requests only)","nullable":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Wrong confirm_name or target","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"409":{"description":"Blocked (see error.blockers) or a request is already waiting","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/transfer-options":{"get":{"tags":["Agents"],"summary":"Where this agent can be moved","description":"**Access:** view (giving it away: owner, or agents.admin + transfer-from-org in its organisation).\n\nReturns can_transfer, the reason when not, the current owner, the targets (personal, org:<id>, user:<id>) with mode immediate|request, and a pending request if any.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidTransferOptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/transfer-plan":{"get":{"tags":["Agents"],"summary":"What a transfer would move, end and keep","description":"**Access:** owner, or agents.admin + transfer-from-org.\n\nA dry run: moves, ends, kept, blockers (e.g. firewall policies of the current owner) and warnings (billing, a paused receiving account).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidTransferPlan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"},"description":"personal | org:<organization id> | user:<member id>"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Unknown or invalid target","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"May not give it away / may not add agents to that organization","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agents/{id}/unban":{"post":{"tags":["Agents"],"summary":"Lift a block","description":"**Access:** manage.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidUnban","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string"}},"required":["ip"]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Manage access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/uninstall":{"post":{"tags":["Agents"],"summary":"Queue agent self-uninstall","description":"**Access:** admin.\n\nThe agent removes itself on its next heartbeat. The record and history are kept.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidUninstall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/users":{"post":{"tags":["Agents"],"summary":"Queue a listing of host users and sessions","description":"**Access:** admin.\n\nRead the result via /commands/{cmdId}.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/users/change-password":{"post":{"tags":["Agents"],"summary":"Set a local account password","description":"**Access:** admin.\n\nAudit-logged; the password is redacted from command listings.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidUsersChangePassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"new_password":{"type":"string"}},"required":["username","new_password"]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"username and new_password required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/users/lock-session":{"post":{"tags":["Agents"],"summary":"Lock a user session","description":"**Access:** admin.\n\nGive username or session_id (at least one).\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"postApiAgentsByidUsersLockSession","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"session_id":{"type":"string"}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"username or session_id required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}}}}},"/api/agents/{id}/warnings":{"get":{"tags":["Agents"],"summary":"Everything currently wrong with the host","description":"**Access:** view.\n\nWorst first, with counts. `degraded` lists sources that could not be read: empty warnings with a non-empty degraded is not a clean bill of health.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiAgentsByidWarnings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-assistants":{"get":{"tags":["Ai assistants"],"summary":"Every assistant the caller can see, across projects -- the admin panel's list.","operationId":"getApiAiAssistants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/attachments/{attachmentId}":{"get":{"tags":["Ai builder"],"summary":"Get attachment","operationId":"getApiAiBuilderAttachmentsByattachmentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/credentials":{"get":{"tags":["Ai builder"],"summary":"---- Own-key credentials: removed 2026-10-06 (GET empty, POST 410, DELETE still revokes) ----","operationId":"getApiAiBuilderCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Ai builder"],"summary":"Create credentials","operationId":"postApiAiBuilderCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/credentials/{id}":{"delete":{"tags":["Ai builder"],"summary":"Delete credential","operationId":"deleteApiAiBuilderCredentialsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/managed/consent":{"get":{"tags":["Ai builder"],"summary":"List consent","operationId":"getApiAiBuilderManagedConsent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Ai builder"],"summary":"Create consent","operationId":"postApiAiBuilderManagedConsent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/managed/estimate":{"post":{"tags":["Ai builder"],"summary":"Create estimate","operationId":"postApiAiBuilderManagedEstimate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/managed/tiers":{"get":{"tags":["Ai builder"],"summary":"List tiers","operationId":"getApiAiBuilderManagedTiers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet":{"get":{"tags":["Ai builder"],"summary":"Wallet","operationId":"getApiAiBuilderOrganizationsByorgidWallet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/breakdown":{"get":{"tags":["Ai builder"],"summary":"Where the money went this month: per member, per project, member x project (owners/admins).","operationId":"getApiAiBuilderOrganizationsByorgidWalletBreakdown","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/grants":{"get":{"tags":["Ai builder"],"summary":"Grants (admin only \u2014 enforced inside the service)","operationId":"getApiAiBuilderOrganizationsByorgidWalletGrants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Ai builder"],"summary":"Create grants","operationId":"postApiAiBuilderOrganizationsByorgidWalletGrants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/grants/{grantId}":{"put":{"tags":["Ai builder"],"summary":"Update grant","operationId":"putApiAiBuilderOrganizationsByorgidWalletGrantsBygrantid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Ai builder"],"summary":"Delete grant","operationId":"deleteApiAiBuilderOrganizationsByorgidWalletGrantsBygrantid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/my-grant":{"get":{"tags":["Ai builder"],"summary":"Member-facing \u2014 \"what's my allowance on this org's wallet?\"","operationId":"getApiAiBuilderOrganizationsByorgidWalletMyGrant","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/owner-card":{"get":{"tags":["Ai builder"],"summary":"List owner card","operationId":"getApiAiBuilderOrganizationsByorgidWalletOwnerCard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/topup":{"post":{"tags":["Ai builder"],"summary":"Create topup","operationId":"postApiAiBuilderOrganizationsByorgidWalletTopup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/topup-stripe":{"post":{"tags":["Ai builder"],"summary":"Create topup stripe","operationId":"postApiAiBuilderOrganizationsByorgidWalletTopupStripe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/transactions":{"get":{"tags":["Ai builder"],"summary":"List transactions","operationId":"getApiAiBuilderOrganizationsByorgidWalletTransactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/usage":{"get":{"tags":["Ai builder"],"summary":"Usage stats + transaction ledger (admin only)","operationId":"getApiAiBuilderOrganizationsByorgidWalletUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/organizations/{orgId}/wallet/usage-by-service":{"get":{"tags":["Ai builder"],"summary":"List usage by service","operationId":"getApiAiBuilderOrganizationsByorgidWalletUsageByService","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects":{"get":{"tags":["Ai builder"],"summary":"---- Projects ----","operationId":"getApiAiBuilderProjects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Ai builder"],"summary":"Create projects","operationId":"postApiAiBuilderProjects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}":{"get":{"tags":["Ai builder"],"summary":"Get project","operationId":"getApiAiBuilderProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Ai builder"],"summary":"Update project","operationId":"putApiAiBuilderProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Ai builder"],"summary":"Delete project","operationId":"deleteApiAiBuilderProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/archive":{"post":{"tags":["Ai builder"],"summary":"Create archive","operationId":"postApiAiBuilderProjectsByidArchive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/attachments":{"post":{"tags":["Ai builder"],"summary":"---- #274 Chat attachments (drag-drop images / CSV / screenshots) ----","operationId":"postApiAiBuilderProjectsByidAttachments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/clone":{"post":{"tags":["Ai builder"],"summary":"Create clone","operationId":"postApiAiBuilderProjectsByidClone","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/continue":{"post":{"tags":["Ai builder"],"summary":"Create continue","operationId":"postApiAiBuilderProjectsByidContinue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/messages":{"get":{"tags":["Ai builder"],"summary":"---- Messages + token usage ----","operationId":"getApiAiBuilderProjectsByidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Ai builder"],"summary":"Create messages","operationId":"postApiAiBuilderProjectsByidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/send":{"post":{"tags":["Ai builder"],"summary":"---- AI invocation (Phase 2) \u2014 calls the project's configured provider ----","operationId":"postApiAiBuilderProjectsByidSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/token-usage":{"get":{"tags":["Ai builder"],"summary":"List token usage","operationId":"getApiAiBuilderProjectsByidTokenUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/tool-calls":{"get":{"tags":["Ai builder"],"summary":"---- Phase 3: tool-call approval ----","operationId":"getApiAiBuilderProjectsByidToolCalls","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/projects/{id}/unarchive":{"post":{"tags":["Ai builder"],"summary":"Create unarchive","operationId":"postApiAiBuilderProjectsByidUnarchive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/tool-calls/{id}/approve":{"post":{"tags":["Ai builder"],"summary":"Create approve","operationId":"postApiAiBuilderToolCallsByidApprove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/tool-calls/{id}/reject":{"post":{"tags":["Ai builder"],"summary":"Create reject","operationId":"postApiAiBuilderToolCallsByidReject","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/topup-terms":{"get":{"tags":["Ai builder"],"summary":"The non-refundable acknowledgement every top-up form shows (Vault56\\Support\\AiCreditTerms).","operationId":"getApiAiBuilderTopupTerms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet":{"get":{"tags":["Ai builder"],"summary":"---- #211 Phase A: managed-mode wallet + tier catalog ----","operationId":"getApiAiBuilderWallet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/auto-recharge":{"post":{"tags":["Ai builder"],"summary":"Create auto recharge","operationId":"postApiAiBuilderWalletAutoRecharge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/daily-cap":{"put":{"tags":["Ai builder"],"summary":"Update daily cap","operationId":"putApiAiBuilderWalletDailyCap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/stripe-webhook":{"post":{"tags":["Ai builder"],"summary":"No auth \u2014 Stripe webhook receiver. Verifies signature internally.","operationId":"postApiAiBuilderWalletStripeWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/topup-checkout":{"post":{"tags":["Ai builder"],"summary":"Phase B: Stripe top-up, webhook, auto-recharge config, consent.","operationId":"postApiAiBuilderWalletTopupCheckout","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/transactions":{"get":{"tags":["Ai builder"],"summary":"List transactions","operationId":"getApiAiBuilderWalletTransactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-builder/wallet/usage-by-service":{"get":{"tags":["Ai builder"],"summary":"List usage by service","operationId":"getApiAiBuilderWalletUsageByService","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai-instructions":{"get":{"tags":["Ai instructions"],"summary":"AI integration instructions (public, serves VAULT56_API_USER_INSTRUCTIONS.md)","operationId":"getApiAiInstructions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/anomalies/{anomalyId}/resolve":{"post":{"tags":["Ai"],"summary":"Create resolve","operationId":"postApiAiAnomaliesByanomalyidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"anomalyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/configs":{"get":{"tags":["Ai"],"summary":"All of the user's AI configs across endpoints, keyed by endpoint (one query).","operationId":"getApiAiConfigs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/insights/{insightId}/dismiss":{"post":{"tags":["Ai"],"summary":"Create dismiss","operationId":"postApiAiInsightsByinsightidDismiss","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"insightId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/insights/{insightId}/rate":{"post":{"tags":["Ai"],"summary":"Create rate","operationId":"postApiAiInsightsByinsightidRate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"insightId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/v1/messages":{"post":{"tags":["vault56 AI Messages API"],"summary":"Create a message (wallet-paid)","description":"The widely used Messages API request format; SDKs and tools that let you set a base URL and an API key work with it. Base URL: `https://api.ng.vault56.com/api/ai`. The response `model` is the vault56 model name sent. Top-level fields other than those listed are dropped (including top-level `cache_control`). `cache_control` on blocks and tools is forwarded. Charged to the chosen wallet from actual usage: input, output, cache read and cache write each at their own price, plus EUR 0.005 per request; the balance, daily cap and grant must cover the worst case (estimated input + full `max_tokens`) beforehand. Non-streaming: response header `X-Vault56-Charge-Micros`. Streaming (`stream: true`): `text/event-stream` with the events in order, then the SSE comment `: vault56-charge-micros <n>` after `message_stop`; a stream cut off early ends with `event: error` (`upstream_interrupted`). Requires acceptance of the managed AI terms (403 `consent_required`). Other errors from the AI service are relayed with their status and body and are not charged. Scope `ai:invoke`.","operationId":"postApiAiV1Messages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string"},"description":"vault56 Code access token (what most SDKs send as the API key). `Authorization: Bearer <token>` works too, as does a user session JWT."},{"name":"X-Vault56-Wallet","in":"header","required":false,"schema":{"type":"string"},"description":"`personal` (default when absent) or `org:<organisation id>`. Needs an enabled grant on that organisation's wallet."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"A vault56 model. Responses report the same name. Anything else: 400 `model_not_allowed`","enum":["vault56-standard","vault56-premium","vault56-max"]},"max_tokens":{"type":"integer","description":"Clamped to the model ceiling (64000 vault56-standard, 128000 vault56-premium / vault56-max). Counts in full in the balance pre-check."},"messages":{"type":"array","description":"Messages; content blocks forwarded unchanged","items":{"type":"object"}},"system":{"type":"string","description":"String or array of text blocks"},"tools":{"type":"array","description":"Custom tools and types starting bash_, text_editor_, memory_, computer_, web_search_, web_fetch_. Other typed tools: 400 `tool_not_allowed`.","items":{"type":"object"}},"tool_choice":{"type":"object"},"stop_sequences":{"type":"array","items":{"type":"string"}},"temperature":{"type":"number"},"top_p":{"type":"number"},"top_k":{"type":"integer"},"metadata":{"type":"object"},"stream":{"type":"boolean","description":"true = server-sent events"},"thinking":{"type":"object"},"output_config":{"type":"object","description":"Only `effort` is forwarded; every other key is dropped","properties":{"effort":{"type":"string","enum":["low","medium","high","max"]}}}},"required":["model","max_tokens","messages"]}}}},"responses":{"200":{"description":"Message object (or an event stream when `stream: true`)","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","example":"message"},"role":{"type":"string"},"content":{"type":"array","items":{"type":"object"}},"model":{"type":"string"},"stop_reason":{"type":"string"},"stop_sequence":{"type":"string","nullable":true},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"cache_creation_input_tokens":{"type":"integer"},"cache_read_input_tokens":{"type":"integer"}}}}}}}},"400":{"description":"`invalid_request_error`: `invalid_json`, `model_required`, `messages_required`, `max_tokens_required`, `model_not_allowed`, `invalid_tools`, `tool_not_allowed`, `wallet_invalid` (or a relayed 400 from the AI service).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"401":{"description":"`authentication_error` / `invalid_token`: no credential, or it is invalid or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"402":{"description":"`billing_error`: `wallet_insufficient_funds`, `daily_cap_reached`, `org_grant_required`, `org_grant_exhausted`.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"403":{"description":"`permission_error`: `token_not_allowed`, `consent_required` (accept the managed AI terms), `wallet_not_allowed` (not a member / no organisation wallet).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"429":{"description":"`rate_limit_error` / `rate_limited` (600 requests per minute per token) or `concurrency_limit` (too many requests in flight; `Retry-After: 5`).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"`api_error`: `upstream_unreachable` or `upstream_error`. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}}}}},"/api/ai/v1/messages/count_tokens":{"post":{"tags":["vault56 AI Messages API"],"summary":"Count tokens (free)","description":"Counts the input tokens of a request. Free: no wallet, no charge, no terms acceptance needed. Same model allow-list and tool rules as messages; only `model`, `system`, `messages`, `tools`, `tool_choice`, `thinking` are forwarded. Scope `ai:invoke`.","operationId":"postApiAiV1MessagesCountTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string"},"description":"vault56 Code access token (what most SDKs send as the API key). `Authorization: Bearer <token>` works too, as does a user session JWT."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"A vault56 model. Responses report the same name. Anything else: 400 `model_not_allowed`","enum":["vault56-standard","vault56-premium","vault56-max"]},"messages":{"type":"array","description":"Messages; content blocks forwarded unchanged","items":{"type":"object"}},"system":{"type":"string","description":"String or array of text blocks"},"tools":{"type":"array","description":"Custom tools and types starting bash_, text_editor_, memory_, computer_, web_search_, web_fetch_. Other typed tools: 400 `tool_not_allowed`.","items":{"type":"object"}},"tool_choice":{"type":"object"},"thinking":{"type":"object"}},"required":["model","messages"]}}}},"responses":{"200":{"description":"Token count","content":{"application/json":{"schema":{"type":"object","properties":{"input_tokens":{"type":"integer"}}}}}},"400":{"description":"`invalid_request_error` (same codes as messages, minus the wallet ones).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"401":{"description":"`authentication_error` / `invalid_token`: no credential, or it is invalid or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"403":{"description":"`permission_error` / `token_not_allowed`: not a Vault56 Code token, or the scope is missing.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"429":{"description":"`rate_limit_error` / `rate_limited` (600 requests per minute per token) or `concurrency_limit` (too many requests in flight; `Retry-After: 5`).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"`api_error`: `upstream_unreachable` or `upstream_error`.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}}}}},"/api/ai/v1/models":{"get":{"tags":["vault56 AI Messages API"],"summary":"List models","description":"The vault56 models (`vault56-standard`, `vault56-premium`, `vault56-max`) in the Messages API list shape (`data`, `has_more`, `first_id`, `last_id`). Each model adds a `vault56` block with EUR prices per million tokens (input, output, cache read, cache write 5m / 1h) and the per-request fee. Free. Scope `ai:invoke`.","operationId":"getApiAiV1Models","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string"},"description":"vault56 Code access token (what most SDKs send as the API key). `Authorization: Bearer <token>` works too, as does a user session JWT."}],"responses":{"200":{"description":"Models","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"model"},"id":{"type":"string","example":"vault56-premium"},"display_name":{"type":"string"},"created_at":{"type":"string"},"max_input_tokens":{"type":"integer"},"max_tokens":{"type":"integer"},"vault56":{"type":"object","properties":{"tier":{"type":"string"},"currency":{"type":"string"},"price_per_mtok_input":{"type":"number"},"price_per_mtok_output":{"type":"number"},"price_per_mtok_cache_read":{"type":"number"},"price_per_mtok_cache_write_5m":{"type":"number"},"price_per_mtok_cache_write_1h":{"type":"number"},"per_request_fee":{"type":"number"},"long_prompt":{"type":"object","nullable":true,"properties":{"above_prompt_tokens":{"type":"integer"},"price_per_mtok_input":{"type":"number"},"price_per_mtok_output":{"type":"number"},"price_per_mtok_cache_read":{"type":"number"},"price_per_mtok_cache_write_5m":{"type":"number"},"price_per_mtok_cache_write_1h":{"type":"number"}}}}}}}},"has_more":{"type":"boolean"},"first_id":{"type":"string"},"last_id":{"type":"string"}}}}}},"401":{"description":"`authentication_error` / `invalid_token`: no credential, or it is invalid or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"403":{"description":"`permission_error` / `token_not_allowed`: not a Vault56 Code token, or the scope is missing.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"429":{"description":"`rate_limit_error` / `rate_limited` (600 requests per minute per token) or `concurrency_limit` (too many requests in flight; `Retry-After: 5`).","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/v1/models/{id}":{"get":{"tags":["vault56 AI Messages API"],"summary":"Get one model","description":"One entry of the models list. Scope `ai:invoke`.","operationId":"getApiAiV1ModelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Model id, e.g. `vault56-premium`"},{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string"},"description":"vault56 Code access token (what most SDKs send as the API key). `Authorization: Bearer <token>` works too, as does a user session JWT."}],"responses":{"200":{"description":"Model","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"`authentication_error` / `invalid_token`: no credential, or it is invalid or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"403":{"description":"`permission_error` / `token_not_allowed`: not a Vault56 Code token, or the scope is missing.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"404":{"description":"`not_found_error` / `model_not_allowed`: not available through vault56 AI.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"error"},"error":{"type":"object","properties":{"type":{"type":"string","description":"Error type (Messages API error envelope)"},"message":{"type":"string"},"vault56_code":{"type":"string","description":"The platform reason; absent on errors relayed from the AI service"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ai/wallets":{"get":{"tags":["vault56 AI Messages API"],"summary":"List the AI wallets you may spend from","description":"Personal wallet first (`default: true`), then each organisation wallet on which you hold an enabled grant. The `id` is the value for `X-Vault56-Wallet`. Amounts are EUR micros. Platform envelope, not the Messages API's. Scope `wallets:read` (Vault56 Code token) or a user session JWT.","operationId":"getApiAiWallets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string"},"description":"vault56 Code access token (what most SDKs send as the API key). `Authorization: Bearer <token>` works too, as does a user session JWT."}],"responses":{"200":{"description":"Wallets","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"wallets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"personal"},"type":{"type":"string","enum":["personal","organization"]},"org_id":{"type":"string"},"name":{"type":"string"},"balance_micros":{"type":"integer"},"currency":{"type":"string","example":"EUR"},"grant":{"type":"object","properties":{"enabled":{"type":"boolean"},"period_type":{"type":"string","enum":["day","week","month","total"]},"period_limit_micros":{"type":"integer","nullable":true},"period_spent_micros":{"type":"integer"},"remaining_micros":{"type":"integer"}}},"daily_cap_micros":{"type":"integer"},"spent_today_micros":{"type":"integer"},"remaining_today_micros":{"type":"integer"},"default":{"type":"boolean"}}}}}}}}}}},"401":{"description":"No valid credential (platform envelope, `error.type: authentication_error`)"},"403":{"description":"Not a Vault56 Code token, or scope `wallets:read` missing"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/alert-rules":{"get":{"tags":["Alert rules"],"summary":"Global rules (apply to all agents the owner can see)","operationId":"getApiAlertRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Alert rules"],"summary":"Create alert rules","operationId":"postApiAlertRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/alert-rules/{ruleId}":{"patch":{"tags":["Alert rules"],"summary":"Update an alert rule","description":"**Access:** rule owner (agent shares do not apply).\n\nMerged with the existing rule and validated as a whole.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"patchApiAlertRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rule_name":{"type":"string","description":"1-80 chars"},"description":{"type":"string"},"metric_type":{"type":"string","enum":["cpu_percent","memory_percent","disk_percent","cpu_load","load_avg_1m","load_avg_5m","load_avg_15m","network_rx_mbps","network_tx_mbps","network_total_mbps","smart_reallocated_sectors","smart_pending_sectors"]},"threshold_value":{"type":"number"},"comparison":{"type":"string","enum":["gt","gte","lt","lte"]},"duration_seconds":{"type":"integer","description":"0-86400"},"cooldown_minutes":{"type":"integer","description":"0-10080"},"is_enabled":{"type":"boolean"},"notify_email_account_id":{"type":"string","format":"uuid","nullable":true},"notify_destination_email":{"type":"string","format":"email","nullable":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Rule not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Alert rules"],"summary":"Single-rule ops","operationId":"getApiAlertRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Alert rules"],"summary":"Delete alert rule","operationId":"deleteApiAlertRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/anomalies":{"get":{"tags":["Analytics"],"summary":"List anomalies","operationId":"getApiAnalyticsAnomalies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/charts/{chartId}":{"put":{"tags":["Analytics"],"summary":"Chart routes that use @chartId directly","operationId":"putApiAnalyticsChartsBychartid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"chartId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Analytics"],"summary":"Delete chart","operationId":"deleteApiAnalyticsChartsBychartid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"chartId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/charts/{chartId}/data":{"get":{"tags":["Analytics"],"summary":"List data","operationId":"getApiAnalyticsChartsBychartidData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"chartId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/dashboards":{"post":{"tags":["Analytics"],"summary":"Dashboard CRUD","operationId":"postApiAnalyticsDashboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Analytics"],"summary":"List dashboards","operationId":"getApiAnalyticsDashboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/dashboards/{dashboardId}":{"get":{"tags":["Analytics"],"summary":"Main dashboard resource routes AFTER sub-resource routes","operationId":"getApiAnalyticsDashboardsBydashboardid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Analytics"],"summary":"Update dashboard","operationId":"putApiAnalyticsDashboardsBydashboardid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Analytics"],"summary":"Delete dashboard","operationId":"deleteApiAnalyticsDashboardsBydashboardid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/dashboards/{dashboardId}/charts":{"post":{"tags":["Analytics"],"summary":"Dashboard sub-resource routes","operationId":"postApiAnalyticsDashboardsBydashboardidCharts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Analytics"],"summary":"List charts","operationId":"getApiAnalyticsDashboardsBydashboardidCharts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/dashboards/{dashboardId}/embed-tokens":{"post":{"tags":["Analytics"],"summary":"Create embed tokens","operationId":"postApiAnalyticsDashboardsBydashboardidEmbedTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Analytics"],"summary":"List embed tokens","operationId":"getApiAnalyticsDashboardsBydashboardidEmbedTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/dashboards/{dashboardId}/refresh":{"post":{"tags":["Analytics"],"summary":"Create refresh","operationId":"postApiAnalyticsDashboardsBydashboardidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/embed-tokens/{tokenId}":{"delete":{"tags":["Analytics"],"summary":"Embed token revoke (uses @tokenId directly)","operationId":"deleteApiAnalyticsEmbedTokensBytokenid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/embed/{token}":{"get":{"tags":["Analytics"],"summary":"Embedded dashboard (public, NO auth)","operationId":"getApiAnalyticsEmbedBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/endpoints":{"get":{"tags":["Analytics"],"summary":"List endpoints","operationId":"getApiAnalyticsEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/endpoints/{id}/stats":{"get":{"tags":["Analytics"],"summary":"List stats","operationId":"getApiAnalyticsEndpointsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/errors":{"get":{"tags":["Analytics"],"summary":"List errors","operationId":"getApiAnalyticsErrors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/geographic":{"get":{"tags":["Analytics"],"summary":"List geographic","operationId":"getApiAnalyticsGeographic","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/latency":{"get":{"tags":["Analytics"],"summary":"List latency","operationId":"getApiAnalyticsLatency","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/metrics":{"get":{"tags":["Analytics"],"summary":"Custom metrics","operationId":"getApiAnalyticsMetrics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Analytics"],"summary":"Create metrics","operationId":"postApiAnalyticsMetrics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/metrics/{id}":{"delete":{"tags":["Analytics"],"summary":"Delete metric","operationId":"deleteApiAnalyticsMetricsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/metrics/{id}/record":{"post":{"tags":["Analytics"],"summary":"Create record","operationId":"postApiAnalyticsMetricsByidRecord","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/metrics/{id}/values":{"get":{"tags":["Analytics"],"summary":"List values","operationId":"getApiAnalyticsMetricsByidValues","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/pageviews-bulk":{"get":{"tags":["Analytics"],"summary":"Daily pageview series for every site the user can see, in one query.","operationId":"getApiAnalyticsPageviewsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/realtime":{"get":{"tags":["Analytics"],"summary":"List realtime","operationId":"getApiAnalyticsRealtime","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites":{"post":{"tags":["Analytics"],"summary":"Site CRUD","operationId":"postApiAnalyticsSites","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Analytics"],"summary":"List sites","operationId":"getApiAnalyticsSites","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}":{"get":{"tags":["Analytics"],"summary":"Get site","operationId":"getApiAnalyticsSitesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Analytics"],"summary":"Update site","operationId":"putApiAnalyticsSitesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Analytics"],"summary":"Delete site","operationId":"deleteApiAnalyticsSitesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/alerts":{"post":{"tags":["Analytics"],"summary":"Alerts","operationId":"postApiAnalyticsSitesByidAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Analytics"],"summary":"List alerts","operationId":"getApiAnalyticsSitesByidAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/alerts/{alertId}":{"put":{"tags":["Analytics"],"summary":"Update alert","operationId":"putApiAnalyticsSitesByidAlertsByalertid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alertId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Analytics"],"summary":"Delete alert","operationId":"deleteApiAnalyticsSitesByidAlertsByalertid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alertId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/countries":{"get":{"tags":["Analytics"],"summary":"List countries","operationId":"getApiAnalyticsSitesByidCountries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/dashboard":{"get":{"tags":["Analytics"],"summary":"Dashboard & Analytics","operationId":"getApiAnalyticsSitesByidDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/devices":{"get":{"tags":["Analytics"],"summary":"List devices","operationId":"getApiAnalyticsSitesByidDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/events":{"get":{"tags":["Analytics"],"summary":"daily series and top property values (Studio track(), v56a.event).","operationId":"getApiAnalyticsSitesByidEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/pageviews":{"get":{"tags":["Analytics"],"summary":"List pageviews","operationId":"getApiAnalyticsSitesByidPageviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/privacy":{"get":{"tags":["Analytics"],"summary":"List privacy","operationId":"getApiAnalyticsSitesByidPrivacy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/realtime":{"get":{"tags":["Analytics"],"summary":"List realtime","operationId":"getApiAnalyticsSitesByidRealtime","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/shares":{"get":{"tags":["Analytics"],"summary":"Sharing","operationId":"getApiAnalyticsSitesByidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Analytics"],"summary":"Create shares","operationId":"postApiAnalyticsSitesByidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/shares/{shareId}":{"delete":{"tags":["Analytics"],"summary":"Delete share","operationId":"deleteApiAnalyticsSitesByidSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/snippet":{"get":{"tags":["Analytics"],"summary":"Snippet","operationId":"getApiAnalyticsSitesByidSnippet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/top-cities":{"get":{"tags":["Analytics"],"summary":"Top cities for a country drill-down (Migration 487).","operationId":"getApiAnalyticsSitesByidTopCities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/top-pages":{"get":{"tags":["Analytics"],"summary":"List top pages","operationId":"getApiAnalyticsSitesByidTopPages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/top-referrers":{"get":{"tags":["Analytics"],"summary":"List top referrers","operationId":"getApiAnalyticsSitesByidTopReferrers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/utm":{"get":{"tags":["Analytics"],"summary":"List utm","operationId":"getApiAnalyticsSitesByidUtm","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/visitors/{vid}":{"delete":{"tags":["Analytics"],"summary":"GDPR","operationId":"deleteApiAnalyticsSitesByidVisitorsByvid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/visitors/{vid}/export":{"get":{"tags":["Analytics"],"summary":"List export","operationId":"getApiAnalyticsSitesByidVisitorsByvidExport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/visitors/{visitorId}":{"get":{"tags":["Analytics"],"summary":"Per-visitor drill-down (summary + bot signals + event list)","operationId":"getApiAnalyticsSitesByidVisitorsByvisitorid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"visitorId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/sites/{id}/visits":{"get":{"tags":["Analytics"],"summary":"Recent Visits","operationId":"getApiAnalyticsSitesByidVisits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/analytics/summary":{"get":{"tags":["Analytics"],"summary":"List summary","operationId":"getApiAnalyticsSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/annotations/{annotationId}":{"delete":{"tags":["Annotations"],"summary":"Remove an annotation (by annotation ID)","operationId":"deleteApiAnnotationsByannotationid","security":[],"parameters":[{"name":"annotationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/alerts":{"get":{"tags":["Anomaly"],"summary":"Alerts (all source types)","operationId":"getApiAnomalyAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/alerts/acknowledge-all":{"post":{"tags":["Anomaly"],"summary":"Create acknowledge all","operationId":"postApiAnomalyAlertsAcknowledgeAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/alerts/{id}":{"get":{"tags":["Anomaly"],"summary":"Get alert","operationId":"getApiAnomalyAlertsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/alerts/{id}/acknowledge":{"post":{"tags":["Anomaly"],"summary":"Create acknowledge","operationId":"postApiAnomalyAlertsByidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/alerts/{id}/resolve":{"post":{"tags":["Anomaly"],"summary":"Create resolve","operationId":"postApiAnomalyAlertsByidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/baselines":{"get":{"tags":["Anomaly"],"summary":"Baselines","operationId":"getApiAnomalyBaselines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/baselines/{sourceType}/{subjectType}/{subjectId}":{"get":{"tags":["Anomaly"],"summary":"Get baseline","operationId":"getApiAnomalyBaselinesBysourcetypeBysubjecttypeBysubjectid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"sourceType","in":"path","required":true,"schema":{"type":"string"}},{"name":"subjectType","in":"path","required":true,"schema":{"type":"string"}},{"name":"subjectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/check":{"post":{"tags":["Anomaly"],"summary":"Manual security check","operationId":"postApiAnomalyCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/config":{"get":{"tags":["Anomaly"],"summary":"Configuration (combined security + usage)","operationId":"getApiAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Anomaly"],"summary":"Update config","operationId":"putApiAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/stats":{"get":{"tags":["Anomaly"],"summary":"Stats (unified dashboard)","operationId":"getApiAnomalyStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anomaly/usage-summary":{"get":{"tags":["Anomaly"],"summary":"Usage summary","operationId":"getApiAnomalyUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/anonymize":{"post":{"tags":["Anonymization"],"summary":"Anonymization & Generation jobs","operationId":"postApiAnonymizationAnonymize","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/generate":{"post":{"tags":["Anonymization"],"summary":"Create generate","operationId":"postApiAnonymizationGenerate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/jobs":{"get":{"tags":["Anonymization"],"summary":"Job management","operationId":"getApiAnonymizationJobs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/jobs/{id}":{"get":{"tags":["Anonymization"],"summary":"Get job","operationId":"getApiAnonymizationJobsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/jobs/{id}/cancel":{"post":{"tags":["Anonymization"],"summary":"Create cancel","operationId":"postApiAnonymizationJobsByidCancel","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/preview":{"post":{"tags":["Anonymization"],"summary":"Preview","operationId":"postApiAnonymizationPreview","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/profiles":{"get":{"tags":["Anonymization"],"summary":"Profile CRUD","operationId":"getApiAnonymizationProfiles","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Anonymization"],"summary":"Create profiles","operationId":"postApiAnonymizationProfiles","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/profiles/{id}":{"get":{"tags":["Anonymization"],"summary":"Get profile","operationId":"getApiAnonymizationProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Anonymization"],"summary":"Update profile","operationId":"putApiAnonymizationProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Anonymization"],"summary":"Delete profile","operationId":"deleteApiAnonymizationProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/anonymization/strategies":{"get":{"tags":["Anonymization"],"summary":"Strategies list (no auth needed for reference)","operationId":"getApiAnonymizationStrategies","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events":{"get":{"tags":["App events"],"summary":"List app events","operationId":"getApiAppEvents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["App events"],"summary":"Create app events","operationId":"postApiAppEvents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events/available":{"get":{"tags":["App events"],"summary":"------------------------------------------------------------------","operationId":"getApiAppEventsAvailable","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events/dead-letter":{"get":{"tags":["App events"],"summary":"List dead letter","operationId":"getApiAppEventsDeadLetter","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events/dead-letter/{id}/retry":{"post":{"tags":["App events"],"summary":"Create retry","operationId":"postApiAppEventsDeadLetterByidRetry","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events/{id}":{"get":{"tags":["App events"],"summary":"Get app event","operationId":"getApiAppEventsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["App events"],"summary":"Update app event","operationId":"putApiAppEventsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["App events"],"summary":"Delete app event","operationId":"deleteApiAppEventsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-events/{id}/deliveries":{"get":{"tags":["App events"],"summary":"List deliveries","operationId":"getApiAppEventsByidDeliveries","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-hooks/{appId}/{slug}":{"post":{"tags":["App hooks"],"summary":"Public inbound webhook receiver \u2014 NO AUTH","operationId":"postApiAppHooksByappidByslug","security":[],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["App hooks"],"summary":"Update app hook","operationId":"putApiAppHooksByappidByslug","security":[],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-webhooks":{"get":{"tags":["App webhooks"],"summary":"------------------------------------------------------------------","operationId":"getApiAppWebhooks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["App webhooks"],"summary":"Create app webhooks","operationId":"postApiAppWebhooks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-webhooks/{id}":{"get":{"tags":["App webhooks"],"summary":"Get app webhook","operationId":"getApiAppWebhooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["App webhooks"],"summary":"Update app webhook","operationId":"putApiAppWebhooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["App webhooks"],"summary":"Delete app webhook","operationId":"deleteApiAppWebhooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-webhooks/{id}/deliveries":{"get":{"tags":["App webhooks"],"summary":"List deliveries","operationId":"getApiAppWebhooksByidDeliveries","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-webhooks/{id}/regenerate-secret":{"post":{"tags":["App webhooks"],"summary":"Create regenerate secret","operationId":"postApiAppWebhooksByidRegenerateSecret","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers":{"get":{"tags":["App workers"],"summary":"------------------------------------------------------------------","operationId":"getApiAppWorkers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["App workers"],"summary":"Create app workers","operationId":"postApiAppWorkers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers/{id}":{"get":{"tags":["App workers"],"summary":"Get app worker","operationId":"getApiAppWorkersByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["App workers"],"summary":"Update app worker","operationId":"putApiAppWorkersByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["App workers"],"summary":"Delete app worker","operationId":"deleteApiAppWorkersByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers/{id}/logs":{"get":{"tags":["App workers"],"summary":"List logs","operationId":"getApiAppWorkersByidLogs","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers/{id}/restart":{"post":{"tags":["App workers"],"summary":"Create restart","operationId":"postApiAppWorkersByidRestart","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers/{id}/start":{"post":{"tags":["App workers"],"summary":"Create start","operationId":"postApiAppWorkersByidStart","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/app-workers/{id}/stop":{"post":{"tags":["App workers"],"summary":"Create stop","operationId":"postApiAppWorkersByidStop","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications":{"get":{"tags":["Applications"],"summary":"Applications","operationId":"getApiApplications","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create applications","operationId":"postApiApplications","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/invitations/accept":{"post":{"tags":["Applications"],"summary":"Accept invitation (POST - for API calls)","operationId":"postApiApplicationsInvitationsAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"Accept invitation (GET - for email links, handles redirect to login if not authenticated)","operationId":"getApiApplicationsInvitationsAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/tier-addons/{addonId}":{"put":{"tags":["Applications"],"summary":"Update tier addon","operationId":"putApiApplicationsTierAddonsByaddonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"addonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete tier addon","operationId":"deleteApiApplicationsTierAddonsByaddonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"addonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/access":{"get":{"tags":["Applications"],"summary":"List access","operationId":"getApiApplicationsByappidAccess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/allowlist":{"get":{"tags":["Applications"],"summary":"#251 \u2014 Private-app email allowlist. Caller must own the app.","operationId":"getApiApplicationsByappidAllowlist","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create allowlist","operationId":"postApiApplicationsByappidAllowlist","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/allowlist/{entryId}":{"delete":{"tags":["Applications"],"summary":"Delete allowlist","operationId":"deleteApiApplicationsByappidAllowlistByentryid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta":{"put":{"tags":["Applications"],"summary":"============================================","operationId":"putApiApplicationsByappidBeta","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete beta","operationId":"deleteApiApplicationsByappidBeta","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List beta","operationId":"getApiApplicationsByappidBeta","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/feedback":{"get":{"tags":["Applications"],"summary":"============================================","operationId":"getApiApplicationsByappidBetaFeedback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create feedback","operationId":"postApiApplicationsByappidBetaFeedback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/feedback/mine":{"get":{"tags":["Applications"],"summary":"List mine","operationId":"getApiApplicationsByappidBetaFeedbackMine","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/feedback/{feedbackId}":{"put":{"tags":["Applications"],"summary":"Update feedback","operationId":"putApiApplicationsByappidBetaFeedbackByfeedbackid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"feedbackId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/invitations":{"post":{"tags":["Applications"],"summary":"Create invitations","operationId":"postApiApplicationsByappidBetaInvitations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List invitations","operationId":"getApiApplicationsByappidBetaInvitations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/invitations/{id}":{"delete":{"tags":["Applications"],"summary":"Delete invitation","operationId":"deleteApiApplicationsByappidBetaInvitationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/join":{"post":{"tags":["Applications"],"summary":"Create join","operationId":"postApiApplicationsByappidBetaJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/link":{"post":{"tags":["Applications"],"summary":"Create link","operationId":"postApiApplicationsByappidBetaLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/beta/users":{"get":{"tags":["Applications"],"summary":"List users","operationId":"getApiApplicationsByappidBetaUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/bundle":{"post":{"tags":["Applications"],"summary":"POST /api/web-apps/{web_app_id}/versions for subsequent versions.","operationId":"postApiApplicationsByappidBundle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/capabilities":{"post":{"tags":["Applications"],"summary":"in a single transaction. CRM feedback #1.","operationId":"postApiApplicationsByappidCapabilities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/edge-events":{"get":{"tags":["Applications"],"summary":"============================================","operationId":"getApiApplicationsByappidEdgeEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/endpoints":{"get":{"tags":["Applications"],"summary":"List endpoints","operationId":"getApiApplicationsByappidEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create endpoints","operationId":"postApiApplicationsByappidEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/endpoints/bulk-link":{"post":{"tags":["Applications"],"summary":"Bulk-link endpoints by prefix or namespace","operationId":"postApiApplicationsByappidEndpointsBulkLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/endpoints/feature-keys":{"put":{"tags":["Applications"],"summary":"Bind bundled endpoints to the feature keys that unlock them (publisher)","description":"Only the endpoints named are changed; an empty list removes an endpoint's gate. All or nothing. A request for a gated endpoint is then refused (403 upgrade_required) unless the workspace owner's tier or add-ons include one of its keys. With ?dry_run=1 nothing is written (a super admin may dry-run any app).","operationId":"putApiApplicationsByappidEndpointsFeatureKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string"},"description":"The application"},{"name":"dry_run","in":"query","required":false,"schema":{"type":"string"},"description":"Validate exactly as for real (the same 422s) and write NOTHING; the answer reports which active subscriber workspaces the mapping would refuse what: dry_run, written (false), would_update, changes, gated_endpoints_before/after, workspaces {evaluated, publisher_exempt, with_refusals, with_new_refusals, members_in_refused_workspaces, truncated}, refused_by_endpoint and a sample of 25 workspaces."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpoints":{"type":"object","description":"endpoint name or id => list of feature keys"}},"required":["endpoints"]}}}},"responses":{"200":{"description":"Saved (gated_endpoints), or with dry_run the report of what it would refuse"},"400":{"description":"No mapping given, or more than 1000 endpoints"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not your application"},"422":{"description":"An endpoint the app does not bundle, or a feature key no tier or add-on of the app grants: nothing written (unknown_endpoints, unknown_feature_keys)"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/endpoints/{endpointId}/feature-keys":{"put":{"tags":["Applications"],"summary":"Set one bundled endpoint's feature keys (publisher)","description":"The one-endpoint form of PUT /api/applications/{appId}/endpoints/feature-keys; [] removes the gate. Takes ?dry_run=1 too.","operationId":"putApiApplicationsByappidEndpointsByendpointidFeatureKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string"},"description":"The application"},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string"},"description":"A bundled endpoint of the app"},{"name":"dry_run","in":"query","required":false,"schema":{"type":"string"},"description":"Validate exactly as for real (the same 422s) and write NOTHING; the answer reports which active subscriber workspaces the mapping would refuse what: dry_run, written (false), would_update, changes, gated_endpoints_before/after, workspaces {evaluated, publisher_exempt, with_refusals, with_new_refusals, members_in_refused_workspaces, truncated}, refused_by_endpoint and a sample of 25 workspaces."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feature_keys":{"type":"array","description":"Feature keys; [] removes the gate"}},"required":["feature_keys"]}}}},"responses":{"200":{"description":"Saved (gated_endpoints), or with dry_run the report of what it would refuse"},"400":{"description":"No mapping given, or more than 1000 endpoints"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not your application"},"422":{"description":"An endpoint the app does not bundle, or a feature key no tier or add-on of the app grants: nothing written (unknown_endpoints, unknown_feature_keys)"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/endpoints/{endpointId}/label":{"put":{"tags":["Applications"],"summary":"Publisher sets a human-readable label for a bundled endpoint","operationId":"putApiApplicationsByappidEndpointsByendpointidLabel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/entitlement-check":{"get":{"tags":["Applications"],"summary":"What the endpoint gate will decide for a user (publisher)","description":"Read-only. For one subscriber -- and optionally a workspace they were invited to -- the subscription the endpoint gate judges by (the workspace owner's direct subscription), its tier and add-ons, how it was chosen, the feature set, and allowed/refused for every gated endpoint. Also names what would refuse the user before the gate (no_subscription, trial_expired, no_invitation). Give user_id (and optionally owner_id), or subscription_id: an invited subscription means the inviter's workspace. Only the app's publisher, or a super admin; only users who hold a subscription to this application.","operationId":"getApiApplicationsByappidEntitlementCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string"},"description":"The application"},{"name":"user_id","in":"query","required":false,"schema":{"type":"string"},"description":"The subscriber to check"},{"name":"owner_id","in":"query","required":false,"schema":{"type":"string"},"description":"The workspace owner (as X-App-Owner); omitted or equal to user_id = their own workspace"},{"name":"subscription_id","in":"query","required":false,"schema":{"type":"string"},"description":"Check by subscription instead: its holder, in the workspace it describes"}],"responses":{"200":{"description":"application, user, workspace {owner_id, owner_email, kind own|invited, invitation_accepted}, saved_workspace_choice, publisher_exempt, refused_before_gate, judged_by {subscription_id, subscription_type, status, tier, addons, rule, candidates}, features, gated_endpoints, refused_endpoints, endpoints"},"400":{"description":"Neither user_id nor subscription_id, or not a UUID"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not your application, or the user / owner holds no subscription to it"},"422":{"description":"subscription_id belongs to a different user than user_id"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/external-cookies":{"delete":{"tags":["Applications"],"summary":"Clear the server-side cookie jar for a host (logout / hygiene). #309 P2.","operationId":"deleteApiApplicationsByappidExternalCookies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/external-credentials":{"post":{"tags":["Applications"],"summary":"Create external credentials","operationId":"postApiApplicationsByappidExternalCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/external-hosts":{"get":{"tags":["Applications"],"summary":"Publisher: manage the per-app egress allowlist + external credentials.","operationId":"getApiApplicationsByappidExternalHosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create external hosts","operationId":"postApiApplicationsByappidExternalHosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/external-hosts/{hostId}":{"delete":{"tags":["Applications"],"summary":"Delete external host","operationId":"deleteApiApplicationsByappidExternalHostsByhostid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"hostId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/features":{"get":{"tags":["Applications"],"summary":"Feature Entitlements","operationId":"getApiApplicationsByappidFeatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create features","operationId":"postApiApplicationsByappidFeatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/features/check":{"post":{"tags":["Applications"],"summary":"Bulk feature access check (must be before the @featureId routes)","operationId":"postApiApplicationsByappidFeaturesCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/features/{featureId}":{"put":{"tags":["Applications"],"summary":"Update feature","operationId":"putApiApplicationsByappidFeaturesByfeatureid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"featureId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete feature","operationId":"deleteApiApplicationsByappidFeaturesByfeatureid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"featureId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/features/{featureKey}/check":{"get":{"tags":["Applications"],"summary":"List check","operationId":"getApiApplicationsByappidFeaturesByfeaturekeyCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"featureKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/icon":{"get":{"tags":["Applications"],"summary":"Get an application icon (public for a listed app; ETag; 404 otherwise)","operationId":"getApiApplicationsByappidIcon","security":[],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Upload an application icon (publisher only; PNG or SVG, square, <=256 KB)","operationId":"postApiApplicationsByappidIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Clear an application icon (publisher only)","operationId":"deleteApiApplicationsByappidIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/namespaces":{"post":{"tags":["Applications"],"summary":"Application Namespace Linking","operationId":"postApiApplicationsByappidNamespaces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List namespaces","operationId":"getApiApplicationsByappidNamespaces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/namespaces/{nsId}":{"delete":{"tags":["Applications"],"summary":"Delete namespace","operationId":"deleteApiApplicationsByappidNamespacesBynsid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"nsId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/permission-group-templates":{"get":{"tags":["Applications"],"summary":"new subscriber at subscription-creation time.","operationId":"getApiApplicationsByappidPermissionGroupTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Create permission group templates","operationId":"postApiApplicationsByappidPermissionGroupTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/permission-group-templates/{templateId}":{"get":{"tags":["Applications"],"summary":"Get permission group template","operationId":"getApiApplicationsByappidPermissionGroupTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Applications"],"summary":"Update permission group template","operationId":"putApiApplicationsByappidPermissionGroupTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete permission group template","operationId":"deleteApiApplicationsByappidPermissionGroupTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/permission-group-templates/{templateId}/endpoints-bulk":{"put":{"tags":["Applications"],"summary":"Literal `endpoints-bulk` registered before the @templateId routes.","operationId":"putApiApplicationsByappidPermissionGroupTemplatesBytemplateidEndpointsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/pricing-tiers":{"post":{"tags":["Applications"],"summary":"Create pricing tiers","operationId":"postApiApplicationsByappidPricingTiers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/pricing-tiers/reorder":{"put":{"tags":["Applications"],"summary":"in registration order). Same pattern as bundle/transfer routes elsewhere.","operationId":"putApiApplicationsByappidPricingTiersReorder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/pricing-tiers/{tierId}":{"put":{"tags":["Applications"],"summary":"Update pricing tier","operationId":"putApiApplicationsByappidPricingTiersBytierid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete pricing tier","operationId":"deleteApiApplicationsByappidPricingTiersBytierid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/screenshots":{"post":{"tags":["Applications"],"summary":"Screenshots","operationId":"postApiApplicationsByappidScreenshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List screenshots","operationId":"getApiApplicationsByappidScreenshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/screenshots/reorder":{"put":{"tags":["Applications"],"summary":"Update reorder","operationId":"putApiApplicationsByappidScreenshotsReorder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/screenshots/{screenshotId}":{"delete":{"tags":["Applications"],"summary":"Delete screenshot","operationId":"deleteApiApplicationsByappidScreenshotsByscreenshotid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"screenshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/screenshots/{screenshotId}/file":{"get":{"tags":["Applications"],"summary":"a.is_active, which leaked non-public apps' screenshots.","operationId":"getApiApplicationsByappidScreenshotsByscreenshotidFile","security":[],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"screenshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscribe":{"post":{"tags":["Applications"],"summary":"Subscriptions","operationId":"postApiApplicationsByappidSubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscribers":{"get":{"tags":["Applications"],"summary":"Subscribers (publisher view)","operationId":"getApiApplicationsByappidSubscribers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}":{"get":{"tags":["Applications"],"summary":"publisher). These fill the gap.","operationId":"getApiApplicationsByappidSubscriptionsBysubid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/addons":{"get":{"tags":["Applications"],"summary":"List addons","operationId":"getApiApplicationsByappidSubscriptionsBysubidAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Applications"],"summary":"Publisher grant/revoke addon (no billing) \u2014 CRM feedback #7.","operationId":"postApiApplicationsByappidSubscriptionsBysubidAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/addons/{addonId}":{"delete":{"tags":["Applications"],"summary":"Delete addon","operationId":"deleteApiApplicationsByappidSubscriptionsBysubidAddonsByaddonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"addonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/extend-trial":{"post":{"tags":["Applications"],"summary":"Subscription management","operationId":"postApiApplicationsByappidSubscriptionsBysubidExtendTrial","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/metered-usage":{"post":{"tags":["Applications"],"summary":"two concerns clearly separated.","operationId":"postApiApplicationsByappidSubscriptionsBysubidMeteredUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"units=0 entries for ones that haven't been reported yet this period).","operationId":"getApiApplicationsByappidSubscriptionsBysubidMeteredUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/metered-usage/history":{"get":{"tags":["Applications"],"summary":"subscription detail page. Newest first.","operationId":"getApiApplicationsByappidSubscriptionsBysubidMeteredUsageHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/subscriptions/{subId}/usage":{"get":{"tags":["Applications"],"summary":"List usage","operationId":"getApiApplicationsByappidSubscriptionsBysubidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/tier-addons/usage-summary":{"get":{"tags":["Applications"],"summary":"active / this-period revenue\" column without N+1 calls.","operationId":"getApiApplicationsByappidTierAddonsUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/tier-addons/{addonId}/usage-summary":{"get":{"tags":["Applications"],"summary":"revenue estimate (for flat). Includes top-10 subscriber rows.","operationId":"getApiApplicationsByappidTierAddonsByaddonidUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"addonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{appId}/trial-config":{"put":{"tags":["Applications"],"summary":"Trial Configuration","operationId":"putApiApplicationsByappidTrialConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}":{"get":{"tags":["Applications"],"summary":"Get application","operationId":"getApiApplicationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Applications"],"summary":"Update application","operationId":"putApiApplicationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete application","operationId":"deleteApiApplicationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/consumers":{"get":{"tags":["Applications"],"summary":"List consumers","operationId":"getApiApplicationsByidConsumers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/consumers/{cid}":{"get":{"tags":["Applications"],"summary":"Get consumer","operationId":"getApiApplicationsByidConsumersBycid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Applications"],"summary":"Update consumer","operationId":"putApiApplicationsByidConsumersBycid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete consumer","operationId":"deleteApiApplicationsByidConsumersBycid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/oauth-providers":{"post":{"tags":["Applications"],"summary":"Create oauth providers","operationId":"postApiApplicationsByidOauthProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List oauth providers","operationId":"getApiApplicationsByidOauthProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/oauth-providers/{pid}":{"put":{"tags":["Applications"],"summary":"Update oauth provider","operationId":"putApiApplicationsByidOauthProvidersBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Applications"],"summary":"Delete oauth provider","operationId":"deleteApiApplicationsByidOauthProvidersBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/tier-addons":{"post":{"tags":["Applications"],"summary":"Publisher: manage add-ons attached to their application","operationId":"postApiApplicationsByidTierAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List tier addons","operationId":"getApiApplicationsByidTierAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/applications/{id}/whitelabel-auth":{"put":{"tags":["Applications"],"summary":"Publisher management endpoints (platform auth required)","operationId":"putApiApplicationsByidWhitelabelAuth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Applications"],"summary":"List whitelabel auth","operationId":"getApiApplicationsByidWhitelabelAuth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests":{"post":{"tags":["Approval requests"],"summary":"--- Approval Requests ---","operationId":"postApiApprovalRequests","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/pending":{"get":{"tags":["Approval requests"],"summary":"List pending","operationId":"getApiApprovalRequestsPending","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}":{"get":{"tags":["Approval requests"],"summary":"Get approval request","operationId":"getApiApprovalRequestsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/approve":{"post":{"tags":["Approval requests"],"summary":"Create approve","operationId":"postApiApprovalRequestsByidApprove","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/cancel":{"post":{"tags":["Approval requests"],"summary":"Create cancel","operationId":"postApiApprovalRequestsByidCancel","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/certificate":{"get":{"tags":["Approval requests"],"summary":"List certificate","operationId":"getApiApprovalRequestsByidCertificate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/reject":{"post":{"tags":["Approval requests"],"summary":"Create reject","operationId":"postApiApprovalRequestsByidReject","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/request-changes":{"post":{"tags":["Approval requests"],"summary":"Create request changes","operationId":"postApiApprovalRequestsByidRequestChanges","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-requests/{id}/verify":{"post":{"tags":["Approval requests"],"summary":"--- Digital Signatures: Verification & Compliance ---","operationId":"postApiApprovalRequestsByidVerify","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/approval-workflows/{id}":{"get":{"tags":["Approval Workflows"],"summary":"Get approval workflow","operationId":"getApiApprovalWorkflowsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Approval Workflows"],"summary":"Update approval workflow","operationId":"putApiApprovalWorkflowsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Approval Workflows"],"summary":"Delete approval workflow","operationId":"deleteApiApprovalWorkflowsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/apps/{appId}/endpoints/{endpointId}/schema-pin":{"put":{"tags":["Apps"],"summary":"Update schema pin","operationId":"putApiAppsByappidEndpointsByendpointidSchemaPin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/apps/{appSlug}/webhooks/inbound":{"get":{"tags":["Apps"],"summary":"============================================","operationId":"getApiAppsByappslugWebhooksInbound","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Apps"],"summary":"Create inbound","operationId":"postApiAppsByappslugWebhooksInbound","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/apps/{appSlug}/webhooks/inbound/{id}":{"get":{"tags":["Apps"],"summary":"Get inbound","operationId":"getApiAppsByappslugWebhooksInboundByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Apps"],"summary":"Update inbound","operationId":"putApiAppsByappslugWebhooksInboundByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Apps"],"summary":"Delete inbound","operationId":"deleteApiAppsByappslugWebhooksInboundByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/apps/{appSlug}/webhooks/inbound/{id}/deliveries":{"get":{"tags":["Apps"],"summary":"List deliveries","operationId":"getApiAppsByappslugWebhooksInboundByidDeliveries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/apps/{appSlug}/webhooks/inbound/{id}/secret/regenerate":{"post":{"tags":["Apps"],"summary":"Create regenerate","operationId":"postApiAppsByappslugWebhooksInboundByidSecretRegenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}":{"get":{"tags":["Attachments"],"summary":"Get attachment","operationId":"getApiAttachmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Attachments"],"summary":"Delete attachment","operationId":"deleteApiAttachmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/delta/config":{"put":{"tags":["Attachments"],"summary":"Update config","operationId":"putApiAttachmentsByidDeltaConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/delta/disable":{"post":{"tags":["Attachments"],"summary":"Create disable","operationId":"postApiAttachmentsByidDeltaDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/delta/enable":{"post":{"tags":["Attachments"],"summary":"============================================","operationId":"postApiAttachmentsByidDeltaEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/delta/stats":{"get":{"tags":["Attachments"],"summary":"List stats","operationId":"getApiAttachmentsByidDeltaStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/download":{"get":{"tags":["Attachments"],"summary":"List download","operationId":"getApiAttachmentsByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions":{"post":{"tags":["Attachments"],"summary":"Create revisions","operationId":"postApiAttachmentsByidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Attachments"],"summary":"List revisions","operationId":"getApiAttachmentsByidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/compare":{"get":{"tags":["Attachments"],"summary":"and this handler never runs. Enforced by bin/route-check.php.","operationId":"getApiAttachmentsByidRevisionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/disable":{"post":{"tags":["Attachments"],"summary":"Create disable","operationId":"postApiAttachmentsByidRevisionsDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/enable":{"post":{"tags":["Attachments"],"summary":"----- File Attachment Revisions Routes -----","operationId":"postApiAttachmentsByidRevisionsEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/{revisionNumber}":{"get":{"tags":["Attachments"],"summary":"Get revision","operationId":"getApiAttachmentsByidRevisionsByrevisionnumber","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Attachments"],"summary":"Delete revision","operationId":"deleteApiAttachmentsByidRevisionsByrevisionnumber","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/{revisionNumber}/download":{"get":{"tags":["Attachments"],"summary":"List download","operationId":"getApiAttachmentsByidRevisionsByrevisionnumberDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/attachments/{id}/revisions/{revisionNumber}/restore":{"post":{"tags":["Attachments"],"summary":"Create restore","operationId":"postApiAttachmentsByidRevisionsByrevisionnumberRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways":{"post":{"tags":["Auth gateways"],"summary":"--- Management API (authenticated, feature-gated) ---","operationId":"postApiAuthGateways","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Auth gateways"],"summary":"List auth gateways","operationId":"getApiAuthGateways","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/providers/{providerId}":{"put":{"tags":["Auth gateways"],"summary":"Update provider","operationId":"putApiAuthGatewaysProvidersByproviderid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Auth gateways"],"summary":"Delete provider","operationId":"deleteApiAuthGatewaysProvidersByproviderid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/shares/{shareId}":{"put":{"tags":["Auth gateways"],"summary":"these together and after them avoids relying on that.","operationId":"putApiAuthGatewaysSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Auth gateways"],"summary":"Delete share","operationId":"deleteApiAuthGatewaysSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/slug-available":{"get":{"tags":["Auth gateways"],"summary":"stays true if the anchor is ever loosened.","operationId":"getApiAuthGatewaysSlugAvailable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/transfer-requests/{token}":{"get":{"tags":["Auth gateways"],"summary":"Get transfer request","operationId":"getApiAuthGatewaysTransferRequestsBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/transfer-requests/{token}/accept":{"post":{"tags":["Auth gateways"],"summary":"Create accept","operationId":"postApiAuthGatewaysTransferRequestsBytokenAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/transfer-requests/{token}/decline":{"post":{"tags":["Auth gateways"],"summary":"Create decline","operationId":"postApiAuthGatewaysTransferRequestsBytokenDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/users/{userId}":{"put":{"tags":["Auth gateways"],"summary":"Update user","operationId":"putApiAuthGatewaysUsersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}":{"get":{"tags":["Auth gateways"],"summary":"Get auth gateway","operationId":"getApiAuthGatewaysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Auth gateways"],"summary":"Update auth gateway","operationId":"putApiAuthGatewaysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Auth gateways"],"summary":"Delete auth gateway","operationId":"deleteApiAuthGatewaysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/audit-log":{"get":{"tags":["Auth gateways"],"summary":"List audit log","operationId":"getApiAuthGatewaysByidAuditLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/duplicate":{"post":{"tags":["Auth gateways"],"summary":"paid gateway limit.","operationId":"postApiAuthGatewaysByidDuplicate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/providers":{"get":{"tags":["Auth gateways"],"summary":"--- Provider management ---","operationId":"getApiAuthGatewaysByidProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Auth gateways"],"summary":"Create providers","operationId":"postApiAuthGatewaysByidProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/rotate-keys":{"post":{"tags":["Auth gateways"],"summary":"Create rotate keys","operationId":"postApiAuthGatewaysByidRotateKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/shares":{"get":{"tags":["Auth gateways"],"summary":"and must not consume anyone's gateway allowance.","operationId":"getApiAuthGatewaysByidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Auth gateways"],"summary":"Create shares","operationId":"postApiAuthGatewaysByidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/transfer":{"post":{"tags":["Auth gateways"],"summary":"--- Ownership transfer (mirrors DNS transfer pattern) ---","operationId":"postApiAuthGatewaysByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/usage":{"get":{"tags":["Auth gateways"],"summary":"List usage","operationId":"getApiAuthGatewaysByidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth-gateways/{id}/users":{"get":{"tags":["Auth gateways"],"summary":"List users","operationId":"getApiAuthGatewaysByidUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens":{"post":{"tags":["Authentication"],"summary":"Create app token","operationId":"postApiAuthAppTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Authentication"],"summary":"List app tokens","operationId":"getApiAuthAppTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/me":{"get":{"tags":["Authentication"],"summary":"Works with X-App-Token auth; returns 400 for JWT sessions.","operationId":"getApiAuthAppTokensMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}":{"get":{"tags":["Authentication"],"summary":"Get single app token","operationId":"getApiAuthAppTokensByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Authentication"],"summary":"Update app token","operationId":"putApiAuthAppTokensByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Authentication"],"summary":"Revoke app token","operationId":"deleteApiAuthAppTokensByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}/regenerate":{"post":{"tags":["Authentication"],"summary":"Regenerate app token","operationId":"postApiAuthAppTokensByidRegenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}/rotate":{"post":{"tags":["Authentication"],"summary":"Rotate an app token","operationId":"postApiAuthAppTokensByidRotate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}/rotation":{"delete":{"tags":["Authentication"],"summary":"Cancel token rotation","operationId":"deleteApiAuthAppTokensByidRotation","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Authentication"],"summary":"Get rotation status","operationId":"getApiAuthAppTokensByidRotation","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}/rotation/complete":{"post":{"tags":["Authentication"],"summary":"Complete token rotation (revoke old token early)","operationId":"postApiAuthAppTokensByidRotationComplete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{id}/usage":{"get":{"tags":["Authentication"],"summary":"as part of a token id.","operationId":"getApiAuthAppTokensByidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{tokenId}/ip-restrictions":{"get":{"tags":["Authentication"],"summary":"Get full IP restrictions (allowed + denied) for a token","operationId":"getApiAuthAppTokensBytokenidIpRestrictions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{tokenId}/ip-restrictions/allowed":{"get":{"tags":["Authentication"],"summary":"Get allowed IPs","operationId":"getApiAuthAppTokensBytokenidIpRestrictionsAllowed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Authentication"],"summary":"Set allowed IPs","operationId":"putApiAuthAppTokensBytokenidIpRestrictionsAllowed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{tokenId}/ip-restrictions/check":{"post":{"tags":["Authentication"],"summary":"Check if a specific IP is allowed for this token","operationId":"postApiAuthAppTokensBytokenidIpRestrictionsCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{tokenId}/ip-restrictions/denied":{"get":{"tags":["Authentication"],"summary":"Get denied IPs","operationId":"getApiAuthAppTokensBytokenidIpRestrictionsDenied","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Authentication"],"summary":"Set denied IPs","operationId":"putApiAuthAppTokensBytokenidIpRestrictionsDenied","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/app-tokens/{tokenId}/schema-pins":{"put":{"tags":["Authentication"],"summary":"Update schema pins","operationId":"putApiAuthAppTokensBytokenidSchemaPins","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/change-password":{"post":{"tags":["Authentication"],"summary":"Change Password","operationId":"postApiAuthChangePassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/disable-2fa":{"post":{"tags":["Authentication"],"summary":"Disable 2FA","operationId":"postApiAuthDisable2fa","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/enable-2fa":{"post":{"tags":["Authentication"],"summary":"Enable 2FA","operationId":"postApiAuthEnable2fa","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/forgot-password":{"post":{"tags":["Authentication"],"summary":"Forgot password (public - sends reset email)","operationId":"postApiAuthForgotPassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/linked-accounts":{"get":{"tags":["Authentication"],"summary":"============================================","operationId":"getApiAuthLinkedAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Authentication"],"summary":"Create linked accounts","operationId":"postApiAuthLinkedAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/linked-accounts/forget":{"post":{"tags":["Authentication"],"summary":"Create forget","operationId":"postApiAuthLinkedAccountsForget","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/linked-accounts/switch":{"post":{"tags":["Authentication"],"summary":"/remember/forget: possession is the authority). Migration 813.","operationId":"postApiAuthLinkedAccountsSwitch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/linked-accounts/{linkedUserId}":{"delete":{"tags":["Authentication"],"summary":"Delete linked account","operationId":"deleteApiAuthLinkedAccountsBylinkeduserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"linkedUserId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/login":{"post":{"tags":["Authentication"],"summary":"Login","operationId":"postApiAuthLogin","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/logout":{"post":{"tags":["Authentication"],"summary":"Logout","operationId":"postApiAuthLogout","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/callback":{"post":{"tags":["Authentication"],"summary":"Handle OAuth callback (public)","operationId":"postApiAuthOauthCallback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/connections":{"get":{"tags":["Authentication"],"summary":"Get user's linked OAuth providers (protected)","operationId":"getApiAuthOauthConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/providers":{"get":{"tags":["Authentication"],"summary":"Get enabled OAuth providers (public)","operationId":"getApiAuthOauthProviders","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/{provider}":{"delete":{"tags":["Authentication"],"summary":"Unlink OAuth provider (protected)","operationId":"deleteApiAuthOauthByprovider","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/{provider}/authorize":{"get":{"tags":["Authentication"],"summary":"Get authorization URL for a provider (public)","operationId":"getApiAuthOauthByproviderAuthorize","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/oauth/{provider}/link":{"get":{"tags":["Authentication"],"summary":"Link OAuth provider to account (protected) - uses authorize with action=link","operationId":"getApiAuthOauthByproviderLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/payment-status":{"get":{"tags":["Authentication"],"summary":"Get payment status","operationId":"getApiAuthPaymentStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/profile":{"get":{"tags":["Authentication"],"summary":"Get current user profile","operationId":"getApiAuthProfile","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Authentication"],"summary":"Update current user profile (display_name)","operationId":"putApiAuthProfile","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/refresh":{"post":{"tags":["Authentication"],"summary":"Refresh token","operationId":"postApiAuthRefresh","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/register":{"post":{"tags":["Authentication"],"summary":"Register new user","operationId":"postApiAuthRegister","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/remember/check":{"post":{"tags":["Authentication"],"summary":"Create check","operationId":"postApiAuthRememberCheck","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/remember/forget":{"post":{"tags":["Authentication"],"summary":"Create forget","operationId":"postApiAuthRememberForget","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/remember/restore":{"post":{"tags":["Authentication"],"summary":"Public: the cookie value in the body is the credential, like a refresh token.","operationId":"postApiAuthRememberRestore","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/resend-verification":{"post":{"tags":["Authentication"],"summary":"This is public because users who can't log in (unverified) need to be able to resend","operationId":"postApiAuthResendVerification","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/reset-password":{"post":{"tags":["Authentication"],"summary":"Reset password (public - uses token from email)","operationId":"postApiAuthResetPassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/revoke":{"post":{"tags":["Authentication"],"summary":"Revoke the CURRENT session token (#203 / audit H16)","operationId":"postApiAuthRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/revoke-all":{"post":{"tags":["Authentication"],"summary":"Revoke ALL of the caller's sessions \u2014 \"log out everywhere\" (#203 / audit H16)","operationId":"postApiAuthRevokeAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/sessions/remembered":{"get":{"tags":["Authentication"],"summary":"on the app-token blocklist). X-Remember-Selector marks \"this browser\".","operationId":"getApiAuthSessionsRemembered","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/sessions/remembered/revoke-others":{"post":{"tags":["Authentication"],"summary":"Create revoke others","operationId":"postApiAuthSessionsRememberedRevokeOthers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/sessions/remembered/{id}":{"delete":{"tags":["Authentication"],"summary":"Delete remembered","operationId":"deleteApiAuthSessionsRememberedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/setup-2fa":{"post":{"tags":["Authentication"],"summary":"Setup 2FA","operationId":"postApiAuthSetup2fa","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/verification-status":{"get":{"tags":["Authentication"],"summary":"Email Verification - Get status (authenticated)","operationId":"getApiAuthVerificationStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/verify-2fa":{"post":{"tags":["Authentication"],"summary":"Verify 2FA code during login","operationId":"postApiAuthVerify2fa","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/verify-email":{"get":{"tags":["Authentication"],"summary":"Email verification (public endpoint)","operationId":"getApiAuthVerifyEmail","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/auth/verify-payment":{"post":{"tags":["Authentication"],"summary":"Verify payment (for manual or API-based payment verification)","operationId":"postApiAuthVerifyPayment","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-actions/{actionId}":{"put":{"tags":["Automation actions"],"summary":"Update automation action","operationId":"putApiAutomationActionsByactionid","security":[],"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Automation actions"],"summary":"Delete automation action","operationId":"deleteApiAutomationActionsByactionid","security":[],"parameters":[{"name":"actionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-flows":{"post":{"tags":["Automation flows"],"summary":"Create automation flows","operationId":"postApiAutomationFlows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Automation flows"],"summary":"List automation flows","operationId":"getApiAutomationFlows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-flows/{id}":{"get":{"tags":["Automation flows"],"summary":"Get automation flow","operationId":"getApiAutomationFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Automation flows"],"summary":"Update automation flow","operationId":"putApiAutomationFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Automation flows"],"summary":"Delete automation flow","operationId":"deleteApiAutomationFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-flows/{id}/runs":{"get":{"tags":["Automation flows"],"summary":"List runs","operationId":"getApiAutomationFlowsByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-flows/{id}/test":{"post":{"tags":["Automation flows"],"summary":"Create test","operationId":"postApiAutomationFlowsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automation-logs":{"get":{"tags":["Automation logs"],"summary":"Execution logs across all the user's rules, paginated (one query).","operationId":"getApiAutomationLogs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations":{"get":{"tags":["Automations"],"summary":"List ALL the user's automation rules across endpoints (one query). Before @id.","operationId":"getApiAutomations","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations/{id}":{"get":{"tags":["Automations"],"summary":"Get automation","operationId":"getApiAutomationsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Automations"],"summary":"Update automation","operationId":"putApiAutomationsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Automations"],"summary":"Delete automation","operationId":"deleteApiAutomationsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations/{id}/actions":{"post":{"tags":["Automations"],"summary":"--- Action CRUD ---","operationId":"postApiAutomationsByidActions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations/{id}/dry-run":{"post":{"tags":["Automations"],"summary":"Create dry run","operationId":"postApiAutomationsByidDryRun","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations/{id}/logs":{"get":{"tags":["Automations"],"summary":"--- Logs & Dry-Run ---","operationId":"getApiAutomationsByidLogs","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/automations/{id}/toggle":{"post":{"tags":["Automations"],"summary":"Create toggle","operationId":"postApiAutomationsByidToggle","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents":{"get":{"tags":["Backup"],"summary":"-------- Admin: agents + commands + jobs (require JWT or backup:admin) --------","operationId":"getApiBackupAgents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/enroll":{"post":{"tags":["Backup"],"summary":"-------- Agent (static segments registered before /agents/@id) --------","operationId":"postApiBackupAgentsEnroll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/commands/{commandId}/ack":{"post":{"tags":["Backup"],"summary":"Create ack","operationId":"postApiBackupAgentsMeCommandsBycommandidAck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"commandId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/jobs":{"post":{"tags":["Backup"],"summary":"Create jobs","operationId":"postApiBackupAgentsMeJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/jobs/{jobId}":{"patch":{"tags":["Backup"],"summary":"Patch job","operationId":"patchApiBackupAgentsMeJobsByjobid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/key-escrow/{escrowId}":{"put":{"tags":["Backup"],"summary":"Update key escrow","operationId":"putApiBackupAgentsMeKeyEscrowByescrowid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backup"],"summary":"Get key escrow","operationId":"getApiBackupAgentsMeKeyEscrowByescrowid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"escrowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/restore-commands/{commandId}/key":{"get":{"tags":["Backup"],"summary":"List key","operationId":"getApiBackupAgentsMeRestoreCommandsBycommandidKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"commandId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/status":{"post":{"tags":["Backup"],"summary":"Create status","operationId":"postApiBackupAgentsMeStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/me/sync":{"get":{"tags":["Backup"],"summary":"List sync","operationId":"getApiBackupAgentsMeSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}":{"get":{"tags":["Backup"],"summary":"Get agent","operationId":"getApiBackupAgentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Backup"],"summary":"Delete agent","operationId":"deleteApiBackupAgentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Backup"],"summary":"Patch agent","operationId":"patchApiBackupAgentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/commands":{"post":{"tags":["Backup"],"summary":"Create commands","operationId":"postApiBackupAgentsByidCommands","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backup"],"summary":"List commands","operationId":"getApiBackupAgentsByidCommands","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/commands/{commandId}":{"get":{"tags":["Backup"],"summary":"Get command","operationId":"getApiBackupAgentsByidCommandsBycommandid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"commandId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/encryption-key":{"post":{"tags":["Backup"],"summary":"Create encryption key","operationId":"postApiBackupAgentsByidEncryptionKey","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/escrows":{"get":{"tags":["Backup"],"summary":"List escrows","operationId":"getApiBackupAgentsByidEscrows","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/file-areas":{"put":{"tags":["Backup"],"summary":"Update file areas","operationId":"putApiBackupAgentsByidFileAreas","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/history":{"get":{"tags":["Backup"],"summary":"List history","operationId":"getApiBackupAgentsByidHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/jobs":{"get":{"tags":["Backup"],"summary":"List jobs","operationId":"getApiBackupAgentsByidJobs","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/jobs/{jobId}":{"delete":{"tags":["Backup"],"summary":"Delete job","operationId":"deleteApiBackupAgentsByidJobsByjobid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/move":{"post":{"tags":["Backup"],"summary":"Create move","operationId":"postApiBackupAgentsByidMove","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/agents/{id}/restore":{"post":{"tags":["Backup"],"summary":"Create restore","operationId":"postApiBackupAgentsByidRestore","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/apply-template":{"post":{"tags":["Backup"],"summary":"Create apply template","operationId":"postApiBackupApplyTemplate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/clear-template":{"post":{"tags":["Backup"],"summary":"Create clear template","operationId":"postApiBackupClearTemplate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/enrollment-tokens/{id}/revoke":{"post":{"tags":["Backup"],"summary":"Create revoke","operationId":"postApiBackupEnrollmentTokensByidRevoke","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/fleets":{"post":{"tags":["Backup"],"summary":"-------- Admin: fleets + enrollment tokens --------","operationId":"postApiBackupFleets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backup"],"summary":"List fleets","operationId":"getApiBackupFleets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/fleets/{id}":{"get":{"tags":["Backup"],"summary":"Get fleet","operationId":"getApiBackupFleetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Backup"],"summary":"Delete fleet","operationId":"deleteApiBackupFleetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/fleets/{id}/encryption-key":{"post":{"tags":["Backup"],"summary":"One-click \"set / clear the default backup template\" for a fleet or host.","operationId":"postApiBackupFleetsByidEncryptionKey","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/fleets/{id}/enrollment-tokens":{"post":{"tags":["Backup"],"summary":"Create enrollment tokens","operationId":"postApiBackupFleetsByidEnrollmentTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backup"],"summary":"List enrollment tokens","operationId":"getApiBackupFleetsByidEnrollmentTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/install.ps1":{"get":{"tags":["Custodia Backup"],"summary":"Custodia installer script for Windows","description":"The self-service installer, served as `text/plain; charset=utf-8` with this deployment's API address filled in: `irm <base>/api/backup/install.ps1 | iex`. Installs or upgrades custodia-agent and custodia, enrolls the machine with an enrollment token, stores the backup passphrase (never replacing an existing one) and starts the service. Contains no secret; the token is supplied by whoever runs it.","operationId":"getApiBackupInstallPs1","security":[],"responses":{"200":{"description":"The script (text/plain)"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/install.sh":{"get":{"tags":["Custodia Backup"],"summary":"Custodia installer script for Linux","description":"The self-service installer, served as `text/plain; charset=utf-8` with this deployment's API address filled in: `curl -fsSL <base>/api/backup/install.sh | sudo bash`. Installs or upgrades custodia-agent and custodia, enrolls the machine with an enrollment token, stores the backup passphrase (never replacing an existing one) and starts the service. Contains no secret; the token is supplied by whoever runs it.","operationId":"getApiBackupInstallSh","security":[],"responses":{"200":{"description":"The script (text/plain)"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/org-keys":{"get":{"tags":["Backup"],"summary":"live in the service so they hold for every caller, not just this route.","operationId":"getApiBackupOrgKeys","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/org-keys/rotate":{"post":{"tags":["Backup"],"summary":"Create rotate","operationId":"postApiBackupOrgKeysRotate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/org-keys/{id}/purge":{"post":{"tags":["Backup"],"summary":"Create purge","operationId":"postApiBackupOrgKeysByidPurge","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policies":{"post":{"tags":["Backup"],"summary":"Create policies","operationId":"postApiBackupPolicies","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backup"],"summary":"List policies","operationId":"getApiBackupPolicies","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policies/from-template":{"post":{"tags":["Backup"],"summary":"Create from template","operationId":"postApiBackupPoliciesFromTemplate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policies/{id}":{"get":{"tags":["Backup"],"summary":"Get policie","operationId":"getApiBackupPoliciesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Backup"],"summary":"Update policie","operationId":"putApiBackupPoliciesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Backup"],"summary":"Delete policie","operationId":"deleteApiBackupPoliciesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policies/{id}/assign":{"post":{"tags":["Backup"],"summary":"Create assign","operationId":"postApiBackupPoliciesByidAssign","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policies/{id}/history":{"get":{"tags":["Backup"],"summary":"List history","operationId":"getApiBackupPoliciesByidHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/policy-templates":{"get":{"tags":["Backup"],"summary":"-------- Admin: policies --------","operationId":"getApiBackupPolicyTemplates","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backup/signing-key":{"get":{"tags":["Backup"],"summary":"List signing key","operationId":"getApiBackupSigningKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups":{"post":{"tags":["Backups"],"summary":"Backup operations","operationId":"postApiBackups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Backups"],"summary":"List backups","operationId":"getApiBackups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/restore-jobs":{"get":{"tags":["Backups"],"summary":"List restore jobs","operationId":"getApiBackupsRestoreJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/restore-jobs/{id}":{"get":{"tags":["Backups"],"summary":"Get restore job","operationId":"getApiBackupsRestoreJobsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/schedules":{"get":{"tags":["Backups"],"summary":"List schedules","operationId":"getApiBackupsSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Backups"],"summary":"Create schedules","operationId":"postApiBackupsSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/schedules/validate-cron":{"get":{"tags":["Backups"],"summary":"List validate cron","operationId":"getApiBackupsSchedulesValidateCron","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/schedules/{id}":{"put":{"tags":["Backups"],"summary":"Update schedule","operationId":"putApiBackupsSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Backups"],"summary":"Delete schedule","operationId":"deleteApiBackupsSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/{id}":{"get":{"tags":["Backups"],"summary":"Get backup","operationId":"getApiBackupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Backups"],"summary":"Delete backup","operationId":"deleteApiBackupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/{id}/lock":{"post":{"tags":["Backups"],"summary":"Backup lock extension","operationId":"postApiBackupsByidLock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/backups/{id}/restore":{"post":{"tags":["Backups"],"summary":"Create restore","operationId":"postApiBackupsByidRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/batch-operations":{"post":{"tags":["Batch operations"],"summary":"----- Async Batch Operations Routes -----","operationId":"postApiBatchOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Batch operations"],"summary":"List batch operations","operationId":"getApiBatchOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/batch-operations/stats":{"get":{"tags":["Batch operations"],"summary":"List stats","operationId":"getApiBatchOperationsStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/batch-operations/{id}":{"get":{"tags":["Batch operations"],"summary":"Get batch operation","operationId":"getApiBatchOperationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Batch operations"],"summary":"Delete batch operation","operationId":"deleteApiBatchOperationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/batch-operations/{id}/retry":{"post":{"tags":["Batch operations"],"summary":"Create retry","operationId":"postApiBatchOperationsByidRetry","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/beta/accept/{token}":{"post":{"tags":["Beta"],"summary":"============================================","operationId":"postApiBetaAcceptBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/beta/decline/{token}":{"post":{"tags":["Beta"],"summary":"Create decline","operationId":"postApiBetaDeclineBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bidirectional-sync":{"post":{"tags":["Bidirectional sync"],"summary":"=============================================================================","operationId":"postApiBidirectionalSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Bidirectional sync"],"summary":"List bidirectional sync","operationId":"getApiBidirectionalSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bidirectional-sync/conflicts/{conflictId}/resolve":{"post":{"tags":["Bidirectional sync"],"summary":"Create resolve","operationId":"postApiBidirectionalSyncConflictsByconflictidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"conflictId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bidirectional-sync/{id}":{"get":{"tags":["Bidirectional sync"],"summary":"Get bidirectional sync","operationId":"getApiBidirectionalSyncByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Bidirectional sync"],"summary":"Update bidirectional sync","operationId":"putApiBidirectionalSyncByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Bidirectional sync"],"summary":"Delete bidirectional sync","operationId":"deleteApiBidirectionalSyncByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bidirectional-sync/{id}/conflicts":{"get":{"tags":["Bidirectional sync"],"summary":"=============================================================================","operationId":"getApiBidirectionalSyncByidConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bidirectional-sync/{id}/sync":{"post":{"tags":["Bidirectional sync"],"summary":"=============================================================================","operationId":"postApiBidirectionalSyncByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/calculate-all":{"post":{"tags":["Billing"],"summary":"Calculate all endpoint costs","operationId":"postApiBillingCalculateAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/compute-limits":{"get":{"tags":["Billing"],"summary":"Get user's compute limits","operationId":"getApiBillingComputeLimits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/compute-operations":{"get":{"tags":["Billing"],"summary":"Get user's most expensive operations","operationId":"getApiBillingComputeOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/compute-usage":{"get":{"tags":["Billing"],"summary":"Get current compute usage","operationId":"getApiBillingComputeUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/compute-usage/history":{"get":{"tags":["Billing"],"summary":"Get compute usage history","operationId":"getApiBillingComputeUsageHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/costs":{"get":{"tags":["Billing"],"summary":"Get cost breakdown for current or specified month","operationId":"getApiBillingCosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/costs-by-customer":{"get":{"tags":["Billing"],"summary":"List costs by customer","operationId":"getApiBillingCostsByCustomer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/costs-by-endpoint":{"get":{"tags":["Billing"],"summary":"Cost breakdowns","operationId":"getApiBillingCostsByEndpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/costs/history":{"get":{"tags":["Billing"],"summary":"Get cost history","operationId":"getApiBillingCostsHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customer-tags":{"get":{"tags":["Billing"],"summary":"List all customer tags","operationId":"getApiBillingCustomerTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customer-tags/bulk":{"put":{"tags":["Billing"],"summary":"Bulk customer tag assignment","operationId":"putApiBillingCustomerTagsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customers/{tag}/costs":{"get":{"tags":["Billing"],"summary":"Per-customer cost queries","operationId":"getApiBillingCustomersBytagCosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customers/{tag}/endpoints":{"get":{"tags":["Billing"],"summary":"Get endpoints by customer tag (alias for /api/endpoints/by-customer/@tag)","operationId":"getApiBillingCustomersBytagEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customers/{tag}/reports/{month}":{"post":{"tags":["Billing"],"summary":"Report generation and export","operationId":"postApiBillingCustomersBytagReportsBymonth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}},{"name":"month","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Billing"],"summary":"Get report","operationId":"getApiBillingCustomersBytagReportsBymonth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}},{"name":"month","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customers/{tag}/reports/{month}/csv":{"get":{"tags":["Billing"],"summary":"List csv","operationId":"getApiBillingCustomersBytagReportsBymonthCsv","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}},{"name":"month","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/customers/{tag}/reports/{month}/pdf":{"get":{"tags":["Billing"],"summary":"List pdf","operationId":"getApiBillingCustomersBytagReportsBymonthPdf","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}},{"name":"month","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/endpoints/{id}/calculate":{"post":{"tags":["Billing"],"summary":"Create calculate","operationId":"postApiBillingEndpointsByidCalculate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/endpoints/{id}/costs":{"get":{"tags":["Billing"],"summary":"Per-endpoint cost queries","operationId":"getApiBillingEndpointsByidCosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/estimate":{"post":{"tags":["Billing"],"summary":"Estimate costs from hypothetical config (authenticated)","operationId":"postApiBillingEstimate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/estimate/defaults":{"get":{"tags":["Billing"],"summary":"Get rate card defaults (public \u2014 no auth required)","operationId":"getApiBillingEstimateDefaults","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/invoices":{"get":{"tags":["Billing"],"summary":"List user's own invoices","operationId":"getApiBillingInvoices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/invoices/{id}":{"get":{"tags":["Billing"],"summary":"Get a specific invoice","operationId":"getApiBillingInvoicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/invoices/{id}/pay":{"post":{"tags":["Billing"],"summary":"Pay an outstanding invoice with user's default payment method","operationId":"postApiBillingInvoicesByidPay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/invoices/{id}/pay-link":{"post":{"tags":["Billing"],"summary":"a trail of live tokens behind.","operationId":"postApiBillingInvoicesByidPayLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/invoices/{id}/pdf":{"get":{"tags":["Billing"],"summary":"Download invoice as PDF","operationId":"getApiBillingInvoicesByidPdf","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/me/feature-pricing/{featureKey}":{"get":{"tags":["Billing"],"summary":"display cannot drift from the actual charge.","operationId":"getApiBillingMeFeaturePricingByfeaturekey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"featureKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/my-plan":{"get":{"tags":["Billing"],"summary":"List my plan","operationId":"getApiBillingMyPlan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/org-summaries":{"get":{"tags":["Billing"],"summary":"Each org is gated by the same owner/admin check as the per-org endpoint.","operationId":"getApiBillingOrgSummaries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/payment-link":{"post":{"tags":["Billing"],"summary":"Generate payment page link","operationId":"postApiBillingPaymentLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/payment-method":{"get":{"tags":["Billing"],"summary":"Get current payment method","operationId":"getApiBillingPaymentMethod","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/payment-method/{id}":{"delete":{"tags":["Billing"],"summary":"Remove a payment method","operationId":"deleteApiBillingPaymentMethodByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/payment-methods":{"get":{"tags":["Billing"],"summary":"Get all payment methods","operationId":"getApiBillingPaymentMethods","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/plans":{"get":{"tags":["Billing"],"summary":"List plans","operationId":"getApiBillingPlans","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/quota-summary":{"get":{"tags":["Billing"],"summary":"panel's preemptive limit warnings.","operationId":"getApiBillingQuotaSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/rate-overrides":{"get":{"tags":["Billing"],"summary":"Get rate overrides applied to the user","operationId":"getApiBillingRateOverrides","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/rates":{"get":{"tags":["Billing"],"summary":"Get effective rates for the user","operationId":"getApiBillingRates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/settings":{"get":{"tags":["Billing"],"summary":"Get billing details (name, address, company, VAT)","operationId":"getApiBillingSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Billing"],"summary":"Update billing details","operationId":"putApiBillingSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/standing":{"get":{"tags":["Billing"],"summary":"stopped account; the admin panel reads it to decide where to send it.","operationId":"getApiBillingStanding","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/stripe-status":{"get":{"tags":["Billing"],"summary":"Get Stripe configuration status","operationId":"getApiBillingStripeStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/subscribe":{"post":{"tags":["Billing"],"summary":"Create subscribe","operationId":"postApiBillingSubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/subscription":{"delete":{"tags":["Billing"],"summary":"Delete subscription","operationId":"deleteApiBillingSubscription","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/trial":{"get":{"tags":["Billing"],"summary":"Get current trial status","operationId":"getApiBillingTrial","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/trial/check":{"get":{"tags":["Billing"],"summary":"Check if user can proceed with trial limits","operationId":"getApiBillingTrialCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/usage":{"get":{"tags":["Billing"],"summary":"Get current usage and estimated costs","operationId":"getApiBillingUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/usage-summary":{"get":{"tags":["Billing"],"summary":"Kept: this one reports real metered usage. Only its plan fields are gone.","operationId":"getApiBillingUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/validate-vat":{"post":{"tags":["Billing"],"summary":"Validate EU VAT number via VIES","operationId":"postApiBillingValidateVat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/vouchers":{"get":{"tags":["Billing"],"summary":"List vouchers","operationId":"getApiBillingVouchers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/vouchers/redeem":{"post":{"tags":["Billing"],"summary":"============================================","operationId":"postApiBillingVouchersRedeem","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/billing/vouchers/{id}/activate":{"post":{"tags":["Billing"],"summary":"Create activate","operationId":"postApiBillingVouchersByidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards":{"post":{"tags":["Boards"],"summary":"Board CRUD","operationId":"postApiBoards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Boards"],"summary":"List boards","operationId":"getApiBoards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}":{"get":{"tags":["Boards"],"summary":"Main resource routes AFTER sub-resource routes","operationId":"getApiBoardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Boards"],"summary":"Update board","operationId":"putApiBoardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Boards"],"summary":"Delete board","operationId":"deleteApiBoardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/columns/{column}/reorder":{"put":{"tags":["Boards"],"summary":"Update reorder","operationId":"putApiBoardsByidColumnsBycolumnReorder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"column","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/counts":{"get":{"tags":["Boards"],"summary":"List counts","operationId":"getApiBoardsByidCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/duplicate":{"post":{"tags":["Boards"],"summary":"Create duplicate","operationId":"postApiBoardsByidDuplicate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/move":{"post":{"tags":["Boards"],"summary":"Create move","operationId":"postApiBoardsByidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/sync":{"post":{"tags":["Boards"],"summary":"Create sync","operationId":"postApiBoardsByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/boards/{id}/view":{"get":{"tags":["Boards"],"summary":"Sub-resource routes BEFORE /@id to prevent FlightPHP matching them as an ID","operationId":"getApiBoardsByidView","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bookmarks":{"post":{"tags":["Bookmarks"],"summary":"--- Record Bookmarks / Favorites ---","operationId":"postApiBookmarks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Bookmarks"],"summary":"List bookmarks","operationId":"getApiBookmarks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bookmarks/check":{"get":{"tags":["Bookmarks"],"summary":"List check","operationId":"getApiBookmarksCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bookmarks/{endpointId}/{recordId}":{"delete":{"tags":["Bookmarks"],"summary":"Delete bookmark","operationId":"deleteApiBookmarksByendpointidByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bundles":{"get":{"tags":["Bundles"],"summary":"List bundles","operationId":"getApiBundles","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bundles/instantiate":{"post":{"tags":["Bundles"],"summary":"Create instantiate","operationId":"postApiBundlesInstantiate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bundles/{slug}":{"get":{"tags":["Bundles"],"summary":"Get bundle","operationId":"getApiBundlesByslug","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/bundles/{slug}/preflight":{"get":{"tags":["Bundles"],"summary":"the user up-front instead of letting them hit a 402 mid-install.","operationId":"getApiBundlesByslugPreflight","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cache/stats":{"get":{"tags":["Cache"],"summary":"List stats","operationId":"getApiCacheStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/calculated-fields":{"get":{"tags":["Calculated fields"],"summary":"Registered before the /@id route so the bare path isn't swallowed by it.","operationId":"getApiCalculatedFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/calculated-fields/{id}":{"get":{"tags":["Calculated fields"],"summary":"Get a single calculated field","operationId":"getApiCalculatedFieldsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Calculated fields"],"summary":"Update a calculated field","operationId":"putApiCalculatedFieldsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Calculated fields"],"summary":"Delete a calculated field","operationId":"deleteApiCalculatedFieldsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/calculated-fields/{id}/evaluate":{"post":{"tags":["Calculated fields"],"summary":"Evaluate a single calculated field","operationId":"postApiCalculatedFieldsByidEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/calculated-fields/{id}/refresh":{"post":{"tags":["Calculated fields"],"summary":"Refresh cache for a calculated field","operationId":"postApiCalculatedFieldsByidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments":{"post":{"tags":["Canary deployments"],"summary":"--- CRUD ---","operationId":"postApiCanaryDeployments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Canary deployments"],"summary":"List canary deployments","operationId":"getApiCanaryDeployments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}":{"get":{"tags":["Canary deployments"],"summary":"Get canary deployment","operationId":"getApiCanaryDeploymentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Canary deployments"],"summary":"Update canary deployment","operationId":"putApiCanaryDeploymentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Canary deployments"],"summary":"Delete canary deployment","operationId":"deleteApiCanaryDeploymentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}/check-health":{"post":{"tags":["Canary deployments"],"summary":"Create check health","operationId":"postApiCanaryDeploymentsByidCheckHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}/metrics":{"get":{"tags":["Canary deployments"],"summary":"--- Health & Metrics ---","operationId":"getApiCanaryDeploymentsByidMetrics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}/promote":{"post":{"tags":["Canary deployments"],"summary":"Create promote","operationId":"postApiCanaryDeploymentsByidPromote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}/start":{"post":{"tags":["Canary deployments"],"summary":"--- Lifecycle Operations ---","operationId":"postApiCanaryDeploymentsByidStart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/canary-deployments/{id}/stop":{"post":{"tags":["Canary deployments"],"summary":"Create stop","operationId":"postApiCanaryDeploymentsByidStop","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/capability-tokens":{"get":{"tags":["Capability tokens"],"summary":"List all user's tokens (static route before parameterized)","operationId":"getApiCapabilityTokens","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/capability-tokens/{tokenId}":{"get":{"tags":["Capability tokens"],"summary":"Single token operations","operationId":"getApiCapabilityTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Capability tokens"],"summary":"Update capability token","operationId":"putApiCapabilityTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Capability tokens"],"summary":"Delete capability token","operationId":"deleteApiCapabilityTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/capability-tokens/{tokenId}/revoke":{"post":{"tags":["Capability tokens"],"summary":"Create revoke","operationId":"postApiCapabilityTokensBytokenidRevoke","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams":{"post":{"tags":["Cdc streams"],"summary":"--- Stream CRUD ---","operationId":"postApiCdcStreams","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cdc streams"],"summary":"List cdc streams","operationId":"getApiCdcStreams","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams/{id}":{"get":{"tags":["Cdc streams"],"summary":"Get cdc stream","operationId":"getApiCdcStreamsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cdc streams"],"summary":"Update cdc stream","operationId":"putApiCdcStreamsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cdc streams"],"summary":"Delete cdc stream","operationId":"deleteApiCdcStreamsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams/{id}/cursor":{"post":{"tags":["Cdc streams"],"summary":"--- Cursor Management ---","operationId":"postApiCdcStreamsByidCursor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cdc streams"],"summary":"List cursor","operationId":"getApiCdcStreamsByidCursor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams/{id}/events":{"post":{"tags":["Cdc streams"],"summary":"--- Event Publishing & Consumption ---","operationId":"postApiCdcStreamsByidEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cdc streams"],"summary":"List events","operationId":"getApiCdcStreamsByidEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams/{id}/replay":{"post":{"tags":["Cdc streams"],"summary":"--- Replay & Stats ---","operationId":"postApiCdcStreamsByidReplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cdc-streams/{id}/stats":{"get":{"tags":["Cdc streams"],"summary":"List stats","operationId":"getApiCdcStreamsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests":{"get":{"tags":["Change requests"],"summary":"List change requests (across all endpoints the user has access to)","operationId":"getApiChangeRequests","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/bulk-action":{"post":{"tags":["Change requests"],"summary":"Bulk action on multiple change requests","operationId":"postApiChangeRequestsBulkAction","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}":{"get":{"tags":["Change requests"],"summary":"Get a single change request with diffs","operationId":"getApiChangeRequestsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Change requests"],"summary":"Update the proposed changes (requester only, while pending)","operationId":"putApiChangeRequestsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/approve":{"post":{"tags":["Change requests"],"summary":"Approve a change request (endpoint owner only)","operationId":"postApiChangeRequestsByidApprove","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/comments":{"get":{"tags":["Change requests"],"summary":"List comments on a change request","operationId":"getApiChangeRequestsByidComments","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Change requests"],"summary":"Add a comment to a change request","operationId":"postApiChangeRequestsByidComments","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/conflicts":{"get":{"tags":["Change requests"],"summary":"Detect conflicts with current record state","operationId":"getApiChangeRequestsByidConflicts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/history":{"get":{"tags":["Change requests"],"summary":"Get history of a change request","operationId":"getApiChangeRequestsByidHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/reject":{"post":{"tags":["Change requests"],"summary":"Reject a change request (endpoint owner only)","operationId":"postApiChangeRequestsByidReject","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/change-requests/{id}/withdraw":{"post":{"tags":["Change requests"],"summary":"Withdraw a change request (requester only)","operationId":"postApiChangeRequestsByidWithdraw","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels":{"get":{"tags":["Channels"],"summary":"List user's channels","operationId":"getApiChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Channels"],"summary":"Create a new channel","operationId":"postApiChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/derived":{"get":{"tags":["Channels"],"summary":"List derived channels","operationId":"getApiChannelsDerived","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Channels"],"summary":"Create derived channel","operationId":"postApiChannelsDerived","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/derived/{id}":{"get":{"tags":["Channels"],"summary":"Get derived channel","operationId":"getApiChannelsDerivedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Channels"],"summary":"Delete derived channel","operationId":"deleteApiChannelsDerivedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/derived/{publicId}/data":{"get":{"tags":["Channels"],"summary":"Get derived channel data (public)","operationId":"getApiChannelsDerivedBypublicidData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups":{"get":{"tags":["Channels"],"summary":"List channel groups","operationId":"getApiChannelsGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Channels"],"summary":"Create channel group","operationId":"postApiChannelsGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}":{"get":{"tags":["Channels"],"summary":"Get channel group","operationId":"getApiChannelsGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Channels"],"summary":"Update channel group","operationId":"putApiChannelsGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Channels"],"summary":"Delete channel group","operationId":"deleteApiChannelsGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}/aggregate":{"get":{"tags":["Channels"],"summary":"Aggregate across group","operationId":"getApiChannelsGroupsByidAggregate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}/channels":{"get":{"tags":["Channels"],"summary":"Get channels in group","operationId":"getApiChannelsGroupsByidChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}/data":{"get":{"tags":["Channels"],"summary":"Combined data from all channels in group","operationId":"getApiChannelsGroupsByidData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}/latest":{"get":{"tags":["Channels"],"summary":"Latest record from each channel in group","operationId":"getApiChannelsGroupsByidLatest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/groups/{id}/subscribe":{"get":{"tags":["Channels"],"summary":"SSE subscription for all channels in group","operationId":"getApiChannelsGroupsByidSubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/anomalies/{anomalyId}/acknowledge":{"post":{"tags":["Channels"],"summary":"Acknowledge anomaly","operationId":"postApiChannelsBychannelidAnomaliesByanomalyidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"anomalyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/downsampling/{policyId}":{"delete":{"tags":["Channels"],"summary":"Delete downsampling policy","operationId":"deleteApiChannelsBychannelidDownsamplingBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/downsampling/{policyId}/run":{"post":{"tags":["Channels"],"summary":"Run downsampling manually","operationId":"postApiChannelsBychannelidDownsamplingBypolicyidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/exports/{exportId}":{"delete":{"tags":["Channels"],"summary":"Delete export","operationId":"deleteApiChannelsBychannelidExportsByexportid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"exportId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/exports/{exportId}/history":{"get":{"tags":["Channels"],"summary":"Get export history","operationId":"getApiChannelsBychannelidExportsByexportidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"exportId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/exports/{exportId}/run":{"post":{"tags":["Channels"],"summary":"Run export manually","operationId":"postApiChannelsBychannelidExportsByexportidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"exportId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{channelId}/records/{recordId}":{"delete":{"tags":["Channels"],"summary":"Delete a specific record","operationId":"deleteApiChannelsBychannelidRecordsByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Channels"],"summary":"Update a specific record","operationId":"putApiChannelsBychannelidRecordsByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}":{"get":{"tags":["Channels"],"summary":"Get channel details (by ID)","operationId":"getApiChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Channels"],"summary":"Update channel","operationId":"putApiChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Channels"],"summary":"Delete channel","operationId":"deleteApiChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/alerts":{"get":{"tags":["Channels"],"summary":"Get alert history for a channel","operationId":"getApiChannelsByidAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/anomalies":{"get":{"tags":["Channels"],"summary":"Get anomaly history","operationId":"getApiChannelsByidAnomalies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/anomaly-detection":{"put":{"tags":["Channels"],"summary":"Set anomaly detection configuration","operationId":"putApiChannelsByidAnomalyDetection","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"Get anomaly detection configuration","operationId":"getApiChannelsByidAnomalyDetection","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/downsampling":{"post":{"tags":["Channels"],"summary":"Create downsampling policy","operationId":"postApiChannelsByidDownsampling","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"List downsampling policies","operationId":"getApiChannelsByidDownsampling","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/exports":{"post":{"tags":["Channels"],"summary":"Create export configuration","operationId":"postApiChannelsByidExports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"List exports","operationId":"getApiChannelsByidExports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/group":{"post":{"tags":["Channels"],"summary":"Add channel to group","operationId":"postApiChannelsByidGroup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Channels"],"summary":"Remove channel from group","operationId":"deleteApiChannelsByidGroup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/records":{"delete":{"tags":["Channels"],"summary":"Clear all records in a channel","operationId":"deleteApiChannelsByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/regenerate-read-token":{"post":{"tags":["Channels"],"summary":"Regenerate read token","operationId":"postApiChannelsByidRegenerateReadToken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/regenerate-write-token":{"post":{"tags":["Channels"],"summary":"Regenerate write token","operationId":"postApiChannelsByidRegenerateWriteToken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/retention":{"put":{"tags":["Channels"],"summary":"Set retention policies","operationId":"putApiChannelsByidRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"Get retention policies","operationId":"getApiChannelsByidRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/schema":{"put":{"tags":["Channels"],"summary":"Set JSON schema for channel","operationId":"putApiChannelsByidSchema","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"Get JSON schema for channel","operationId":"getApiChannelsByidSchema","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/stats":{"get":{"tags":["Channels"],"summary":"Get channel statistics","operationId":"getApiChannelsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/transformations":{"put":{"tags":["Channels"],"summary":"Set transformations for channel","operationId":"putApiChannelsByidTransformations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"Get transformations for channel","operationId":"getApiChannelsByidTransformations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{id}/validate":{"post":{"tags":["Channels"],"summary":"Validate data against schema","operationId":"postApiChannelsByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/*":{"options":{"tags":["Channels"],"summary":"CORS preflight for public channel endpoints","operationId":"optionsApiChannelsBypublicid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/aggregate":{"get":{"tags":["Channels"],"summary":"Get aggregated data from a channel (public with optional token)","operationId":"getApiChannelsBypublicidAggregate","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/batch":{"post":{"tags":["Channels"],"summary":"Batch write data to a channel (public with optional token)","operationId":"postApiChannelsBypublicidBatch","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/data":{"post":{"tags":["Channels"],"summary":"Write data to a channel (public with optional token)","operationId":"postApiChannelsBypublicidData","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Channels"],"summary":"Read all data from a channel (public with optional token)","operationId":"getApiChannelsBypublicidData","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/downsampled":{"get":{"tags":["Channels"],"summary":"Query downsampled data (public)","operationId":"getApiChannelsBypublicidDownsampled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/latest":{"get":{"tags":["Channels"],"summary":"Get latest record from a channel (public with optional token)","operationId":"getApiChannelsBypublicidLatest","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/query":{"get":{"tags":["Channels"],"summary":"--- Query with Filters (public) ---","operationId":"getApiChannelsBypublicidQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/channels/{publicId}/subscribe":{"get":{"tags":["Channels"],"summary":"Subscribe to channel updates via SSE (public)","operationId":"getApiChannelsBypublicidSubscribe","security":[],"parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cloud-usage":{"get":{"tags":["Cloud usage"],"summary":"List cloud usage","operationId":"getApiCloudUsage","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cloud-usage/settings":{"put":{"tags":["Cloud usage"],"summary":"Update settings","operationId":"putApiCloudUsageSettings","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cloud-usage/sites/{projectId}/{action}":{"post":{"tags":["Cloud usage"],"summary":"administer the project (owner; an organisation's owner/admin).","operationId":"postApiCloudUsageSitesByprojectidByaction","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"action","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/attachments/{endpointId}/{recordId}":{"get":{"tags":["Cnc"],"summary":"Get attachment","operationId":"getApiCncAttachmentsByendpointidByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/detect-format":{"post":{"tags":["Cnc"],"summary":"Create detect format","operationId":"postApiCncCldataDetectFormat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/formats":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncCldataFormats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/import":{"post":{"tags":["Cnc"],"summary":"Create import","operationId":"postApiCncCldataImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/parse":{"post":{"tags":["Cnc"],"summary":"Create parse","operationId":"postApiCncCldataParse","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/post-process":{"post":{"tags":["Cnc"],"summary":"Create post process","operationId":"postApiCncCldataPostProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/cldata/validate":{"post":{"tags":["Cnc"],"summary":"Create validate","operationId":"postApiCncCldataValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/commands":{"get":{"tags":["Cnc"],"summary":"List commands","operationId":"getApiCncCommands","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/commands/explain-line":{"post":{"tags":["Cnc"],"summary":"Create explain line","operationId":"postApiCncCommandsExplainLine","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/commands/explain-program":{"post":{"tags":["Cnc"],"summary":"Create explain program","operationId":"postApiCncCommandsExplainProgram","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/commands/narrative":{"post":{"tags":["Cnc"],"summary":"Create narrative","operationId":"postApiCncCommandsNarrative","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/commands/{code}":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncCommandsBycode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/controller-types":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncControllerTypes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Cnc"],"summary":"Create controller types","operationId":"postApiCncControllerTypes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/controller-types/{id}":{"get":{"tags":["Cnc"],"summary":"Get controller type","operationId":"getApiCncControllerTypesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update controller type","operationId":"putApiCncControllerTypesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete controller type","operationId":"deleteApiCncControllerTypesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/dialect-families":{"get":{"tags":["Cnc"],"summary":"List dialect families","operationId":"getApiCncDialectFamilies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/dialects":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncDialects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/dialects/detect":{"post":{"tags":["Cnc"],"summary":"Create detect","operationId":"postApiCncDialectsDetect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/dialects/parse":{"post":{"tags":["Cnc"],"summary":"Create parse","operationId":"postApiCncDialectsParse","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/cutting-data":{"post":{"tags":["Cnc"],"summary":"Create cutting data","operationId":"postApiCncErpCuttingData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/generate":{"post":{"tags":["Cnc"],"summary":"Create generate","operationId":"postApiCncErpGenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/operations":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncErpOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/resolve-operations":{"post":{"tags":["Cnc"],"summary":"Create resolve operations","operationId":"postApiCncErpResolveOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/select-tools":{"post":{"tags":["Cnc"],"summary":"Create select tools","operationId":"postApiCncErpSelectTools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/setup-sheet":{"post":{"tags":["Cnc"],"summary":"Create setup sheet","operationId":"postApiCncErpSetupSheet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/erp/validate":{"post":{"tags":["Cnc"],"summary":"Create validate","operationId":"postApiCncErpValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/error-rules":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncErrorRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Cnc"],"summary":"Create error rules","operationId":"postApiCncErrorRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/error-rules/{id}":{"put":{"tags":["Cnc"],"summary":"Update error rule","operationId":"putApiCncErrorRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete error rule","operationId":"deleteApiCncErrorRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/machine-types":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncMachineTypes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/machines":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncMachines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List machines","operationId":"getApiCncMachines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/machines/{id}":{"get":{"tags":["Cnc"],"summary":"Get machine","operationId":"getApiCncMachinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update machine","operationId":"putApiCncMachinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete machine","operationId":"deleteApiCncMachinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/machines/{id}/tools":{"get":{"tags":["Cnc"],"summary":"Sub-resource routes BEFORE /@id","operationId":"getApiCncMachinesByidTools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Cnc"],"summary":"Create tools","operationId":"postApiCncMachinesByidTools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/machines/{id}/tools/{pocket}":{"delete":{"tags":["Cnc"],"summary":"Delete tool","operationId":"deleteApiCncMachinesByidToolsBypocket","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pocket","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncPostProcessors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List post processors","operationId":"getApiCncPostProcessors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors/{id}":{"get":{"tags":["Cnc"],"summary":"Get post processor","operationId":"getApiCncPostProcessorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update post processor","operationId":"putApiCncPostProcessorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete post processor","operationId":"deleteApiCncPostProcessorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors/{id}/clone":{"post":{"tags":["Cnc"],"summary":"Create clone","operationId":"postApiCncPostProcessorsByidClone","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors/{id}/rules":{"post":{"tags":["Cnc"],"summary":"Create rules","operationId":"postApiCncPostProcessorsByidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List rules","operationId":"getApiCncPostProcessorsByidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors/{id}/rules/{ruleId}":{"delete":{"tags":["Cnc"],"summary":"Delete rule","operationId":"deleteApiCncPostProcessorsByidRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/post-processors/{id}/run":{"post":{"tags":["Cnc"],"summary":"Create run","operationId":"postApiCncPostProcessorsByidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncPrograms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List programs","operationId":"getApiCncPrograms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/batch-attach":{"post":{"tags":["Cnc"],"summary":"Create batch attach","operationId":"postApiCncProgramsBatchAttach","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/batch-transform":{"post":{"tags":["Cnc"],"summary":"Sub-resource routes BEFORE /@id","operationId":"postApiCncProgramsBatchTransform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}":{"get":{"tags":["Cnc"],"summary":"Program-specific routes","operationId":"getApiCncProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update program","operationId":"putApiCncProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete program","operationId":"deleteApiCncProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/analyze":{"post":{"tags":["Cnc"],"summary":"Create analyze","operationId":"postApiCncProgramsByidAnalyze","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/attach":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncProgramsByidAttach","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/attach/{endpointId}/{recordId}":{"delete":{"tags":["Cnc"],"summary":"Delete attach","operationId":"deleteApiCncProgramsByidAttachByendpointidByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/attached-records":{"get":{"tags":["Cnc"],"summary":"List attached records","operationId":"getApiCncProgramsByidAttachedRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/check-errors":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncProgramsByidCheckErrors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/errors":{"get":{"tags":["Cnc"],"summary":"List errors","operationId":"getApiCncProgramsByidErrors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/explain":{"get":{"tags":["Cnc"],"summary":"List explain","operationId":"getApiCncProgramsByidExplain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/fix-all":{"post":{"tags":["Cnc"],"summary":"Create fix all","operationId":"postApiCncProgramsByidFixAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/fix-suggestions":{"get":{"tags":["Cnc"],"summary":"============================================","operationId":"getApiCncProgramsByidFixSuggestions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/fix/{issueIndex}":{"post":{"tags":["Cnc"],"summary":"Create fix","operationId":"postApiCncProgramsByidFixByissueindex","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"issueIndex","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/fix/{issueIndex}/preview":{"get":{"tags":["Cnc"],"summary":"List preview","operationId":"getApiCncProgramsByidFixByissueindexPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"issueIndex","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/revisions":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncProgramsByidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List revisions","operationId":"getApiCncProgramsByidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/revisions/compare":{"get":{"tags":["Cnc"],"summary":"List compare","operationId":"getApiCncProgramsByidRevisionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/setup-sheet":{"get":{"tags":["Cnc"],"summary":"List setup sheet","operationId":"getApiCncProgramsByidSetupSheet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/source":{"get":{"tags":["Cnc"],"summary":"List source","operationId":"getApiCncProgramsByidSource","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/transform":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncProgramsByidTransform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/transform-preview":{"post":{"tags":["Cnc"],"summary":"Create transform preview","operationId":"postApiCncProgramsByidTransformPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/validate":{"post":{"tags":["Cnc"],"summary":"Create validate","operationId":"postApiCncProgramsByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/validate/{machineId}":{"post":{"tags":["Cnc"],"summary":"Alternative route with machine ID in URL path","operationId":"postApiCncProgramsByidValidateBymachineid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"machineId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/programs/{id}/version":{"post":{"tags":["Cnc"],"summary":"Create version","operationId":"postApiCncProgramsByidVersion","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations":{"post":{"tags":["Cnc"],"summary":"Create simulations","operationId":"postApiCncSimulations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List simulations","operationId":"getApiCncSimulations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}":{"get":{"tags":["Cnc"],"summary":"Get simulation","operationId":"getApiCncSimulationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update simulation","operationId":"putApiCncSimulationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete simulation","operationId":"deleteApiCncSimulationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/analyze":{"post":{"tags":["Cnc"],"summary":"Create analyze","operationId":"postApiCncSimulationsByidAnalyze","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/export/step":{"get":{"tags":["Cnc"],"summary":"List step","operationId":"getApiCncSimulationsByidExportStep","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/export/stl":{"get":{"tags":["Cnc"],"summary":"List stl","operationId":"getApiCncSimulationsByidExportStl","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/report":{"get":{"tags":["Cnc"],"summary":"List report","operationId":"getApiCncSimulationsByidReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/run":{"post":{"tags":["Cnc"],"summary":"Create run","operationId":"postApiCncSimulationsByidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/simulations/{id}/viewer":{"get":{"tags":["Cnc"],"summary":"List viewer","operationId":"getApiCncSimulationsByidViewer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/stock-templates":{"get":{"tags":["Cnc"],"summary":"List stock templates","operationId":"getApiCncStockTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Cnc"],"summary":"Create stock templates","operationId":"postApiCncStockTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/sub-programs":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncSubPrograms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List sub programs","operationId":"getApiCncSubPrograms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/sub-programs/{id}":{"get":{"tags":["Cnc"],"summary":"Get sub program","operationId":"getApiCncSubProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update sub program","operationId":"putApiCncSubProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete sub program","operationId":"deleteApiCncSubProgramsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/sub-programs/{id}/instantiate":{"post":{"tags":["Cnc"],"summary":"Create instantiate","operationId":"postApiCncSubProgramsByidInstantiate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/sub-programs/{id}/variables":{"put":{"tags":["Cnc"],"summary":"Update variables","operationId":"putApiCncSubProgramsByidVariables","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List variables","operationId":"getApiCncSubProgramsByidVariables","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/tool-types":{"get":{"tags":["Cnc"],"summary":"List tool types","operationId":"getApiCncToolTypes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/tools":{"post":{"tags":["Cnc"],"summary":"============================================","operationId":"postApiCncTools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Cnc"],"summary":"List tools","operationId":"getApiCncTools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/tools/import":{"post":{"tags":["Cnc"],"summary":"Create import","operationId":"postApiCncToolsImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/tools/{id}":{"get":{"tags":["Cnc"],"summary":"Get tool","operationId":"getApiCncToolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Cnc"],"summary":"Update tool","operationId":"putApiCncToolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Cnc"],"summary":"Delete tool","operationId":"deleteApiCncToolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/cnc/tools/{id}/cutting-data/{material}":{"get":{"tags":["Cnc"],"summary":"Get cutting data","operationId":"getApiCncToolsByidCuttingDataBymaterial","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"material","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/active":{"get":{"tags":["Collaboration"],"summary":"List active","operationId":"getApiCollaborationActive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/cleanup":{"post":{"tags":["Collaboration"],"summary":"Cleanup expired sessions","operationId":"postApiCollaborationCleanup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/field-lock":{"post":{"tags":["Collaboration"],"summary":"Field-level locking","operationId":"postApiCollaborationFieldLock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/field-unlock":{"post":{"tags":["Collaboration"],"summary":"Create field unlock","operationId":"postApiCollaborationFieldUnlock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/field-update":{"post":{"tags":["Collaboration"],"summary":"Field updates","operationId":"postApiCollaborationFieldUpdate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/heartbeat":{"post":{"tags":["Collaboration"],"summary":"Create heartbeat","operationId":"postApiCollaborationHeartbeat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/join":{"post":{"tags":["Collaboration"],"summary":"Session management","operationId":"postApiCollaborationJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/leave":{"post":{"tags":["Collaboration"],"summary":"Create leave","operationId":"postApiCollaborationLeave","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collaboration/session/{endpointId}/{recordId}":{"get":{"tags":["Collaboration"],"summary":"Session queries","operationId":"getApiCollaborationSessionByendpointidByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/comments/recent":{"get":{"tags":["Comments"],"summary":"List recent","operationId":"getApiCommentsRecent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/comments/{id}":{"put":{"tags":["Comments"],"summary":"Update comment","operationId":"putApiCommentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Comments"],"summary":"Delete comment","operationId":"deleteApiCommentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/comments/{id}/resolve":{"post":{"tags":["Comments"],"summary":"Create resolve","operationId":"postApiCommentsByidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/comments/{id}/unresolve":{"post":{"tags":["Comments"],"summary":"Create unresolve","operationId":"postApiCommentsByidUnresolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/audit-packages":{"get":{"tags":["Compliance autopilot"],"summary":"List audit packages","operationId":"getApiComplianceAutopilotAuditPackages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/audit-packages/download/{downloadToken}":{"get":{"tags":["Compliance autopilot"],"summary":"Download route BEFORE /@packageId to prevent FlightPHP matching \"download\" as a package ID","operationId":"getApiComplianceAutopilotAuditPackagesDownloadBydownloadtoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"downloadToken","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/audit-packages/{packageId}":{"get":{"tags":["Compliance autopilot"],"summary":"Get audit package","operationId":"getApiComplianceAutopilotAuditPackagesBypackageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"packageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/controls/{controlId}":{"put":{"tags":["Compliance autopilot"],"summary":"Update control","operationId":"putApiComplianceAutopilotControlsBycontrolid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"controlId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/controls/{controlId}/evidence":{"post":{"tags":["Compliance autopilot"],"summary":"Evidence","operationId":"postApiComplianceAutopilotControlsBycontrolidEvidence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"controlId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compliance autopilot"],"summary":"List evidence","operationId":"getApiComplianceAutopilotControlsBycontrolidEvidence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"controlId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/frameworks":{"post":{"tags":["Compliance autopilot"],"summary":"Framework management","operationId":"postApiComplianceAutopilotFrameworks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compliance autopilot"],"summary":"List frameworks","operationId":"getApiComplianceAutopilotFrameworks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/frameworks/{frameworkId}":{"get":{"tags":["Compliance autopilot"],"summary":"Get framework","operationId":"getApiComplianceAutopilotFrameworksByframeworkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Compliance autopilot"],"summary":"Delete framework","operationId":"deleteApiComplianceAutopilotFrameworksByframeworkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/frameworks/{frameworkId}/audit-packages":{"post":{"tags":["Compliance autopilot"],"summary":"Audit packages","operationId":"postApiComplianceAutopilotFrameworksByframeworkidAuditPackages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/frameworks/{frameworkId}/auto-collect":{"post":{"tags":["Compliance autopilot"],"summary":"Auto-collect evidence","operationId":"postApiComplianceAutopilotFrameworksByframeworkidAutoCollect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/frameworks/{frameworkId}/controls":{"get":{"tags":["Compliance autopilot"],"summary":"Controls","operationId":"getApiComplianceAutopilotFrameworksByframeworkidControls","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-autopilot/summary":{"get":{"tags":["Compliance autopilot"],"summary":"Summary","operationId":"getApiComplianceAutopilotSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/audit-log":{"get":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Audit Log (unified) \u2500\u2500","operationId":"getApiComplianceEngineAuditLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/audit-packages":{"get":{"tags":["Compliance engine"],"summary":"List audit packages","operationId":"getApiComplianceEngineAuditPackages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/audit-packages/download/{downloadToken}":{"get":{"tags":["Compliance engine"],"summary":"No auth \u2014 token-based download","operationId":"getApiComplianceEngineAuditPackagesDownloadBydownloadtoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"downloadToken","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/audit-packages/{packageId}":{"get":{"tags":["Compliance engine"],"summary":"Get audit package","operationId":"getApiComplianceEngineAuditPackagesBypackageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"packageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/config":{"get":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Config & Dashboard \u2500\u2500","operationId":"getApiComplianceEngineConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Compliance engine"],"summary":"Update config","operationId":"putApiComplianceEngineConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/controls/{controlId}/assess":{"put":{"tags":["Compliance engine"],"summary":"Update assess","operationId":"putApiComplianceEngineControlsBycontrolidAssess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"controlId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/controls/{controlId}/evidence":{"post":{"tags":["Compliance engine"],"summary":"Create evidence","operationId":"postApiComplianceEngineControlsBycontrolidEvidence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"controlId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/dashboard":{"get":{"tags":["Compliance engine"],"summary":"List dashboard","operationId":"getApiComplianceEngineDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/data-inventory":{"get":{"tags":["Compliance engine"],"summary":"List data inventory","operationId":"getApiComplianceEngineDataInventory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/dsars":{"post":{"tags":["Compliance engine"],"summary":"Create dsars","operationId":"postApiComplianceEngineDsars","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compliance engine"],"summary":"List dsars","operationId":"getApiComplianceEngineDsars","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/dsars/{dsarId}/process":{"post":{"tags":["Compliance engine"],"summary":"Create process","operationId":"postApiComplianceEngineDsarsBydsaridProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dsarId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks":{"get":{"tags":["Compliance engine"],"summary":"List frameworks","operationId":"getApiComplianceEngineFrameworks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/activate":{"post":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Autopilot Module \u2500\u2500","operationId":"postApiComplianceEngineFrameworksActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/{frameworkId}":{"get":{"tags":["Compliance engine"],"summary":"Get framework","operationId":"getApiComplianceEngineFrameworksByframeworkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/{frameworkId}/audit-package":{"post":{"tags":["Compliance engine"],"summary":"Create audit package","operationId":"postApiComplianceEngineFrameworksByframeworkidAuditPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/{frameworkId}/auto-collect":{"post":{"tags":["Compliance engine"],"summary":"Create auto collect","operationId":"postApiComplianceEngineFrameworksByframeworkidAutoCollect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/{frameworkId}/controls":{"get":{"tags":["Compliance engine"],"summary":"List controls","operationId":"getApiComplianceEngineFrameworksByframeworkidControls","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/frameworks/{frameworkType}":{"delete":{"tags":["Compliance engine"],"summary":"Delete framework","operationId":"deleteApiComplianceEngineFrameworksByframeworktype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"frameworkType","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/reports":{"post":{"tags":["Compliance engine"],"summary":"Create reports","operationId":"postApiComplianceEngineReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compliance engine"],"summary":"List reports","operationId":"getApiComplianceEngineReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/reports/{reportId}":{"get":{"tags":["Compliance engine"],"summary":"Get report","operationId":"getApiComplianceEngineReportsByreportid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"reportId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/certificates":{"get":{"tags":["Compliance engine"],"summary":"List certificates","operationId":"getApiComplianceEngineResidencyCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/certificates/download/{downloadToken}":{"get":{"tags":["Compliance engine"],"summary":"No auth \u2014 token-based download","operationId":"getApiComplianceEngineResidencyCertificatesDownloadBydownloadtoken","security":[],"parameters":[{"name":"downloadToken","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/check":{"get":{"tags":["Compliance engine"],"summary":"List check","operationId":"getApiComplianceEngineResidencyCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/endpoints/{endpointId}":{"delete":{"tags":["Compliance engine"],"summary":"Delete endpoint","operationId":"deleteApiComplianceEngineResidencyEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/map":{"get":{"tags":["Compliance engine"],"summary":"List map","operationId":"getApiComplianceEngineResidencyMap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/policies":{"post":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Residency Module \u2500\u2500","operationId":"postApiComplianceEngineResidencyPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compliance engine"],"summary":"List policies","operationId":"getApiComplianceEngineResidencyPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/policies/{policyId}":{"get":{"tags":["Compliance engine"],"summary":"Get policie","operationId":"getApiComplianceEngineResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Compliance engine"],"summary":"Update policie","operationId":"putApiComplianceEngineResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Compliance engine"],"summary":"Delete policie","operationId":"deleteApiComplianceEngineResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/policies/{policyId}/certificate":{"post":{"tags":["Compliance engine"],"summary":"Create certificate","operationId":"postApiComplianceEngineResidencyPoliciesBypolicyidCertificate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/policies/{policyId}/endpoints/{endpointId}":{"post":{"tags":["Compliance engine"],"summary":"Create endpoint","operationId":"postApiComplianceEngineResidencyPoliciesBypolicyidEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/residency/regions":{"get":{"tags":["Compliance engine"],"summary":"List regions","operationId":"getApiComplianceEngineResidencyRegions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/scan-pii":{"post":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Reporting Module \u2500\u2500","operationId":"postApiComplianceEngineScanPii","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/summary":{"get":{"tags":["Compliance engine"],"summary":"List summary","operationId":"getApiComplianceEngineSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/violations":{"get":{"tags":["Compliance engine"],"summary":"\u2500\u2500 Violations (unified) \u2500\u2500","operationId":"getApiComplianceEngineViolations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance-engine/violations/{violationId}/resolve":{"put":{"tags":["Compliance engine"],"summary":"Update resolve","operationId":"putApiComplianceEngineViolationsByviolationidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"violationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/access-log":{"get":{"tags":["Compliance"],"summary":"=============================================================================","operationId":"getApiComplianceAccessLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/config":{"get":{"tags":["Compliance"],"summary":"=============================================================================","operationId":"getApiComplianceConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Compliance"],"summary":"Patch config","operationId":"patchApiComplianceConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/dsar":{"get":{"tags":["Compliance"],"summary":"=============================================================================","operationId":"getApiComplianceDsar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Compliance"],"summary":"Create dsar","operationId":"postApiComplianceDsar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/dsar/{id}":{"get":{"tags":["Compliance"],"summary":"Get dsar","operationId":"getApiComplianceDsarByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/dsar/{id}/download":{"get":{"tags":["Compliance"],"summary":"List download","operationId":"getApiComplianceDsarByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/dsar/{id}/process":{"post":{"tags":["Compliance"],"summary":"Create process","operationId":"postApiComplianceDsarByidProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/inventory":{"get":{"tags":["Compliance"],"summary":"=============================================================================","operationId":"getApiComplianceInventory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/inventory/{endpointId}/fields/{fieldName}":{"patch":{"tags":["Compliance"],"summary":"Patch field","operationId":"patchApiComplianceInventoryByendpointidFieldsByfieldname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/inventory/{endpointId}/scan":{"post":{"tags":["Compliance"],"summary":"Create scan","operationId":"postApiComplianceInventoryByendpointidScan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/reports":{"get":{"tags":["Compliance"],"summary":"=============================================================================","operationId":"getApiComplianceReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Compliance"],"summary":"Create reports","operationId":"postApiComplianceReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/reports/{id}":{"get":{"tags":["Compliance"],"summary":"Get report","operationId":"getApiComplianceReportsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Compliance"],"summary":"Delete report","operationId":"deleteApiComplianceReportsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compliance/reports/{id}/download":{"get":{"tags":["Compliance"],"summary":"List download","operationId":"getApiComplianceReportsByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions":{"post":{"tags":["Compositions"],"summary":"--- Composition CRUD ---","operationId":"postApiCompositions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Compositions"],"summary":"List compositions","operationId":"getApiCompositions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions/executions/{execId}":{"get":{"tags":["Compositions"],"summary":"Get execution","operationId":"getApiCompositionsExecutionsByexecid","security":[],"parameters":[{"name":"execId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions/{id}":{"get":{"tags":["Compositions"],"summary":"Get composition","operationId":"getApiCompositionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Compositions"],"summary":"Update composition","operationId":"putApiCompositionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Compositions"],"summary":"Delete composition","operationId":"deleteApiCompositionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions/{id}/execute":{"post":{"tags":["Compositions"],"summary":"--- Execution ---","operationId":"postApiCompositionsByidExecute","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions/{id}/executions":{"get":{"tags":["Compositions"],"summary":"List executions","operationId":"getApiCompositionsByidExecutions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/compositions/{id}/validate":{"post":{"tags":["Compositions"],"summary":"--- Validation ---","operationId":"postApiCompositionsByidValidate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors":{"get":{"tags":["Connectors"],"summary":"============================================","operationId":"getApiConnectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Connectors"],"summary":"Create connectors","operationId":"postApiConnectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors/runs/{runId}":{"get":{"tags":["Connectors"],"summary":"Get run","operationId":"getApiConnectorsRunsByrunid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors/{id}":{"get":{"tags":["Connectors"],"summary":"Get connector","operationId":"getApiConnectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Connectors"],"summary":"Update connector","operationId":"putApiConnectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Connectors"],"summary":"Delete connector","operationId":"deleteApiConnectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors/{id}/runs":{"get":{"tags":["Connectors"],"summary":"List runs","operationId":"getApiConnectorsByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors/{id}/sync":{"post":{"tags":["Connectors"],"summary":"Create sync","operationId":"postApiConnectorsByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/connectors/{id}/test":{"post":{"tags":["Connectors"],"summary":"Create test","operationId":"postApiConnectorsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/consents":{"post":{"tags":["Consents"],"summary":"----- Consent Management Routes -----","operationId":"postApiConsents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Consents"],"summary":"List consents","operationId":"getApiConsents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/consents/export":{"get":{"tags":["Consents"],"summary":"List export","operationId":"getApiConsentsExport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/consents/history":{"get":{"tags":["Consents"],"summary":"List history","operationId":"getApiConsentsHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/consents/revoke":{"post":{"tags":["Consents"],"summary":"Create revoke","operationId":"postApiConsentsRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/consents/summary":{"get":{"tags":["Consents"],"summary":"List summary","operationId":"getApiConsentsSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/creone-integrations":{"post":{"tags":["Creone integrations"],"summary":"--- Creone Integration CRUD ---","operationId":"postApiCreoneIntegrations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Creone integrations"],"summary":"List creone integrations","operationId":"getApiCreoneIntegrations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/creone-integrations/{id}":{"get":{"tags":["Creone integrations"],"summary":"Get creone integration","operationId":"getApiCreoneIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Creone integrations"],"summary":"Update creone integration","operationId":"putApiCreoneIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Creone integrations"],"summary":"Delete creone integration","operationId":"deleteApiCreoneIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/creone-integrations/{id}/set-pin":{"post":{"tags":["Creone integrations"],"summary":"Create set pin","operationId":"postApiCreoneIntegrationsByidSetPin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/creone-integrations/{id}/test":{"post":{"tags":["Creone integrations"],"summary":"--- Creone API Operations ---","operationId":"postApiCreoneIntegrationsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/creone-integrations/{id}/users":{"get":{"tags":["Creone integrations"],"summary":"List users","operationId":"getApiCreoneIntegrationsByidUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/currency/convert":{"post":{"tags":["Currency"],"summary":"Convert currency","operationId":"postApiCurrencyConvert","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/currency/rates/{base}":{"get":{"tags":["Currency"],"summary":"Get exchange rates for a base currency","operationId":"getApiCurrencyRatesBybase","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"base","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/currency/supported":{"get":{"tags":["Currency"],"summary":"Get supported currencies","operationId":"getApiCurrencySupported","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/custom-domains":{"get":{"tags":["Custom domains"],"summary":"List the caller's custom domains.","operationId":"getApiCustomDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Custom domains"],"summary":"already auto-verified if the platform-DNS fast path applied.","operationId":"postApiCustomDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/custom-domains/{id}":{"get":{"tags":["Custom domains"],"summary":"Single-row fetch.","operationId":"getApiCustomDomainsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Custom domains"],"summary":"caller can retry rather than leaking a cert.","operationId":"deleteApiCustomDomainsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/custom-domains/{id}/hsts":{"put":{"tags":["Custom domains"],"summary":"Set the domain's Strict-Transport-Security max-age.","operationId":"putApiCustomDomainsByidHsts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/custom-domains/{id}/provision-tls":{"post":{"tags":["Custom domains"],"summary":"INTERNAL_REPLICATION_SECRET-gated internal endpoint.","operationId":"postApiCustomDomainsByidProvisionTls","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/custom-domains/{id}/verify":{"post":{"tags":["Custom domains"],"summary":"or HTTP-01 check otherwise).","operationId":"postApiCustomDomainsByidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/config":{"get":{"tags":["Dashboard"],"summary":"Dashboard config","operationId":"getApiDashboardConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dashboard"],"summary":"Update config","operationId":"putApiDashboardConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/lock":{"put":{"tags":["Dashboard"],"summary":"Update lock","operationId":"putApiDashboardLock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/notes":{"get":{"tags":["Dashboard"],"summary":"Notes CRUD","operationId":"getApiDashboardNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dashboard"],"summary":"Create notes","operationId":"postApiDashboardNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/notes/search":{"get":{"tags":["Dashboard"],"summary":"List search","operationId":"getApiDashboardNotesSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/notes/{id}":{"get":{"tags":["Dashboard"],"summary":"Get note","operationId":"getApiDashboardNotesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dashboard"],"summary":"Update note","operationId":"putApiDashboardNotesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dashboard"],"summary":"Delete note","operationId":"deleteApiDashboardNotesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboard/widget-data/{type}":{"get":{"tags":["Dashboard"],"summary":"Widget data","operationId":"getApiDashboardWidgetDataBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards":{"post":{"tags":["Dashboards"],"summary":"Authenticated API routes","operationId":"postApiDashboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dashboards"],"summary":"List dashboards","operationId":"getApiDashboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards/widgets/{widgetId}":{"put":{"tags":["Dashboards"],"summary":"Update widget","operationId":"putApiDashboardsWidgetsBywidgetid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dashboards"],"summary":"Delete widget","operationId":"deleteApiDashboardsWidgetsBywidgetid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards/widgets/{widgetId}/data":{"get":{"tags":["Dashboards"],"summary":"List data","operationId":"getApiDashboardsWidgetsBywidgetidData","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards/{dashboardId}/widgets":{"post":{"tags":["Dashboards"],"summary":"Widget routes","operationId":"postApiDashboardsBydashboardidWidgets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dashboards"],"summary":"List widgets","operationId":"getApiDashboardsBydashboardidWidgets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards/{dashboardId}/widgets/positions":{"put":{"tags":["Dashboards"],"summary":"Update positions","operationId":"putApiDashboardsBydashboardidWidgetsPositions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"dashboardId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dashboards/{id}":{"get":{"tags":["Dashboards"],"summary":"Get dashboard","operationId":"getApiDashboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dashboards"],"summary":"Update dashboard","operationId":"putApiDashboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dashboards"],"summary":"Delete dashboard","operationId":"deleteApiDashboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/history":{"get":{"tags":["Data alerts"],"summary":"Static routes MUST come before parameterized @ruleId routes","operationId":"getApiDataAlertsHistory","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/history/{historyId}/acknowledge":{"post":{"tags":["Data alerts"],"summary":"Create acknowledge","operationId":"postApiDataAlertsHistoryByhistoryidAcknowledge","security":[],"parameters":[{"name":"historyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/stats":{"get":{"tags":["Data alerts"],"summary":"List stats","operationId":"getApiDataAlertsStats","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/{ruleId}":{"get":{"tags":["Data alerts"],"summary":"Alert rule management (parameterized routes after static ones)","operationId":"getApiDataAlertsByruleid","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data alerts"],"summary":"Update data alert","operationId":"putApiDataAlertsByruleid","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data alerts"],"summary":"Delete data alert","operationId":"deleteApiDataAlertsByruleid","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/{ruleId}/test":{"post":{"tags":["Data alerts"],"summary":"Test / dry-run","operationId":"postApiDataAlertsByruleidTest","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-alerts/{ruleId}/toggle":{"patch":{"tags":["Data alerts"],"summary":"Patch toggle","operationId":"patchApiDataAlertsByruleidToggle","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches":{"post":{"tags":["Data branches"],"summary":"--- Branch CRUD ---","operationId":"postApiDataBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data branches"],"summary":"List data branches","operationId":"getApiDataBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}":{"get":{"tags":["Data branches"],"summary":"Get data branche","operationId":"getApiDataBranchesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data branches"],"summary":"Update data branche","operationId":"putApiDataBranchesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data branches"],"summary":"Delete data branche","operationId":"deleteApiDataBranchesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/atomic-merge":{"post":{"tags":["Data branches"],"summary":"Create atomic merge","operationId":"postApiDataBranchesByidAtomicMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/changes":{"post":{"tags":["Data branches"],"summary":"--- Change Management ---","operationId":"postApiDataBranchesByidChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data branches"],"summary":"List changes","operationId":"getApiDataBranchesByidChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/cherry-pick":{"post":{"tags":["Data branches"],"summary":"--- Enhanced: Cherry-pick, Overlay State, Atomic Merge ---","operationId":"postApiDataBranchesByidCherryPick","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/conflicts":{"get":{"tags":["Data branches"],"summary":"List conflicts","operationId":"getApiDataBranchesByidConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/diff":{"get":{"tags":["Data branches"],"summary":"--- Diff, Merge, Discard, Conflicts ---","operationId":"getApiDataBranchesByidDiff","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/discard":{"post":{"tags":["Data branches"],"summary":"Create discard","operationId":"postApiDataBranchesByidDiscard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/merge":{"post":{"tags":["Data branches"],"summary":"Create merge","operationId":"postApiDataBranchesByidMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-branches/{id}/overlay":{"get":{"tags":["Data branches"],"summary":"List overlay","operationId":"getApiDataBranchesByidOverlay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows":{"get":{"tags":["Data flows"],"summary":"CRUD","operationId":"getApiDataFlows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Data flows"],"summary":"Create data flows","operationId":"postApiDataFlows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows/validate":{"post":{"tags":["Data flows"],"summary":"Validate must come before @id wildcard","operationId":"postApiDataFlowsValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows/{id}":{"get":{"tags":["Data flows"],"summary":"Get data flow","operationId":"getApiDataFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data flows"],"summary":"Update data flow","operationId":"putApiDataFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data flows"],"summary":"Delete data flow","operationId":"deleteApiDataFlowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows/{id}/execute":{"post":{"tags":["Data flows"],"summary":"Execute a flow","operationId":"postApiDataFlowsByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows/{id}/executions":{"get":{"tags":["Data flows"],"summary":"Execution history","operationId":"getApiDataFlowsByidExecutions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-flows/{id}/executions/{execId}":{"get":{"tags":["Data flows"],"summary":"Get execution","operationId":"getApiDataFlowsByidExecutionsByexecid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"execId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-gen-profiles":{"post":{"tags":["Data gen profiles"],"summary":"Create profile","operationId":"postApiDataGenProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data gen profiles"],"summary":"List profiles","operationId":"getApiDataGenProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-gen-profiles/{id}":{"get":{"tags":["Data gen profiles"],"summary":"Get profile","operationId":"getApiDataGenProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data gen profiles"],"summary":"Delete profile","operationId":"deleteApiDataGenProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-membranes":{"post":{"tags":["Data membranes"],"summary":"============================================","operationId":"postApiDataMembranes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data membranes"],"summary":"List data membranes","operationId":"getApiDataMembranes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-membranes/{id}":{"get":{"tags":["Data membranes"],"summary":"Get data membrane","operationId":"getApiDataMembranesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data membranes"],"summary":"Update data membrane","operationId":"putApiDataMembranesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data membranes"],"summary":"Delete data membrane","operationId":"deleteApiDataMembranesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines":{"get":{"tags":["Data pipelines"],"summary":"============================================","operationId":"getApiDataPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Data pipelines"],"summary":"Create data pipelines","operationId":"postApiDataPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/source-types":{"get":{"tags":["Data pipelines"],"summary":"============================================","operationId":"getApiDataPipelinesSourceTypes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}":{"get":{"tags":["Data pipelines"],"summary":"Get data pipeline","operationId":"getApiDataPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data pipelines"],"summary":"Update data pipeline","operationId":"putApiDataPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data pipelines"],"summary":"Delete data pipeline","operationId":"deleteApiDataPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/disable":{"post":{"tags":["Data pipelines"],"summary":"Create disable","operationId":"postApiDataPipelinesByidDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/enable":{"post":{"tags":["Data pipelines"],"summary":"Create enable","operationId":"postApiDataPipelinesByidEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/execute":{"post":{"tags":["Data pipelines"],"summary":"============================================","operationId":"postApiDataPipelinesByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/generated-code":{"get":{"tags":["Data pipelines"],"summary":"List generated code","operationId":"getApiDataPipelinesByidGeneratedCode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/preview":{"post":{"tags":["Data pipelines"],"summary":"Create preview","operationId":"postApiDataPipelinesByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/runs":{"get":{"tags":["Data pipelines"],"summary":"============================================","operationId":"getApiDataPipelinesByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-pipelines/{id}/runs/{runId}":{"get":{"tags":["Data pipelines"],"summary":"Get run","operationId":"getApiDataPipelinesByidRunsByrunid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-portals":{"post":{"tags":["Data portals"],"summary":"============================================","operationId":"postApiDataPortals","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data portals"],"summary":"List data portals","operationId":"getApiDataPortals","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-portals/{id}":{"get":{"tags":["Data portals"],"summary":"Get data portal","operationId":"getApiDataPortalsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data portals"],"summary":"Update data portal","operationId":"putApiDataPortalsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data portals"],"summary":"Delete data portal","operationId":"deleteApiDataPortalsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-portals/{id}/archive":{"post":{"tags":["Data portals"],"summary":"Create archive","operationId":"postApiDataPortalsByidArchive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-portals/{id}/publish":{"post":{"tags":["Data portals"],"summary":"Create publish","operationId":"postApiDataPortalsByidPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-quality/rulesets":{"get":{"tags":["Data quality"],"summary":"Ruleset CRUD","operationId":"getApiDataQualityRulesets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Data quality"],"summary":"Create rulesets","operationId":"postApiDataQualityRulesets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-quality/rulesets/{id}":{"get":{"tags":["Data quality"],"summary":"Get ruleset","operationId":"getApiDataQualityRulesetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data quality"],"summary":"Update ruleset","operationId":"putApiDataQualityRulesetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data quality"],"summary":"Delete ruleset","operationId":"deleteApiDataQualityRulesetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-quality/rulesets/{id}/run":{"post":{"tags":["Data quality"],"summary":"Run a ruleset manually","operationId":"postApiDataQualityRulesetsByidRun","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-quality/rulesets/{rulesetId}/runs":{"get":{"tags":["Data quality"],"summary":"Run history","operationId":"getApiDataQualityRulesetsByrulesetidRuns","security":[],"parameters":[{"name":"rulesetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-quality/runs/{runId}":{"get":{"tags":["Data quality"],"summary":"Run results (with issues)","operationId":"getApiDataQualityRunsByrunid","security":[],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/assignments":{"get":{"tags":["Data residency"],"summary":"--- Assignments (before /@policyId to avoid FlightPHP matching) ---","operationId":"getApiDataResidencyAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/audit-log":{"get":{"tags":["Data residency"],"summary":"List audit log","operationId":"getApiDataResidencyAuditLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/certificates":{"get":{"tags":["Data residency"],"summary":"--- Certificates ---","operationId":"getApiDataResidencyCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/certificates/download/{downloadToken}":{"get":{"tags":["Data residency"],"summary":"Get download","operationId":"getApiDataResidencyCertificatesDownloadBydownloadtoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"downloadToken","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/certificates/{certificateId}":{"get":{"tags":["Data residency"],"summary":"Get certificate","operationId":"getApiDataResidencyCertificatesBycertificateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"certificateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/compliance-check":{"post":{"tags":["Data residency"],"summary":"--- Compliance ---","operationId":"postApiDataResidencyComplianceCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/endpoints/{endpointId}":{"delete":{"tags":["Data residency"],"summary":"Delete endpoint","operationId":"deleteApiDataResidencyEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/endpoints/{endpointId}/compliance":{"get":{"tags":["Data residency"],"summary":"List compliance","operationId":"getApiDataResidencyEndpointsByendpointidCompliance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/map":{"get":{"tags":["Data residency"],"summary":"--- Map & Audit ---","operationId":"getApiDataResidencyMap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/policies":{"post":{"tags":["Data residency"],"summary":"--- Policies ---","operationId":"postApiDataResidencyPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data residency"],"summary":"List policies","operationId":"getApiDataResidencyPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/policies/{policyId}":{"get":{"tags":["Data residency"],"summary":"Get policie","operationId":"getApiDataResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data residency"],"summary":"Update policie","operationId":"putApiDataResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data residency"],"summary":"Delete policie","operationId":"deleteApiDataResidencyPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/policies/{policyId}/certificates":{"post":{"tags":["Data residency"],"summary":"Create certificates","operationId":"postApiDataResidencyPoliciesBypolicyidCertificates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/policies/{policyId}/endpoints/{endpointId}":{"post":{"tags":["Data residency"],"summary":"--- Policy detail routes (after sub-routes) ---","operationId":"postApiDataResidencyPoliciesBypolicyidEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/regions":{"get":{"tags":["Data residency"],"summary":"--- Regions ---","operationId":"getApiDataResidencyRegions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/regions/{regionCode}":{"get":{"tags":["Data residency"],"summary":"Get region","operationId":"getApiDataResidencyRegionsByregioncode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"regionCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/violations":{"get":{"tags":["Data residency"],"summary":"--- Violations ---","operationId":"getApiDataResidencyViolations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-residency/violations/{violationId}/resolve":{"post":{"tags":["Data residency"],"summary":"Create resolve","operationId":"postApiDataResidencyViolationsByviolationidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"violationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms":{"post":{"tags":["Data rooms"],"summary":"--- Room CRUD ---","operationId":"postApiDataRooms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data rooms"],"summary":"List data rooms","operationId":"getApiDataRooms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{id}":{"get":{"tags":["Data rooms"],"summary":"Get data room","operationId":"getApiDataRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data rooms"],"summary":"Update data room","operationId":"putApiDataRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data rooms"],"summary":"Delete data room","operationId":"deleteApiDataRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{id}/activate":{"post":{"tags":["Data rooms"],"summary":"Create activate","operationId":"postApiDataRoomsByidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{id}/revoke":{"post":{"tags":["Data rooms"],"summary":"Create revoke","operationId":"postApiDataRoomsByidRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/audit":{"get":{"tags":["Data rooms"],"summary":"--- Audit Log ---","operationId":"getApiDataRoomsByroomidAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/contents":{"post":{"tags":["Data rooms"],"summary":"--- Content Management ---","operationId":"postApiDataRoomsByroomidContents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data rooms"],"summary":"List contents","operationId":"getApiDataRoomsByroomidContents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/contents/{contentId}":{"put":{"tags":["Data rooms"],"summary":"Update content","operationId":"putApiDataRoomsByroomidContentsBycontentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"contentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data rooms"],"summary":"Delete content","operationId":"deleteApiDataRoomsByroomidContentsBycontentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"contentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/messages":{"post":{"tags":["Data rooms"],"summary":"--- Messages / Q&A ---","operationId":"postApiDataRoomsByroomidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data rooms"],"summary":"List messages","operationId":"getApiDataRoomsByroomidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/messages/read":{"post":{"tags":["Data rooms"],"summary":"Create read","operationId":"postApiDataRoomsByroomidMessagesRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/participants":{"post":{"tags":["Data rooms"],"summary":"--- Participant Management ---","operationId":"postApiDataRoomsByroomidParticipants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Data rooms"],"summary":"List participants","operationId":"getApiDataRoomsByroomidParticipants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/participants/{participantId}":{"put":{"tags":["Data rooms"],"summary":"Update participant","operationId":"putApiDataRoomsByroomidParticipantsByparticipantid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"participantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data rooms"],"summary":"Delete participant","operationId":"deleteApiDataRoomsByroomidParticipantsByparticipantid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"participantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/participants/{participantId}/revoke":{"post":{"tags":["Data rooms"],"summary":"Create revoke","operationId":"postApiDataRoomsByroomidParticipantsByparticipantidRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"participantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-rooms/{roomId}/presence":{"get":{"tags":["Data rooms"],"summary":"--- Collaboration (authenticated, for room owners) ---","operationId":"getApiDataRoomsByroomidPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roomId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes":{"get":{"tags":["Data sandboxes"],"summary":"List user's sandboxes","operationId":"getApiDataSandboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes/{id}":{"get":{"tags":["Data sandboxes"],"summary":"Get a sandbox","operationId":"getApiDataSandboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Data sandboxes"],"summary":"Update sandbox metadata","operationId":"putApiDataSandboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Data sandboxes"],"summary":"Delete a sandbox","operationId":"deleteApiDataSandboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes/{id}/diff":{"get":{"tags":["Data sandboxes"],"summary":"Diff: compare sandbox against source","operationId":"getApiDataSandboxesByidDiff","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes/{id}/merge":{"post":{"tags":["Data sandboxes"],"summary":"Merge sandbox changes into source","operationId":"postApiDataSandboxesByidMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes/{id}/share":{"post":{"tags":["Data sandboxes"],"summary":"Share sandbox with users","operationId":"postApiDataSandboxesByidShare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data-sandboxes/{id}/verify-password":{"post":{"tags":["Data sandboxes"],"summary":"Verify sandbox access password","operationId":"postApiDataSandboxesByidVerifyPassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/compare-cross-endpoint":{"post":{"tags":["Dynamic Data"],"summary":"Create compare cross endpoint","operationId":"postApiDataCompareCrossEndpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/comparisons":{"get":{"tags":["Dynamic Data"],"summary":"List comparisons","operationId":"getApiDataComparisons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/comparisons/{comparisonId}":{"get":{"tags":["Dynamic Data"],"summary":"Get comparison","operationId":"getApiDataComparisonsBycomparisonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"comparisonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dynamic Data"],"summary":"Delete comparison","operationId":"deleteApiDataComparisonsBycomparisonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"comparisonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/compare":{"post":{"tags":["Dynamic Data"],"summary":"Data comparison","operationId":"postApiDataByendpointidCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/compare-batch":{"post":{"tags":["Dynamic Data"],"summary":"Create compare batch","operationId":"postApiDataByendpointidCompareBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/compare-revision":{"post":{"tags":["Dynamic Data"],"summary":"Create compare revision","operationId":"postApiDataByendpointidCompareRevision","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/compare-revisions":{"post":{"tags":["Dynamic Data"],"summary":"Create compare revisions","operationId":"postApiDataByendpointidCompareRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/records/{recordId}/annotations":{"post":{"tags":["Dynamic Data"],"summary":"Add annotation to a record","operationId":"postApiDataByendpointidRecordsByrecordidAnnotations","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dynamic Data"],"summary":"Get all annotations for a record","operationId":"getApiDataByendpointidRecordsByrecordidAnnotations","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointId}/records/{recordId}/annotations/verification":{"get":{"tags":["Dynamic Data"],"summary":"Get verification status for a record","operationId":"getApiDataByendpointidRecordsByrecordidAnnotationsVerification","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpointName}/{recordId}/predict/{modelId}":{"post":{"tags":["Dynamic Data"],"summary":"Predict for a specific record","operationId":"postApiDataByendpointnameByrecordidPredictBymodelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointName","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}":{"get":{"tags":["Dynamic Data"],"summary":"Handle all dynamic API routes","operationId":"getApiDataByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Create data","operationId":"postApiDataByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_polymorphic":{"get":{"tags":["Dynamic Data"],"summary":"Polymorphic data queries","operationId":"getApiDataByendpointPolymorphic","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_polymorphic/{recordId}":{"get":{"tags":["Dynamic Data"],"summary":"Get  polymorphic","operationId":"getApiDataByendpointPolymorphicByrecordid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash":{"get":{"tags":["Dynamic Data"],"summary":"Trash listing & stats","operationId":"getApiDataByendpointTrash","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/bulk-delete":{"post":{"tags":["Dynamic Data"],"summary":"Create bulk delete","operationId":"postApiDataByendpointTrashBulkDelete","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/bulk-restore":{"post":{"tags":["Dynamic Data"],"summary":"Create bulk restore","operationId":"postApiDataByendpointTrashBulkRestore","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/empty":{"post":{"tags":["Dynamic Data"],"summary":"Create empty","operationId":"postApiDataByendpointTrashEmpty","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/stats":{"get":{"tags":["Dynamic Data"],"summary":"List stats","operationId":"getApiDataByendpointTrashStats","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/{recordId}":{"get":{"tags":["Dynamic Data"],"summary":"Trash record preview","operationId":"getApiDataByendpointTrashByrecordid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dynamic Data"],"summary":"Permanent delete operations","operationId":"deleteApiDataByendpointTrashByrecordid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_trash/{recordId}/restore":{"post":{"tags":["Dynamic Data"],"summary":"Restore operations","operationId":"postApiDataByendpointTrashByrecordidRestore","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/_types":{"get":{"tags":["Dynamic Data"],"summary":"List  types","operationId":"getApiDataByendpointTypes","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/batch":{"post":{"tags":["Dynamic Data"],"summary":"Batch create records","operationId":"postApiDataByendpointBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dynamic Data"],"summary":"Batch update records","operationId":"putApiDataByendpointBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dynamic Data"],"summary":"Batch delete records","operationId":"deleteApiDataByendpointBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/batch-delete":{"post":{"tags":["Dynamic Data"],"summary":"data-api-feedback.md (2026-05-10).","operationId":"postApiDataByendpointBatchDelete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/batch-update":{"post":{"tags":["Dynamic Data"],"summary":"Create batch update","operationId":"postApiDataByendpointBatchUpdate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/bulk-import":{"post":{"tags":["Dynamic Data"],"summary":"Import data to endpoint","operationId":"postApiDataByendpointBulkImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/export":{"get":{"tags":["Dynamic Data"],"summary":"Export endpoint data","operationId":"getApiDataByendpointExport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/feed":{"get":{"tags":["Dynamic Data"],"summary":"List feed","operationId":"getApiDataByendpointFeed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/feed.atom":{"get":{"tags":["Dynamic Data"],"summary":"List feed.atom","operationId":"getApiDataByendpointFeedAtom","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/feed.json":{"get":{"tags":["Dynamic Data"],"summary":"Feed consumption routes \u2014 may be public depending on config","operationId":"getApiDataByendpointFeedJson","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/feed.rss":{"get":{"tags":["Dynamic Data"],"summary":"List feed.rss","operationId":"getApiDataByendpointFeedRss","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/import":{"post":{"tags":["Dynamic Data"],"summary":"Import data from external format","operationId":"postApiDataByendpointImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/revisions/config":{"get":{"tags":["Dynamic Data"],"summary":"Get revision control configuration for an endpoint","operationId":"getApiDataByendpointRevisionsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Configure revision control for an endpoint","operationId":"postApiDataByendpointRevisionsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/sample":{"get":{"tags":["Dynamic Data"],"summary":"List sample","operationId":"getApiDataByendpointSample","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/spatial-query":{"post":{"tags":["Dynamic Data"],"summary":"------------------------------------------------------------------","operationId":"postApiDataByendpointSpatialQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}":{"get":{"tags":["Dynamic Data"],"summary":"Get data","operationId":"getApiDataByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dynamic Data"],"summary":"Update data","operationId":"putApiDataByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dynamic Data"],"summary":"Delete data","operationId":"deleteApiDataByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/ancestors":{"get":{"tags":["Dynamic Data"],"summary":"============================================","operationId":"getApiDataByendpointByidAncestors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/branches":{"get":{"tags":["Dynamic Data"],"summary":"Get branches for a record","operationId":"getApiDataByendpointByidBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Create a branch for a record","operationId":"postApiDataByendpointByidBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/branches/{branchId}/merge":{"post":{"tags":["Dynamic Data"],"summary":"Merge a branch","operationId":"postApiDataByendpointByidBranchesBybranchidMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"branchId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/descendants":{"get":{"tags":["Dynamic Data"],"summary":"List descendants","operationId":"getApiDataByendpointByidDescendants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/field-history":{"get":{"tags":["Dynamic Data"],"summary":"Field Change Log \u2014 per-record field-level audit trail","operationId":"getApiDataByendpointByidFieldHistory","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/field-history/{fieldName}":{"get":{"tags":["Dynamic Data"],"summary":"Get field history","operationId":"getApiDataByendpointByidFieldHistoryByfieldname","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/hash":{"get":{"tags":["Dynamic Data"],"summary":"Compute canonical hash for client-side signing","operationId":"getApiDataByendpointByidHash","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/path-to-root":{"get":{"tags":["Dynamic Data"],"summary":"List path to root","operationId":"getApiDataByendpointByidPathToRoot","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/pin/set":{"post":{"tags":["Dynamic Data"],"summary":"Create set","operationId":"postApiDataByendpointByidPinSet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/pin/verify":{"post":{"tags":["Dynamic Data"],"summary":"Create verify","operationId":"postApiDataByendpointByidPinVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/revisions":{"get":{"tags":["Dynamic Data"],"summary":"Get revision history for a record","operationId":"getApiDataByendpointByidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/revisions/compare":{"get":{"tags":["Dynamic Data"],"summary":"Compare two revisions","operationId":"getApiDataByendpointByidRevisionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/revisions/{revisionNumber}":{"get":{"tags":["Dynamic Data"],"summary":"Get a specific revision","operationId":"getApiDataByendpointByidRevisionsByrevisionnumber","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/revisions/{revisionNumber}/restore":{"post":{"tags":["Dynamic Data"],"summary":"Restore a record to a specific revision","operationId":"postApiDataByendpointByidRevisionsByrevisionnumberRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/revisions/{revisionNumber}/tag":{"post":{"tags":["Dynamic Data"],"summary":"Tag a revision","operationId":"postApiDataByendpointByidRevisionsByrevisionnumberTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revisionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/siblings":{"get":{"tags":["Dynamic Data"],"summary":"List siblings","operationId":"getApiDataByendpointByidSiblings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/sign":{"post":{"tags":["Dynamic Data"],"summary":"Submit a digital signature for a record","operationId":"postApiDataByendpointByidSign","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/signature-chain":{"get":{"tags":["Dynamic Data"],"summary":"Get the signature chain for a record","operationId":"getApiDataByendpointByidSignatureChain","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/signatures":{"get":{"tags":["Dynamic Data"],"summary":"List all signatures on a record","operationId":"getApiDataByendpointByidSignatures","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/signatures/{sigId}":{"delete":{"tags":["Dynamic Data"],"summary":"Revoke a signature (only the signer can revoke)","operationId":"deleteApiDataByendpointByidSignaturesBysigid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sigId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/signatures/{sigId}/verify":{"post":{"tags":["Dynamic Data"],"summary":"Verify a single signature","operationId":"postApiDataByendpointByidSignaturesBysigidVerify","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sigId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/tree":{"get":{"tags":["Dynamic Data"],"summary":"List tree","operationId":"getApiDataByendpointByidTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{id}/verify":{"post":{"tags":["Dynamic Data"],"summary":"Verify all signatures on a record","operationId":"postApiDataByendpointByidVerify","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/comments":{"get":{"tags":["Dynamic Data"],"summary":"============================================","operationId":"getApiDataByendpointByrecordidComments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Create comments","operationId":"postApiDataByendpointByrecordidComments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/follow":{"post":{"tags":["Dynamic Data"],"summary":"============================================","operationId":"postApiDataByendpointByrecordidFollow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dynamic Data"],"summary":"Delete follow","operationId":"deleteApiDataByendpointByrecordidFollow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dynamic Data"],"summary":"Update follow","operationId":"putApiDataByendpointByrecordidFollow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/follow/mute":{"post":{"tags":["Dynamic Data"],"summary":"Create mute","operationId":"postApiDataByendpointByrecordidFollowMute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/follow/unmute":{"post":{"tags":["Dynamic Data"],"summary":"Create unmute","operationId":"postApiDataByendpointByrecordidFollowUnmute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/followers":{"get":{"tags":["Dynamic Data"],"summary":"List followers","operationId":"getApiDataByendpointByrecordidFollowers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/provenance":{"get":{"tags":["Dynamic Data"],"summary":"List provenance","operationId":"getApiDataByendpointByrecordidProvenance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Create provenance","operationId":"postApiDataByendpointByrecordidProvenance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/provenance/origin":{"get":{"tags":["Dynamic Data"],"summary":"List origin","operationId":"getApiDataByendpointByrecordidProvenanceOrigin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/quality-score":{"get":{"tags":["Dynamic Data"],"summary":"List quality score","operationId":"getApiDataByendpointByrecordidQualityScore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dynamic Data"],"summary":"Create quality score","operationId":"postApiDataByendpointByrecordidQualityScore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/scheduled-mutations":{"post":{"tags":["Dynamic Data"],"summary":"Record-scoped routes","operationId":"postApiDataByendpointByrecordidScheduledMutations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dynamic Data"],"summary":"List scheduled mutations","operationId":"getApiDataByendpointByrecordidScheduledMutations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/snapshots":{"post":{"tags":["Dynamic Data"],"summary":"Create a snapshot for a record","operationId":"postApiDataByendpointByrecordidSnapshots","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dynamic Data"],"summary":"List snapshots for a record","operationId":"getApiDataByendpointByrecordidSnapshots","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/snapshots/compare":{"get":{"tags":["Dynamic Data"],"summary":"Compare two snapshots of the same record","operationId":"getApiDataByendpointByrecordidSnapshotsCompare","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/tags":{"post":{"tags":["Dynamic Data"],"summary":"Create tags","operationId":"postApiDataByendpointByrecordidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dynamic Data"],"summary":"List tags","operationId":"getApiDataByendpointByrecordidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/tags/{tagId}":{"delete":{"tags":["Dynamic Data"],"summary":"Delete tag","operationId":"deleteApiDataByendpointByrecordidTagsBytagid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tagId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/translation-status":{"get":{"tags":["Dynamic Data"],"summary":"List translation status","operationId":"getApiDataByendpointByrecordidTranslationStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/translations":{"put":{"tags":["Dynamic Data"],"summary":"Update translations","operationId":"putApiDataByendpointByrecordidTranslations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Dynamic Data"],"summary":"List translations","operationId":"getApiDataByendpointByrecordidTranslations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/data/{endpoint}/{recordId}/translations/{locale}/{field}":{"delete":{"tags":["Dynamic Data"],"summary":"Delete translation","operationId":"deleteApiDataByendpointByrecordidTranslationsBylocaleByfield","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}},{"name":"field","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/debug/requests":{"get":{"tags":["Debug"],"summary":"List requests","operationId":"getApiDebugRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Debug"],"summary":"Delete requests","operationId":"deleteApiDebugRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/debug/requests/{id}":{"get":{"tags":["Debug"],"summary":"Get request","operationId":"getApiDebugRequestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/debug/status":{"get":{"tags":["Debug"],"summary":"List status","operationId":"getApiDebugStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/debug/toggle":{"post":{"tags":["Debug"],"summary":"Create toggle","operationId":"postApiDebugToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dedup-rules":{"get":{"tags":["Dedup rules"],"summary":"(one query each). Registered before the /@id route.","operationId":"getApiDedupRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dedup-rules/{id}":{"get":{"tags":["Dedup rules"],"summary":"Single rule operations (rule-level routes)","operationId":"getApiDedupRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dedup rules"],"summary":"Update dedup rule","operationId":"putApiDedupRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dedup rules"],"summary":"Delete dedup rule","operationId":"deleteApiDedupRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dedup/pending-pair-counts":{"get":{"tags":["Dedup"],"summary":"List pending pair counts","operationId":"getApiDedupPendingPairCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/deprecations":{"get":{"tags":["Deprecations"],"summary":"============================================","operationId":"getApiDeprecations","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs":{"post":{"tags":["Diffs"],"summary":"Dataset Diff CRUD","operationId":"postApiDiffs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Diffs"],"summary":"List diffs","operationId":"getApiDiffs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs/upload-csv":{"post":{"tags":["Diffs"],"summary":"CSV upload (static route \u2014 must be before parameterized @id routes)","operationId":"postApiDiffsUploadCsv","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs/{id}":{"get":{"tags":["Diffs"],"summary":"Get diff","operationId":"getApiDiffsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Diffs"],"summary":"Delete diff","operationId":"deleteApiDiffsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs/{id}/apply":{"post":{"tags":["Diffs"],"summary":"Create apply","operationId":"postApiDiffsByidApply","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs/{id}/export":{"get":{"tags":["Diffs"],"summary":"List export","operationId":"getApiDiffsByidExport","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/diffs/{id}/records":{"get":{"tags":["Diffs"],"summary":"List records","operationId":"getApiDiffsByidRecords","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/audit":{"get":{"tags":["Dns"],"summary":"List audit","operationId":"getApiDnsAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/discover":{"post":{"tags":["Dns"],"summary":"DNS zone import \u2014 discover existing records at the current provider (#297)","operationId":"postApiDnsDiscover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains":{"get":{"tags":["Dns"],"summary":"Domain management","operationId":"getApiDnsDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dns"],"summary":"Create domains","operationId":"postApiDnsDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}":{"get":{"tags":["Dns"],"summary":"Get domain","operationId":"getApiDnsDomainsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dns"],"summary":"Update domain","operationId":"putApiDnsDomainsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dns"],"summary":"Delete domain","operationId":"deleteApiDnsDomainsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/dnssec/disable":{"post":{"tags":["Dns"],"summary":"Create disable","operationId":"postApiDnsDomainsByidDnssecDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/dnssec/enable":{"post":{"tags":["Dns"],"summary":"DNSSEC management","operationId":"postApiDnsDomainsByidDnssecEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/dnssec/keys":{"get":{"tags":["Dns"],"summary":"List keys","operationId":"getApiDnsDomainsByidDnssecKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/failover":{"get":{"tags":["Dns"],"summary":"List failover","operationId":"getApiDnsDomainsByidFailover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dns"],"summary":"Create failover","operationId":"postApiDnsDomainsByidFailover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/import-records":{"post":{"tags":["Dns"],"summary":"Create import records","operationId":"postApiDnsDomainsByidImportRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/records":{"get":{"tags":["Dns"],"summary":"DNS records","operationId":"getApiDnsDomainsByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Dns"],"summary":"Create records","operationId":"postApiDnsDomainsByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/transfer":{"post":{"tags":["Dns"],"summary":"DNS domain ownership transfer (roadmap #248)","operationId":"postApiDnsDomainsByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/verification":{"get":{"tags":["Dns"],"summary":"List verification","operationId":"getApiDnsDomainsByidVerification","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/domains/{id}/verify":{"post":{"tags":["Dns"],"summary":"Domain verification","operationId":"postApiDnsDomainsByidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/failover/{id}":{"get":{"tags":["Dns"],"summary":"Get failover","operationId":"getApiDnsFailoverByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dns"],"summary":"Update failover","operationId":"putApiDnsFailoverByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dns"],"summary":"Delete failover","operationId":"deleteApiDnsFailoverByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/records/{id}":{"get":{"tags":["Dns"],"summary":"Get record","operationId":"getApiDnsRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Dns"],"summary":"Update record","operationId":"putApiDnsRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Dns"],"summary":"Delete record","operationId":"deleteApiDnsRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests":{"get":{"tags":["Dns"],"summary":"List transfer requests","operationId":"getApiDnsTransferRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests/by-id/{id}/accept":{"post":{"tags":["Dns"],"summary":"segment first (otherwise \"by-id\" would be captured as a token).","operationId":"postApiDnsTransferRequestsByIdByidAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests/by-id/{id}/decline":{"post":{"tags":["Dns"],"summary":"Create decline","operationId":"postApiDnsTransferRequestsByIdByidDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests/{id}":{"delete":{"tags":["Dns"],"summary":"Delete transfer request","operationId":"deleteApiDnsTransferRequestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests/{token}/accept":{"post":{"tags":["Dns"],"summary":"Create accept","operationId":"postApiDnsTransferRequestsBytokenAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/transfer-requests/{token}/decline":{"post":{"tags":["Dns"],"summary":"Create decline","operationId":"postApiDnsTransferRequestsBytokenDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/dns/usage":{"get":{"tags":["Dns"],"summary":"DNS usage and audit","operationId":"getApiDnsUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/docs-assistant/chat":{"post":{"tags":["Docs assistant"],"summary":"Single chat endpoint. Uses the platform AI key, no per-user billing.","operationId":"postApiDocsAssistantChat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/docs/spec":{"get":{"tags":["Docs"],"summary":"Dynamic OpenAPI spec (includes user's endpoints)","operationId":"getApiDocsSpec","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/editor/presence":{"post":{"tags":["Editor"],"summary":"Create presence","operationId":"postApiEditorPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/editor/presence/{endpointId}":{"get":{"tags":["Editor"],"summary":"Get presence","operationId":"getApiEditorPresenceByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Editor"],"summary":"Delete presence","operationId":"deleteApiEditorPresenceByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/editor/presence/{endpointId}/leave":{"post":{"tags":["Editor"],"summary":"POST variant for sendBeacon (which only supports POST)","operationId":"postApiEditorPresenceByendpointidLeave","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts":{"get":{"tags":["Email"],"summary":"Email Accounts","operationId":"getApiEmailAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create accounts","operationId":"postApiEmailAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/archive-policies":{"get":{"tags":["Email"],"summary":"Account-scoped Archive Policies","operationId":"getApiEmailAccountsByaccountidArchivePolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create archive policies","operationId":"postApiEmailAccountsByaccountidArchivePolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/archive-policies/{policyId}":{"delete":{"tags":["Email"],"summary":"Delete archive policie","operationId":"deleteApiEmailAccountsByaccountidArchivePoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/auto-responders":{"get":{"tags":["Email"],"summary":"Account-scoped Auto-Responders","operationId":"getApiEmailAccountsByaccountidAutoResponders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/bounces":{"get":{"tags":["Email"],"summary":"Delivery failures for an account: ?since=&bounce_type=&limit=&offset= (#348)","operationId":"getApiEmailAccountsByaccountidBounces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/categories":{"get":{"tags":["Email"],"summary":"Account-scoped Categories","operationId":"getApiEmailAccountsByaccountidCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/drafts":{"get":{"tags":["Email"],"summary":"Account-scoped Drafts","operationId":"getApiEmailAccountsByaccountidDrafts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create drafts","operationId":"postApiEmailAccountsByaccountidDrafts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/drafts/{draftId}":{"put":{"tags":["Email"],"summary":"Update draft","operationId":"putApiEmailAccountsByaccountidDraftsBydraftid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"draftId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete draft","operationId":"deleteApiEmailAccountsByaccountidDraftsBydraftid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"draftId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/labels":{"get":{"tags":["Email"],"summary":"Account-scoped Labels","operationId":"getApiEmailAccountsByaccountidLabels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create labels","operationId":"postApiEmailAccountsByaccountidLabels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/labels/{labelId}":{"put":{"tags":["Email"],"summary":"Update label","operationId":"putApiEmailAccountsByaccountidLabelsBylabelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete label","operationId":"deleteApiEmailAccountsByaccountidLabelsBylabelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages":{"get":{"tags":["Email"],"summary":"Email Messages","operationId":"getApiEmailAccountsByaccountidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/purge":{"delete":{"tags":["Email"],"summary":"Delete purge","operationId":"deleteApiEmailAccountsByaccountidMessagesPurge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}":{"get":{"tags":["Email"],"summary":"Account-scoped Message Routes (single message operations)","operationId":"getApiEmailAccountsByaccountidMessagesBymessageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete message","operationId":"deleteApiEmailAccountsByaccountidMessagesBymessageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/move":{"post":{"tags":["Email"],"summary":"Create move","operationId":"postApiEmailAccountsByaccountidMessagesBymessageidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/read":{"post":{"tags":["Email"],"summary":"Create read","operationId":"postApiEmailAccountsByaccountidMessagesBymessageidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update read","operationId":"putApiEmailAccountsByaccountidMessagesBymessageidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete read","operationId":"deleteApiEmailAccountsByaccountidMessagesBymessageidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/smart-replies":{"get":{"tags":["Email"],"summary":"Account-scoped Smart Replies (message-level under account)","operationId":"getApiEmailAccountsByaccountidMessagesBymessageidSmartReplies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/spoof-check":{"get":{"tags":["Email"],"summary":"Account-scoped Spoof Check (per-message under account)","operationId":"getApiEmailAccountsByaccountidMessagesBymessageidSpoofCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/star":{"post":{"tags":["Email"],"summary":"Create star","operationId":"postApiEmailAccountsByaccountidMessagesBymessageidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update star","operationId":"putApiEmailAccountsByaccountidMessagesBymessageidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete star","operationId":"deleteApiEmailAccountsByaccountidMessagesBymessageidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/unread":{"post":{"tags":["Email"],"summary":"Create unread","operationId":"postApiEmailAccountsByaccountidMessagesBymessageidUnread","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/messages/{messageId}/unstar":{"post":{"tags":["Email"],"summary":"Create unstar","operationId":"postApiEmailAccountsByaccountidMessagesBymessageidUnstar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/outbound":{"get":{"tags":["Email"],"summary":"Sent-items view over the outbound queue: ?status=&since=&limit=&offset=","operationId":"getApiEmailAccountsByaccountidOutbound","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/priority":{"get":{"tags":["Email"],"summary":"Account-scoped Priority Inbox","operationId":"getApiEmailAccountsByaccountidPriority","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/rules":{"get":{"tags":["Email"],"summary":"Account-scoped Rules","operationId":"getApiEmailAccountsByaccountidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create rules","operationId":"postApiEmailAccountsByaccountidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/rules/{ruleId}":{"get":{"tags":["Email"],"summary":"Get rule","operationId":"getApiEmailAccountsByaccountidRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update rule","operationId":"putApiEmailAccountsByaccountidRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete rule","operationId":"deleteApiEmailAccountsByaccountidRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/rules/{ruleId}/toggle":{"post":{"tags":["Email"],"summary":"Create toggle","operationId":"postApiEmailAccountsByaccountidRulesByruleidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/scheduled":{"get":{"tags":["Email"],"summary":"Account-scoped Scheduled Sends","operationId":"getApiEmailAccountsByaccountidScheduled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create scheduled","operationId":"postApiEmailAccountsByaccountidScheduled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/scheduled/{scheduleId}":{"delete":{"tags":["Email"],"summary":"Delete scheduled","operationId":"deleteApiEmailAccountsByaccountidScheduledByscheduleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"scheduleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/search":{"post":{"tags":["Email"],"summary":"Account-scoped Search","operationId":"postApiEmailAccountsByaccountidSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/search/advanced":{"post":{"tags":["Email"],"summary":"Create advanced","operationId":"postApiEmailAccountsByaccountidSearchAdvanced","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/searches":{"get":{"tags":["Email"],"summary":"Account-scoped Saved Searches","operationId":"getApiEmailAccountsByaccountidSearches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create searches","operationId":"postApiEmailAccountsByaccountidSearches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/searches/{searchId}":{"delete":{"tags":["Email"],"summary":"Delete searche","operationId":"deleteApiEmailAccountsByaccountidSearchesBysearchid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"searchId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/send":{"post":{"tags":["Email"],"summary":"Email Send (queue outbound)","operationId":"postApiEmailAccountsByaccountidSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/shares":{"get":{"tags":["Email"],"summary":"Who can reach this mailbox","operationId":"getApiEmailAccountsByaccountidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Grant read, or read and send. Re-granting updates the existing grant.","operationId":"postApiEmailAccountsByaccountidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/shares/{shareId}":{"delete":{"tags":["Email"],"summary":"Revoke a grant","operationId":"deleteApiEmailAccountsByaccountidSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/smart-settings":{"get":{"tags":["Email"],"summary":"Account-scoped Smart Settings","operationId":"getApiEmailAccountsByaccountidSmartSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/threads":{"get":{"tags":["Email"],"summary":"Email Threads","operationId":"getApiEmailAccountsByaccountidThreads","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/trust":{"get":{"tags":["Email"],"summary":"Account-scoped Trust","operationId":"getApiEmailAccountsByaccountidTrust","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create trust","operationId":"postApiEmailAccountsByaccountidTrust","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{accountId}/trust/{entryId}":{"delete":{"tags":["Email"],"summary":"Delete trust","operationId":"deleteApiEmailAccountsByaccountidTrustByentryid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}":{"get":{"tags":["Email"],"summary":"Get account","operationId":"getApiEmailAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update account","operationId":"putApiEmailAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete account","operationId":"deleteApiEmailAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/auto-sort":{"get":{"tags":["Email"],"summary":"List auto sort","operationId":"getApiEmailAccountsByidAutoSort","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update auto sort","operationId":"putApiEmailAccountsByidAutoSort","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/auto-sort/run":{"post":{"tags":["Email"],"summary":"---- Auto-sort worker: per-account mode + move review/undo (#324) ----","operationId":"postApiEmailAccountsByidAutoSortRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/dav-status":{"get":{"tags":["Email"],"summary":"List dav status","operationId":"getApiEmailAccountsByidDavStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/default":{"post":{"tags":["Email"],"summary":"Create default","operationId":"postApiEmailAccountsByidDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/discover-dav":{"post":{"tags":["Email"],"summary":"Create discover dav","operationId":"postApiEmailAccountsByidDiscoverDav","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/encryption":{"get":{"tags":["Email"],"summary":"List encryption","operationId":"getApiEmailAccountsByidEncryption","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/encryption/disable":{"post":{"tags":["Email"],"summary":"Create disable","operationId":"postApiEmailAccountsByidEncryptionDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/encryption/enable":{"post":{"tags":["Email"],"summary":"Email Account Encryption","operationId":"postApiEmailAccountsByidEncryptionEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/flags":{"post":{"tags":["Email"],"summary":"Current flags for a list of UIDs + which are gone (flags only, live, read-only).","operationId":"postApiEmailAccountsByidFlags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/folders":{"get":{"tags":["Email"],"summary":"List folders","operationId":"getApiEmailAccountsByidFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"as a folder name. Enforced by bin/route-check.php.","operationId":"postApiEmailAccountsByidFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/folders/live":{"get":{"tags":["Email"],"summary":"List live","operationId":"getApiEmailAccountsByidFoldersLive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/folders/status":{"get":{"tags":["Email"],"summary":"meta.errors. See EmailAccountService::folderStatusLive().","operationId":"getApiEmailAccountsByidFoldersStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/folders/{folder}":{"put":{"tags":["Email"],"summary":"Update folder","operationId":"putApiEmailAccountsByidFoldersByfolder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"(INBOX, Sent, Drafts, Trash, Junk, Archive) are refused by the service.","operationId":"deleteApiEmailAccountsByidFoldersByfolder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/folders/{folder}/expunge":{"post":{"tags":["Email"],"summary":"user's own mail client flagged and has not yet purged.","operationId":"postApiEmailAccountsByidFoldersByfolderExpunge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/idle-push":{"get":{"tags":["Email"],"summary":"call that prefix and must never opt a mailbox in for itself.","operationId":"getApiEmailAccountsByidIdlePush","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update idle push","operationId":"putApiEmailAccountsByidIdlePush","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/messages/{folder}/{uid}":{"get":{"tags":["Email"],"summary":"@folder=<uuid>, @uid='smart-replies' and failing as \"Invalid UID\".","operationId":"getApiEmailAccountsByidMessagesByfolderByuid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}},{"name":"uid","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/messages/{folder}/{uid}/attachments/{part}":{"get":{"tags":["Email"],"summary":"content_base64 }, capped at 25 MiB.","operationId":"getApiEmailAccountsByidMessagesByfolderByuidAttachmentsBypart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}},{"name":"uid","in":"path","required":true,"schema":{"type":"integer"}},{"name":"part","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/messages/{folder}/{uid}/flags":{"post":{"tags":["Email"],"summary":"Mark-read is the highest-frequency write in any mail client.","operationId":"postApiEmailAccountsByidMessagesByfolderByuidFlags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}},{"name":"uid","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/messages/{folder}/{uid}/move":{"post":{"tags":["Email"],"summary":"is reversible by the user from any client. Does NOT expunge by default.","operationId":"postApiEmailAccountsByidMessagesByfolderByuidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folder","in":"path","required":true,"schema":{"type":"string"}},{"name":"uid","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/notification-config":{"get":{"tags":["Email"],"summary":"List notification config","operationId":"getApiEmailAccountsByidNotificationConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"read-then-branch between POST and PUT (roadmap #450).","operationId":"putApiEmailAccountsByidNotificationConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/notification-recipients":{"get":{"tags":["Email"],"summary":"stops each of them. Owner or super-admin only (roadmap #452).","operationId":"getApiEmailAccountsByidNotificationRecipients","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/oauth/tokens":{"post":{"tags":["Email"],"summary":"Create tokens","operationId":"postApiEmailAccountsByidOauthTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List tokens","operationId":"getApiEmailAccountsByidOauthTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete tokens","operationId":"deleteApiEmailAccountsByidOauthTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/peek-new":{"get":{"tags":["Email"],"summary":"(default) and ?limit=50 (max 200).","operationId":"getApiEmailAccountsByidPeekNew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Query/body: consumer_key (default 'default'), folder (default INBOX). Idempotent.","operationId":"deleteApiEmailAccountsByidPeekNew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/peek-new/cursors":{"get":{"tags":["Email"],"summary":"peek-by-UID route below is digit-restricted, so \"cursors\" cannot collide.","operationId":"getApiEmailAccountsByidPeekNewCursors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/peek-new/reset":{"post":{"tags":["Email"],"summary":"Create reset","operationId":"postApiEmailAccountsByidPeekNewReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/search/live":{"post":{"tags":["Email"],"summary":"multi-folder form is genuinely N round trips and reports how many it made.","operationId":"postApiEmailAccountsByidSearchLive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/stats":{"get":{"tags":["Email"],"summary":"List stats","operationId":"getApiEmailAccountsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/sync":{"post":{"tags":["Email"],"summary":"Account: Sync","operationId":"postApiEmailAccountsByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/sync-calendar":{"post":{"tags":["Email"],"summary":"Create sync calendar","operationId":"postApiEmailAccountsByidSyncCalendar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/sync-contacts":{"post":{"tags":["Email"],"summary":"Create sync contacts","operationId":"postApiEmailAccountsByidSyncContacts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/sync-status":{"get":{"tags":["Email"],"summary":"List sync status","operationId":"getApiEmailAccountsByidSyncStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/test":{"post":{"tags":["Email"],"summary":"Account: Test Connection (unified test endpoint)","operationId":"postApiEmailAccountsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/test-caldav":{"post":{"tags":["Email"],"summary":"Create test caldav","operationId":"postApiEmailAccountsByidTestCaldav","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/test-carddav":{"post":{"tags":["Email"],"summary":"========== DAV Sync (CardDAV/CalDAV) ==========","operationId":"postApiEmailAccountsByidTestCarddav","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/test-imap":{"post":{"tags":["Email"],"summary":"Create test imap","operationId":"postApiEmailAccountsByidTestImap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/test-smtp":{"post":{"tags":["Email"],"summary":"Create test smtp","operationId":"postApiEmailAccountsByidTestSmtp","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/accounts/{id}/unread-counts":{"get":{"tags":["Email"],"summary":"List unread counts","operationId":"getApiEmailAccountsByidUnreadCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/archive-policies":{"get":{"tags":["Email"],"summary":"Archive Policies","operationId":"getApiEmailArchivePolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create archive policies","operationId":"postApiEmailArchivePolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/archive-policies/{id}":{"get":{"tags":["Email"],"summary":"Get archive policie","operationId":"getApiEmailArchivePoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update archive policie","operationId":"putApiEmailArchivePoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete archive policie","operationId":"deleteApiEmailArchivePoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/assignments":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List assignments","operationId":"getApiEmailAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/assignments/stats":{"get":{"tags":["Email"],"summary":"List stats","operationId":"getApiEmailAssignmentsStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/assignments/{id}":{"get":{"tags":["Email"],"summary":"Get assignment","operationId":"getApiEmailAssignmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update assignment","operationId":"putApiEmailAssignmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete assignment","operationId":"deleteApiEmailAssignmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/attachments/{attachmentId}/file-to-area":{"post":{"tags":["Email"],"summary":"run_ocr?, ocr_languages?: [\"deu\"], dry_run? }","operationId":"postApiEmailAttachmentsByattachmentidFileToArea","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-responses":{"get":{"tags":["Email"],"summary":"Auto-Responses","operationId":"getApiEmailAutoResponses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create auto responses","operationId":"postApiEmailAutoResponses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-responses/active":{"get":{"tags":["Email"],"summary":"List active","operationId":"getApiEmailAutoResponsesActive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-responses/{id}":{"get":{"tags":["Email"],"summary":"Get auto response","operationId":"getApiEmailAutoResponsesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update auto response","operationId":"putApiEmailAutoResponsesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete auto response","operationId":"deleteApiEmailAutoResponsesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-responses/{id}/test":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailAutoResponsesByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-responses/{id}/toggle":{"post":{"tags":["Email"],"summary":"Create toggle","operationId":"postApiEmailAutoResponsesByidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/moves":{"get":{"tags":["Email"],"summary":"List moves","operationId":"getApiEmailAutoSortMoves","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/moves/{id}/approve":{"post":{"tags":["Email"],"summary":"Create approve","operationId":"postApiEmailAutoSortMovesByidApprove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/moves/{id}/dismiss":{"post":{"tags":["Email"],"summary":"Create dismiss","operationId":"postApiEmailAutoSortMovesByidDismiss","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/moves/{id}/revert":{"post":{"tags":["Email"],"summary":"Create revert","operationId":"postApiEmailAutoSortMovesByidRevert","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/observations":{"get":{"tags":["Email"],"summary":"List observations","operationId":"getApiEmailAutoSortObservations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete observations","operationId":"deleteApiEmailAutoSortObservations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/observe":{"post":{"tags":["Email"],"summary":"---- Learned auto-sort (#324): the shared sensor/suggest surface ----","operationId":"postApiEmailAutoSortObserve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/auto-sort/suggest":{"get":{"tags":["Email"],"summary":"List suggest","operationId":"getApiEmailAutoSortSuggest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/autodiscover":{"post":{"tags":["Email"],"summary":"Email Autodiscover (no auth required - used during account setup)","operationId":"postApiEmailAutodiscover","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited":{"get":{"tags":["Email"],"summary":"Awaited Responses","operationId":"getApiEmailAwaited","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create awaited","operationId":"postApiEmailAwaited","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited/overdue":{"get":{"tags":["Email"],"summary":"List overdue","operationId":"getApiEmailAwaitedOverdue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited/{id}":{"get":{"tags":["Email"],"summary":"Get awaited","operationId":"getApiEmailAwaitedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited/{id}/cancel":{"post":{"tags":["Email"],"summary":"Create cancel","operationId":"postApiEmailAwaitedByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited/{id}/escalate":{"post":{"tags":["Email"],"summary":"Create escalate","operationId":"postApiEmailAwaitedByidEscalate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/awaited/{id}/received":{"post":{"tags":["Email"],"summary":"Create received","operationId":"postApiEmailAwaitedByidReceived","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups":{"post":{"tags":["Email"],"summary":"Backups","operationId":"postApiEmailBackups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List backups","operationId":"getApiEmailBackups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/import":{"post":{"tags":["Email"],"summary":"Import","operationId":"postApiEmailBackupsImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/restore-jobs":{"get":{"tags":["Email"],"summary":"Restore jobs (must be before /api/email/backups/@id to avoid route conflicts)","operationId":"getApiEmailBackupsRestoreJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/restore-jobs/{id}":{"get":{"tags":["Email"],"summary":"Get restore job","operationId":"getApiEmailBackupsRestoreJobsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/schedules":{"post":{"tags":["Email"],"summary":"Schedules (must be before /api/email/backups/@id to avoid route conflicts)","operationId":"postApiEmailBackupsSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List schedules","operationId":"getApiEmailBackupsSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/schedules/{id}":{"get":{"tags":["Email"],"summary":"Get schedule","operationId":"getApiEmailBackupsSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update schedule","operationId":"putApiEmailBackupsSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete schedule","operationId":"deleteApiEmailBackupsSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/{id}":{"get":{"tags":["Email"],"summary":"Individual backup operations (after fixed routes)","operationId":"getApiEmailBackupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete backup","operationId":"deleteApiEmailBackupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/{id}/chain":{"delete":{"tags":["Email"],"summary":"Delete chain","operationId":"deleteApiEmailBackupsByidChain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/{id}/copies":{"get":{"tags":["Email"],"summary":"List copies","operationId":"getApiEmailBackupsByidCopies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/{id}/download":{"get":{"tags":["Email"],"summary":"List download","operationId":"getApiEmailBackupsByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/backups/{id}/restore":{"post":{"tags":["Email"],"summary":"Create restore","operationId":"postApiEmailBackupsByidRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/bounces":{"get":{"tags":["Email"],"summary":"caller should already know the address they are asking about.","operationId":"getApiEmailBounces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/attendees/{id}":{"put":{"tags":["Email"],"summary":"Update attendee","operationId":"putApiEmailCalendarAttendeesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete attendee","operationId":"deleteApiEmailCalendarAttendeesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/events":{"get":{"tags":["Email"],"summary":"========== Email Calendar (Phase 5) ==========","operationId":"getApiEmailCalendarEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create events","operationId":"postApiEmailCalendarEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/events/{id}":{"get":{"tags":["Email"],"summary":"Get event","operationId":"getApiEmailCalendarEventsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update event","operationId":"putApiEmailCalendarEventsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete event","operationId":"deleteApiEmailCalendarEventsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/events/{id}/attendees":{"get":{"tags":["Email"],"summary":"Attendees","operationId":"getApiEmailCalendarEventsByidAttendees","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create attendees","operationId":"postApiEmailCalendarEventsByidAttendees","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/events/{id}/recurrence":{"get":{"tags":["Email"],"summary":"Recurrence","operationId":"getApiEmailCalendarEventsByidRecurrence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update recurrence","operationId":"putApiEmailCalendarEventsByidRecurrence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/invitations":{"get":{"tags":["Email"],"summary":"Invitations","operationId":"getApiEmailCalendarInvitations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/invitations/pending":{"get":{"tags":["Email"],"summary":"List pending","operationId":"getApiEmailCalendarInvitationsPending","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/invitations/{id}":{"get":{"tags":["Email"],"summary":"Get invitation","operationId":"getApiEmailCalendarInvitationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/calendar/invitations/{id}/respond":{"post":{"tags":["Email"],"summary":"Create respond","operationId":"postApiEmailCalendarInvitationsByidRespond","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/categories":{"get":{"tags":["Email"],"summary":"Categories","operationId":"getApiEmailCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create categories","operationId":"postApiEmailCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/categories/{id}":{"get":{"tags":["Email"],"summary":"Get categorie","operationId":"getApiEmailCategoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update categorie","operationId":"putApiEmailCategoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete categorie","operationId":"deleteApiEmailCategoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/categories/{id}/messages":{"get":{"tags":["Email"],"summary":"List messages","operationId":"getApiEmailCategoriesByidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/classification/rules":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailClassificationRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List rules","operationId":"getApiEmailClassificationRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/classification/rules/{id}":{"get":{"tags":["Email"],"summary":"Get rule","operationId":"getApiEmailClassificationRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update rule","operationId":"putApiEmailClassificationRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete rule","operationId":"deleteApiEmailClassificationRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts":{"get":{"tags":["Email"],"summary":"========== Email Contacts (Phase 4) ==========","operationId":"getApiEmailContacts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create contacts","operationId":"postApiEmailContacts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/blocked":{"get":{"tags":["Email"],"summary":"List blocked","operationId":"getApiEmailContactsBlocked","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/interactions":{"post":{"tags":["Email"],"summary":"Create interactions","operationId":"postApiEmailContactsInteractions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/top":{"get":{"tags":["Email"],"summary":"List top","operationId":"getApiEmailContactsTop","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/vip":{"get":{"tags":["Email"],"summary":"List vip","operationId":"getApiEmailContactsVip","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/{id}":{"get":{"tags":["Email"],"summary":"Get contact","operationId":"getApiEmailContactsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update contact","operationId":"putApiEmailContactsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete contact","operationId":"deleteApiEmailContactsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/{id}/block":{"post":{"tags":["Email"],"summary":"Create block","operationId":"postApiEmailContactsByidBlock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete block","operationId":"deleteApiEmailContactsByidBlock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/{id}/interactions":{"get":{"tags":["Email"],"summary":"List interactions","operationId":"getApiEmailContactsByidInteractions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/{id}/score":{"get":{"tags":["Email"],"summary":"List score","operationId":"getApiEmailContactsByidScore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/contacts/{id}/vip":{"post":{"tags":["Email"],"summary":"Create vip","operationId":"postApiEmailContactsByidVip","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Email Contacts: DELETE routes for VIP/Block (405 fix)","operationId":"deleteApiEmailContactsByidVip","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/delivery/bounces":{"get":{"tags":["Email"],"summary":"List bounces","operationId":"getApiEmailDeliveryBounces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/delivery/stats":{"get":{"tags":["Email"],"summary":"List stats","operationId":"getApiEmailDeliveryStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/delivery/webhook":{"post":{"tags":["Email"],"summary":"Public webhook endpoint - NO authentication required","operationId":"postApiEmailDeliveryWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/digests":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailDigests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List digests","operationId":"getApiEmailDigests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/digests/{id}":{"get":{"tags":["Email"],"summary":"Get digest","operationId":"getApiEmailDigestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update digest","operationId":"putApiEmailDigestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete digest","operationId":"deleteApiEmailDigestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/digests/{id}/preview":{"post":{"tags":["Email"],"summary":"Create preview","operationId":"postApiEmailDigestsByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/digests/{id}/send-now":{"post":{"tags":["Email"],"summary":"Create send now","operationId":"postApiEmailDigestsByidSendNow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/document-intake-items":{"get":{"tags":["Email"],"summary":"matched as a rule id.","operationId":"getApiEmailDocumentIntakeItems","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/document-intake-items/{itemId}/retry-ocr":{"post":{"tags":["Email"],"summary":"Create retry ocr","operationId":"postApiEmailDocumentIntakeItemsByitemidRetryOcr","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"itemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/document-intake-rules":{"post":{"tags":["Email"],"summary":"Create document intake rules","operationId":"postApiEmailDocumentIntakeRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List document intake rules","operationId":"getApiEmailDocumentIntakeRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/document-intake-rules/{ruleId}":{"get":{"tags":["Email"],"summary":"Get document intake rule","operationId":"getApiEmailDocumentIntakeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update document intake rule","operationId":"putApiEmailDocumentIntakeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete document intake rule","operationId":"deleteApiEmailDocumentIntakeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/document-intake-rules/{ruleId}/run":{"post":{"tags":["Email"],"summary":"not swallowed by the placeholder.","operationId":"postApiEmailDocumentIntakeRulesByruleidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/documents":{"get":{"tags":["Email"],"summary":"Documents","operationId":"getApiEmailDocuments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/documents/search":{"get":{"tags":["Email"],"summary":"List search","operationId":"getApiEmailDocumentsSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/documents/{id}":{"get":{"tags":["Email"],"summary":"Get document","operationId":"getApiEmailDocumentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/drafts":{"get":{"tags":["Email"],"summary":"Drafts","operationId":"getApiEmailDrafts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create drafts","operationId":"postApiEmailDrafts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/drafts/{id}":{"get":{"tags":["Email"],"summary":"Get draft","operationId":"getApiEmailDraftsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update draft","operationId":"putApiEmailDraftsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete draft","operationId":"deleteApiEmailDraftsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/drafts/{id}/send":{"post":{"tags":["Email"],"summary":"Create send","operationId":"postApiEmailDraftsByidSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus-mode":{"get":{"tags":["Email"],"summary":"Focus Mode (simplified alias routes)","operationId":"getApiEmailFocusMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create focus mode","operationId":"postApiEmailFocusMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus-mode/{id}":{"delete":{"tags":["Email"],"summary":"Delete focus mode","operationId":"deleteApiEmailFocusModeByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus/active":{"get":{"tags":["Email"],"summary":"List active","operationId":"getApiEmailFocusActive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus/configs":{"get":{"tags":["Email"],"summary":"Focus Mode","operationId":"getApiEmailFocusConfigs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create configs","operationId":"postApiEmailFocusConfigs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus/configs/{id}":{"get":{"tags":["Email"],"summary":"Get config","operationId":"getApiEmailFocusConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update config","operationId":"putApiEmailFocusConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete config","operationId":"deleteApiEmailFocusConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus/configs/{id}/activate":{"post":{"tags":["Email"],"summary":"Create activate","operationId":"postApiEmailFocusConfigsByidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/focus/deactivate":{"post":{"tags":["Email"],"summary":"Create deactivate","operationId":"postApiEmailFocusDeactivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups":{"get":{"tags":["Email"],"summary":"========== Email Groups (Phase 2) ==========","operationId":"getApiEmailGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create groups","operationId":"postApiEmailGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{groupId}/inbox":{"get":{"tags":["Email"],"summary":"Group Inbox (per-group)","operationId":"getApiEmailGroupsBygroupidInbox","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{groupId}/members/{accountId}":{"delete":{"tags":["Email"],"summary":"Delete member","operationId":"deleteApiEmailGroupsBygroupidMembersByaccountid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{id}":{"get":{"tags":["Email"],"summary":"Get group","operationId":"getApiEmailGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update group","operationId":"putApiEmailGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete group","operationId":"deleteApiEmailGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{id}/members":{"post":{"tags":["Email"],"summary":"Create members","operationId":"postApiEmailGroupsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{id}/members/order":{"put":{"tags":["Email"],"summary":"Update order","operationId":"putApiEmailGroupsByidMembersOrder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/groups/{id}/notification-config":{"get":{"tags":["Email"],"summary":"List notification config","operationId":"getApiEmailGroupsByidNotificationConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/accounts/{accountId}/credentials":{"get":{"tags":["Email"],"summary":"and only while it is watching. Every issue is written to the activity log.","operationId":"getApiEmailIdleAccountsByaccountidCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/accounts/{accountId}/error":{"post":{"tags":["Email"],"summary":"Trouble on a watched mailbox, without losing the lease","operationId":"postApiEmailIdleAccountsByaccountidError","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/accounts/{accountId}/report":{"post":{"tags":["Email"],"summary":"The doorbell. Only the live lease holder may ring it.","operationId":"postApiEmailIdleAccountsByaccountidReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/claim":{"post":{"tags":["Email"],"summary":"Take accounts nobody is currently watching","operationId":"postApiEmailIdleClaim","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/heartbeat":{"post":{"tags":["Email"],"summary":"or two daemons announce the same mail.","operationId":"postApiEmailIdleHeartbeat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/release":{"post":{"tags":["Email"],"summary":"Hand accounts back on a clean shutdown so failover is instant","operationId":"postApiEmailIdleRelease","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/idle/status":{"get":{"tags":["Email"],"summary":"Who is watching what","operationId":"getApiEmailIdleStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/ingestion/ingest/{emailId}":{"post":{"tags":["Email"],"summary":"Create ingest","operationId":"postApiEmailIngestionIngestByemailid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"emailId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/ingestion/rules":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailIngestionRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List rules","operationId":"getApiEmailIngestionRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/ingestion/rules/{id}":{"get":{"tags":["Email"],"summary":"Get rule","operationId":"getApiEmailIngestionRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update rule","operationId":"putApiEmailIngestionRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete rule","operationId":"deleteApiEmailIngestionRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/ingestion/rules/{id}/test":{"post":{"tags":["Email"],"summary":"Create test","operationId":"postApiEmailIngestionRulesByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/labels":{"get":{"tags":["Email"],"summary":"Email Labels","operationId":"getApiEmailLabels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create labels","operationId":"postApiEmailLabels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/labels/{id}":{"get":{"tags":["Email"],"summary":"Get label","operationId":"getApiEmailLabelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update label","operationId":"putApiEmailLabelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete label","operationId":"deleteApiEmailLabelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/labels/{id}/messages":{"get":{"tags":["Email"],"summary":"List messages","operationId":"getApiEmailLabelsByidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/batch":{"post":{"tags":["Email"],"summary":"Create batch","operationId":"postApiEmailMessagesBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}":{"get":{"tags":["Email"],"summary":"Get message","operationId":"getApiEmailMessagesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete message","operationId":"deleteApiEmailMessagesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/categories":{"get":{"tags":["Email"],"summary":"List categories","operationId":"getApiEmailMessagesByidCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/classification":{"get":{"tags":["Email"],"summary":"List classification","operationId":"getApiEmailMessagesByidClassification","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/classify":{"post":{"tags":["Email"],"summary":"Create classify","operationId":"postApiEmailMessagesByidClassify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/delivery":{"get":{"tags":["Email"],"summary":"============================================","operationId":"getApiEmailMessagesByidDelivery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/flag":{"post":{"tags":["Email"],"summary":"Create flag","operationId":"postApiEmailMessagesByidFlag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/headers":{"get":{"tags":["Email"],"summary":"List headers","operationId":"getApiEmailMessagesByidHeaders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/move":{"post":{"tags":["Email"],"summary":"Create move","operationId":"postApiEmailMessagesByidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/notes":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailMessagesByidNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List notes","operationId":"getApiEmailMessagesByidNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/permanent":{"delete":{"tags":["Email"],"summary":"Delete permanent","operationId":"deleteApiEmailMessagesByidPermanent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/priority":{"get":{"tags":["Email"],"summary":"Priority","operationId":"getApiEmailMessagesByidPriority","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update priority","operationId":"putApiEmailMessagesByidPriority","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/read":{"post":{"tags":["Email"],"summary":"Create read","operationId":"postApiEmailMessagesByidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update read","operationId":"putApiEmailMessagesByidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete read","operationId":"deleteApiEmailMessagesByidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/records":{"get":{"tags":["Email"],"summary":"List records","operationId":"getApiEmailMessagesByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/sentiment":{"get":{"tags":["Email"],"summary":"Sentiment","operationId":"getApiEmailMessagesByidSentiment","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update sentiment","operationId":"putApiEmailMessagesByidSentiment","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/smart-replies":{"get":{"tags":["Email"],"summary":"Smart Replies","operationId":"getApiEmailMessagesByidSmartReplies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create smart replies","operationId":"postApiEmailMessagesByidSmartReplies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/smart-replies/use/{replyId}":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailMessagesByidSmartRepliesUseByreplyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"replyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/star":{"post":{"tags":["Email"],"summary":"Create star","operationId":"postApiEmailMessagesByidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update star","operationId":"putApiEmailMessagesByidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete star","operationId":"deleteApiEmailMessagesByidStar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{id}/unread":{"post":{"tags":["Email"],"summary":"Create unread","operationId":"postApiEmailMessagesByidUnread","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{messageId}/categories/{categoryId}":{"post":{"tags":["Email"],"summary":"Create categorie","operationId":"postApiEmailMessagesBymessageidCategoriesBycategoryid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"categoryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete categorie","operationId":"deleteApiEmailMessagesBymessageidCategoriesBycategoryid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"categoryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{messageId}/labels":{"get":{"tags":["Email"],"summary":"List labels","operationId":"getApiEmailMessagesBymessageidLabels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{messageId}/labels/{labelId}":{"post":{"tags":["Email"],"summary":"Create label","operationId":"postApiEmailMessagesBymessageidLabelsBylabelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete label","operationId":"deleteApiEmailMessagesBymessageidLabelsBylabelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/messages/{messageId}/metadata":{"get":{"tags":["Email"],"summary":"Read a message's searchable metadata","operationId":"getApiEmailMessagesBymessageidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"writers owning different keys cannot silently delete each other's.","operationId":"putApiEmailMessagesBymessageidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/notes/{noteId}":{"put":{"tags":["Email"],"summary":"Update note","operationId":"putApiEmailNotesBynoteid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"noteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete note","operationId":"deleteApiEmailNotesBynoteid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"noteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/notification-configs":{"get":{"tags":["Email"],"summary":"========== Email Notification Configs (Phase 2) ==========","operationId":"getApiEmailNotificationConfigs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create notification configs","operationId":"postApiEmailNotificationConfigs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/notification-configs/{id}":{"get":{"tags":["Email"],"summary":"Get notification config","operationId":"getApiEmailNotificationConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update notification config","operationId":"putApiEmailNotificationConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete notification config","operationId":"deleteApiEmailNotificationConfigsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/oauth/providers":{"get":{"tags":["Email"],"summary":"OAuth Providers (global)","operationId":"getApiEmailOauthProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outbound/{id}":{"get":{"tags":["Email"],"summary":"GET /api/email/messages/{id} 404s on it.","operationId":"getApiEmailOutboundByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/domains":{"get":{"tags":["Email"],"summary":"---- domains ----","operationId":"getApiEmailOutgoingDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create domains","operationId":"postApiEmailOutgoingDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/domains/{id}/publish-dns":{"post":{"tags":["Email"],"summary":"tenant. The reason this feature is ours rather than a link to Resend.","operationId":"postApiEmailOutgoingDomainsByidPublishDns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/domains/{id}/verify":{"post":{"tags":["Email"],"summary":"Create verify","operationId":"postApiEmailOutgoingDomainsByidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/messages":{"get":{"tags":["Email"],"summary":"List messages","operationId":"getApiEmailOutgoingMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/messages/{id}":{"get":{"tags":["Email"],"summary":"---- a single message, last so it cannot shadow the named routes above ----","operationId":"getApiEmailOutgoingMessagesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/quota":{"get":{"tags":["Email"],"summary":"and this codebase has 28 shadowed routes from exactly that.","operationId":"getApiEmailOutgoingQuota","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/send":{"post":{"tags":["Email"],"summary":"---- sending ----","operationId":"postApiEmailOutgoingSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/suppressions":{"get":{"tags":["Email"],"summary":"---- suppression ----","operationId":"getApiEmailOutgoingSuppressions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/suppressions/{id}":{"delete":{"tags":["Email"],"summary":"Delete suppression","operationId":"deleteApiEmailOutgoingSuppressionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/outgoing/webhook/resend":{"post":{"tags":["Email"],"summary":"future sending, so anyone able to forge it could cut off a competitor's mail.","operationId":"postApiEmailOutgoingWebhookResend","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/priority/high":{"get":{"tags":["Email"],"summary":"List high","operationId":"getApiEmailPriorityHigh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/priority/urgent":{"get":{"tags":["Email"],"summary":"List urgent","operationId":"getApiEmailPriorityUrgent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/records/auto-link":{"post":{"tags":["Email"],"summary":"Create auto link","operationId":"postApiEmailRecordsAutoLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/records/link":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailRecordsLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/records/link/{id}":{"delete":{"tags":["Email"],"summary":"Delete link","operationId":"deleteApiEmailRecordsLinkByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/records/{endpointId}/{recordId}/emails":{"get":{"tags":["Email"],"summary":"List emails","operationId":"getApiEmailRecordsByendpointidByrecordidEmails","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/rules":{"get":{"tags":["Email"],"summary":"========== Email Rules (Phase 3) ==========","operationId":"getApiEmailRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create rules","operationId":"postApiEmailRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/rules/order":{"put":{"tags":["Email"],"summary":"and this handler never runs. Enforced by bin/route-check.php.","operationId":"putApiEmailRulesOrder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/rules/{id}":{"get":{"tags":["Email"],"summary":"Get rule","operationId":"getApiEmailRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update rule","operationId":"putApiEmailRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete rule","operationId":"deleteApiEmailRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/rules/{id}/toggle":{"post":{"tags":["Email"],"summary":"Create toggle","operationId":"postApiEmailRulesByidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/scheduled":{"get":{"tags":["Email"],"summary":"Scheduled Sends","operationId":"getApiEmailScheduled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create scheduled","operationId":"postApiEmailScheduled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/scheduled/{id}":{"delete":{"tags":["Email"],"summary":"Delete scheduled","operationId":"deleteApiEmailScheduledByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update scheduled","operationId":"putApiEmailScheduledByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/search":{"get":{"tags":["Email"],"summary":"Email Search","operationId":"getApiEmailSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/search/advanced":{"post":{"tags":["Email"],"summary":"Create advanced","operationId":"postApiEmailSearchAdvanced","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/search/suggestions":{"get":{"tags":["Email"],"summary":"List suggestions","operationId":"getApiEmailSearchSuggestions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/senders":{"get":{"tags":["Email"],"summary":"============================================","operationId":"getApiEmailSenders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/senders/auto-enrich":{"post":{"tags":["Email"],"summary":"Create auto enrich","operationId":"postApiEmailSendersAutoEnrich","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/senders/{email}":{"get":{"tags":["Email"],"summary":"Get sender","operationId":"getApiEmailSendersByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update sender","operationId":"putApiEmailSendersByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete sender","operationId":"deleteApiEmailSendersByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sentiment/{sentiment}":{"get":{"tags":["Email"],"summary":"Get sentiment","operationId":"getApiEmailSentimentBysentiment","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"sentiment","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailSequences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List sequences","operationId":"getApiEmailSequences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/enrollments/{enrollmentId}":{"put":{"tags":["Email"],"summary":"Update enrollment","operationId":"putApiEmailSequencesEnrollmentsByenrollmentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"enrollmentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/steps/{stepId}":{"put":{"tags":["Email"],"summary":"Update step","operationId":"putApiEmailSequencesStepsBystepid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"stepId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete step","operationId":"deleteApiEmailSequencesStepsBystepid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"stepId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}":{"get":{"tags":["Email"],"summary":"Get sequence","operationId":"getApiEmailSequencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update sequence","operationId":"putApiEmailSequencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete sequence","operationId":"deleteApiEmailSequencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}/enroll":{"post":{"tags":["Email"],"summary":"Create enroll","operationId":"postApiEmailSequencesByidEnroll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}/enrollments":{"get":{"tags":["Email"],"summary":"List enrollments","operationId":"getApiEmailSequencesByidEnrollments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}/pause":{"post":{"tags":["Email"],"summary":"Create pause","operationId":"postApiEmailSequencesByidPause","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}/resume":{"post":{"tags":["Email"],"summary":"Create resume","operationId":"postApiEmailSequencesByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sequences/{id}/steps":{"post":{"tags":["Email"],"summary":"Create steps","operationId":"postApiEmailSequencesByidSteps","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/shared-inboxes":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailSharedInboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List shared inboxes","operationId":"getApiEmailSharedInboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/shared-inboxes/{id}":{"get":{"tags":["Email"],"summary":"Get shared inboxe","operationId":"getApiEmailSharedInboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update shared inboxe","operationId":"putApiEmailSharedInboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete shared inboxe","operationId":"deleteApiEmailSharedInboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/shared-inboxes/{id}/emails":{"get":{"tags":["Email"],"summary":"List emails","operationId":"getApiEmailSharedInboxesByidEmails","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/shared-inboxes/{id}/members":{"post":{"tags":["Email"],"summary":"Create members","operationId":"postApiEmailSharedInboxesByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete members","operationId":"deleteApiEmailSharedInboxesByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/shared-with-me":{"get":{"tags":["Email"],"summary":"cannot show these, which is the whole point).","operationId":"getApiEmailSharedWithMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/signatures":{"get":{"tags":["Email"],"summary":"Signatures","operationId":"getApiEmailSignatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create signatures","operationId":"postApiEmailSignatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/signatures/{id}":{"get":{"tags":["Email"],"summary":"Get signature","operationId":"getApiEmailSignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update signature","operationId":"putApiEmailSignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete signature","operationId":"deleteApiEmailSignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sla/breaches":{"get":{"tags":["Email"],"summary":"List breaches","operationId":"getApiEmailSlaBreaches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sla/rules":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailSlaRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List rules","operationId":"getApiEmailSlaRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sla/rules/{id}":{"get":{"tags":["Email"],"summary":"Get rule","operationId":"getApiEmailSlaRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update rule","operationId":"putApiEmailSlaRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete rule","operationId":"deleteApiEmailSlaRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sla/stats":{"get":{"tags":["Email"],"summary":"List stats","operationId":"getApiEmailSlaStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sla/status":{"get":{"tags":["Email"],"summary":"List status","operationId":"getApiEmailSlaStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/smart-replies/{id}/used":{"post":{"tags":["Email"],"summary":"Create used","operationId":"postApiEmailSmartRepliesByidUsed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/spoof-detections":{"get":{"tags":["Email"],"summary":"Spoof Detection","operationId":"getApiEmailSpoofDetections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create spoof detections","operationId":"postApiEmailSpoofDetections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/spoof-detections/{id}":{"get":{"tags":["Email"],"summary":"Get spoof detection","operationId":"getApiEmailSpoofDetectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/spoof-detections/{id}/confirm-safe":{"post":{"tags":["Email"],"summary":"Create confirm safe","operationId":"postApiEmailSpoofDetectionsByidConfirmSafe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/subscriptions":{"get":{"tags":["Email"],"summary":"Subscriptions","operationId":"getApiEmailSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/subscriptions/{id}":{"get":{"tags":["Email"],"summary":"Get subscription","operationId":"getApiEmailSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/subscriptions/{id}/block":{"post":{"tags":["Email"],"summary":"Create block","operationId":"postApiEmailSubscriptionsByidBlock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/subscriptions/{id}/resubscribe":{"post":{"tags":["Email"],"summary":"Create resubscribe","operationId":"postApiEmailSubscriptionsByidResubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/subscriptions/{id}/unsubscribe":{"post":{"tags":["Email"],"summary":"Create unsubscribe","operationId":"postApiEmailSubscriptionsByidUnsubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/sync-status":{"get":{"tags":["Email"],"summary":"Email Sync Status","operationId":"getApiEmailSyncStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/threads/{id}":{"get":{"tags":["Email"],"summary":"Get thread","operationId":"getApiEmailThreadsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todo-reminders/{id}":{"delete":{"tags":["Email"],"summary":"Delete todo reminder","operationId":"deleteApiEmailTodoRemindersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos":{"get":{"tags":["Email"],"summary":"========== Email Todos (Phase 5) ==========","operationId":"getApiEmailTodos","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create todos","operationId":"postApiEmailTodos","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/overdue":{"get":{"tags":["Email"],"summary":"List overdue","operationId":"getApiEmailTodosOverdue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/stats":{"get":{"tags":["Email"],"summary":"List stats","operationId":"getApiEmailTodosStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/today":{"get":{"tags":["Email"],"summary":"List today","operationId":"getApiEmailTodosToday","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/{id}":{"get":{"tags":["Email"],"summary":"Get todo","operationId":"getApiEmailTodosByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update todo","operationId":"putApiEmailTodosByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete todo","operationId":"deleteApiEmailTodosByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/{id}/complete":{"post":{"tags":["Email"],"summary":"Create complete","operationId":"postApiEmailTodosByidComplete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/{id}/reminder":{"post":{"tags":["Email"],"summary":"Todo: Set single reminder (singular route alias)","operationId":"postApiEmailTodosByidReminder","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/{id}/reminders":{"get":{"tags":["Email"],"summary":"Reminders","operationId":"getApiEmailTodosByidReminders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create reminders","operationId":"postApiEmailTodosByidReminders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/todos/{id}/reopen":{"post":{"tags":["Email"],"summary":"Create reopen","operationId":"postApiEmailTodosByidReopen","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/multi-record":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailTriggersMultiRecord","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List multi record","operationId":"getApiEmailTriggersMultiRecord","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/multi-record/{id}":{"get":{"tags":["Email"],"summary":"Get multi record","operationId":"getApiEmailTriggersMultiRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update multi record","operationId":"putApiEmailTriggersMultiRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete multi record","operationId":"deleteApiEmailTriggersMultiRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/multi-record/{id}/logs":{"get":{"tags":["Email"],"summary":"List logs","operationId":"getApiEmailTriggersMultiRecordByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/multi-record/{id}/test":{"post":{"tags":["Email"],"summary":"Create test","operationId":"postApiEmailTriggersMultiRecordByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/record":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailTriggersRecord","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List record","operationId":"getApiEmailTriggersRecord","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/record/{id}":{"get":{"tags":["Email"],"summary":"Get record","operationId":"getApiEmailTriggersRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update record","operationId":"putApiEmailTriggersRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete record","operationId":"deleteApiEmailTriggersRecordByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/record/{id}/logs":{"get":{"tags":["Email"],"summary":"List logs","operationId":"getApiEmailTriggersRecordByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/record/{id}/test":{"post":{"tags":["Email"],"summary":"Create test","operationId":"postApiEmailTriggersRecordByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/workflow":{"post":{"tags":["Email"],"summary":"============================================","operationId":"postApiEmailTriggersWorkflow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"List workflow","operationId":"getApiEmailTriggersWorkflow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/workflow/{id}":{"get":{"tags":["Email"],"summary":"Get workflow","operationId":"getApiEmailTriggersWorkflowByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update workflow","operationId":"putApiEmailTriggersWorkflowByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete workflow","operationId":"deleteApiEmailTriggersWorkflowByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/triggers/workflow/{id}/logs":{"get":{"tags":["Email"],"summary":"List logs","operationId":"getApiEmailTriggersWorkflowByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust":{"get":{"tags":["Email"],"summary":"Trust Lists","operationId":"getApiEmailTrust","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create trust","operationId":"postApiEmailTrust","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust-sources":{"get":{"tags":["Email"],"summary":"Trust Sources","operationId":"getApiEmailTrustSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create trust sources","operationId":"postApiEmailTrustSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust-sources/{id}":{"get":{"tags":["Email"],"summary":"Get trust source","operationId":"getApiEmailTrustSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update trust source","operationId":"putApiEmailTrustSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete trust source","operationId":"deleteApiEmailTrustSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust/check/allowed":{"get":{"tags":["Email"],"summary":"List allowed","operationId":"getApiEmailTrustCheckAllowed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust/check/blocked":{"get":{"tags":["Email"],"summary":"List blocked","operationId":"getApiEmailTrustCheckBlocked","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/trust/{id}":{"get":{"tags":["Email"],"summary":"Get trust","operationId":"getApiEmailTrustByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete trust","operationId":"deleteApiEmailTrustByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/undo-send/{id}":{"post":{"tags":["Email"],"summary":"Undo Send","operationId":"postApiEmailUndoSendByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unified-inbox":{"get":{"tags":["Email"],"summary":"List unified inbox","operationId":"getApiEmailUnifiedInbox","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unified-inbox/live":{"get":{"tags":["Email"],"summary":"sync worker fills, so it is empty for an account with sync off.","operationId":"getApiEmailUnifiedInboxLive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unified-inbox/unread-counts":{"get":{"tags":["Email"],"summary":"List unread counts","operationId":"getApiEmailUnifiedInboxUnreadCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unknown-senders":{"get":{"tags":["Email"],"summary":"Unknown Senders","operationId":"getApiEmailUnknownSenders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unknown-senders/pending":{"get":{"tags":["Email"],"summary":"List pending","operationId":"getApiEmailUnknownSendersPending","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unknown-senders/{id}":{"get":{"tags":["Email"],"summary":"Get unknown sender","operationId":"getApiEmailUnknownSendersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/unknown-senders/{id}/status":{"put":{"tags":["Email"],"summary":"Update status","operationId":"putApiEmailUnknownSendersByidStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/white-label/templates":{"get":{"tags":["Email"],"summary":"============================================","operationId":"getApiEmailWhiteLabelTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Email"],"summary":"Create templates","operationId":"postApiEmailWhiteLabelTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/white-label/templates/{id}":{"get":{"tags":["Email"],"summary":"Get template","operationId":"getApiEmailWhiteLabelTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Email"],"summary":"Update template","operationId":"putApiEmailWhiteLabelTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Email"],"summary":"Delete template","operationId":"deleteApiEmailWhiteLabelTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/email/white-label/templates/{id}/set-default":{"post":{"tags":["Email"],"summary":"Create set default","operationId":"postApiEmailWhiteLabelTemplatesByidSetDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embargoes":{"get":{"tags":["Embargoes"],"summary":"Global embargo management","operationId":"getApiEmbargoes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embargoes/{embargoId}":{"get":{"tags":["Embargoes"],"summary":"Get embargoe","operationId":"getApiEmbargoesByembargoid","security":[],"parameters":[{"name":"embargoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Embargoes"],"summary":"Update embargoe","operationId":"putApiEmbargoesByembargoid","security":[],"parameters":[{"name":"embargoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Embargoes"],"summary":"Delete embargoe","operationId":"deleteApiEmbargoesByembargoid","security":[],"parameters":[{"name":"embargoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embargoes/{embargoId}/cancel":{"post":{"tags":["Embargoes"],"summary":"Create cancel","operationId":"postApiEmbargoesByembargoidCancel","security":[],"parameters":[{"name":"embargoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embargoes/{embargoId}/lift":{"post":{"tags":["Embargoes"],"summary":"Create lift","operationId":"postApiEmbargoesByembargoidLift","security":[],"parameters":[{"name":"embargoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/batch":{"post":{"tags":["Embed"],"summary":"============================================================","operationId":"postApiEmbedBatch","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/dashboards":{"post":{"tags":["Embed"],"summary":"============================================================","operationId":"postApiEmbedDashboards","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Embed"],"summary":"List dashboards","operationId":"getApiEmbedDashboards","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/dashboards/{id}":{"get":{"tags":["Embed"],"summary":"Get dashboard","operationId":"getApiEmbedDashboardsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Embed"],"summary":"Update dashboard","operationId":"putApiEmbedDashboardsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Embed"],"summary":"Delete dashboard","operationId":"deleteApiEmbedDashboardsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/dashboards/{id}/embed-code":{"get":{"tags":["Embed"],"summary":"List embed code","operationId":"getApiEmbedDashboardsByidEmbedCode","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/loader.js":{"get":{"tags":["Embed"],"summary":"List loader.js","operationId":"getApiEmbedLoaderJs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/table/{token}":{"get":{"tags":["Embed"],"summary":"============================================","operationId":"getApiEmbedTableBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/table/{token}/data":{"get":{"tags":["Embed"],"summary":"List data","operationId":"getApiEmbedTableBytokenData","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/templates":{"post":{"tags":["Embed"],"summary":"============================================================","operationId":"postApiEmbedTemplates","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Embed"],"summary":"List templates","operationId":"getApiEmbedTemplates","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/templates/preview":{"post":{"tags":["Embed"],"summary":"Create preview","operationId":"postApiEmbedTemplatesPreview","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/templates/{id}":{"get":{"tags":["Embed"],"summary":"Get template","operationId":"getApiEmbedTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Embed"],"summary":"Update template","operationId":"putApiEmbedTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Embed"],"summary":"Delete template","operationId":"deleteApiEmbedTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/tokens/{tokenId}":{"delete":{"tags":["Embed"],"summary":"Delete token","operationId":"deleteApiEmbedTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}":{"get":{"tags":["Embed"],"summary":"Get widget","operationId":"getApiEmbedWidgetBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/data":{"get":{"tags":["Embed"],"summary":"List data","operationId":"getApiEmbedWidgetBytokenData","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/metrics":{"post":{"tags":["Embed"],"summary":"Create metrics","operationId":"postApiEmbedWidgetBytokenMetrics","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/refresh":{"post":{"tags":["Embed"],"summary":"Create refresh","operationId":"postApiEmbedWidgetBytokenRefresh","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/stream":{"get":{"tags":["Embed"],"summary":"List stream","operationId":"getApiEmbedWidgetBytokenStream","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/write":{"post":{"tags":["Embed"],"summary":"Create write","operationId":"postApiEmbedWidgetBytokenWrite","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"options":{"tags":["Embed"],"summary":"OPTIONS write","operationId":"optionsApiEmbedWidgetBytokenWrite","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widget/{token}/write-audit":{"get":{"tags":["Embed"],"summary":"List write audit","operationId":"getApiEmbedWidgetBytokenWriteAudit","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets":{"post":{"tags":["Embed"],"summary":"============================================================","operationId":"postApiEmbedWidgets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Embed"],"summary":"List widgets","operationId":"getApiEmbedWidgets","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{id}":{"get":{"tags":["Embed"],"summary":"Get widget","operationId":"getApiEmbedWidgetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Embed"],"summary":"Update widget","operationId":"putApiEmbedWidgetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Embed"],"summary":"Delete widget","operationId":"deleteApiEmbedWidgetsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{id}/analytics":{"get":{"tags":["Embed"],"summary":"Analytics (authenticated)","operationId":"getApiEmbedWidgetsByidAnalytics","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{id}/embed-code":{"get":{"tags":["Embed"],"summary":"Embed code (authenticated)","operationId":"getApiEmbedWidgetsByidEmbedCode","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{id}/preview":{"get":{"tags":["Embed"],"summary":"Preview (authenticated)","operationId":"getApiEmbedWidgetsByidPreview","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{widgetId}/tokens":{"post":{"tags":["Embed"],"summary":"============================================================","operationId":"postApiEmbedWidgetsBywidgetidTokens","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Embed"],"summary":"List tokens","operationId":"getApiEmbedWidgetsBywidgetidTokens","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{widgetId}/versions":{"get":{"tags":["Embed"],"summary":"============================================================","operationId":"getApiEmbedWidgetsBywidgetidVersions","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{widgetId}/versions/{version}":{"get":{"tags":["Embed"],"summary":"Get version","operationId":"getApiEmbedWidgetsBywidgetidVersionsByversion","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{widgetId}/versions/{version}/rollback":{"post":{"tags":["Embed"],"summary":"Create rollback","operationId":"postApiEmbedWidgetsBywidgetidVersionsByversionRollback","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embed/widgets/{widgetId}/write-audit":{"get":{"tags":["Embed"],"summary":"============================================================","operationId":"getApiEmbedWidgetsBywidgetidWriteAudit","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embeddable-tables":{"get":{"tags":["Embeddable tables"],"summary":"Before the /@id route so the bare path isn't captured by it.","operationId":"getApiEmbeddableTables","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/embeddable-tables/{id}":{"get":{"tags":["Embeddable tables"],"summary":"Get embeddable table","operationId":"getApiEmbeddableTablesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Embeddable tables"],"summary":"Update embeddable table","operationId":"putApiEmbeddableTablesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Embeddable tables"],"summary":"Delete embeddable table","operationId":"deleteApiEmbeddableTablesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/endpoints/{endpointId}":{"get":{"tags":["Encryption"],"summary":"Get endpoint encryption config","operationId":"getApiEncryptionEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/endpoints/{endpointId}/fields":{"post":{"tags":["Encryption"],"summary":"Mark endpoint field as encrypted","operationId":"postApiEncryptionEndpointsByendpointidFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/index":{"post":{"tags":["Encryption"],"summary":"Generate blind indexes for encrypted search","operationId":"postApiEncryptionIndex","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-exchange/public":{"get":{"tags":["Encryption"],"summary":"Get my public key","operationId":"getApiEncryptionKeyExchangePublic","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-exchange/public/{userId}":{"get":{"tags":["Encryption"],"summary":"Get another user's public key","operationId":"getApiEncryptionKeyExchangePublicByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-exchange/setup":{"post":{"tags":["Encryption"],"summary":"Register public key for key exchange","operationId":"postApiEncryptionKeyExchangeSetup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-groups":{"post":{"tags":["Encryption"],"summary":"Create key share group","operationId":"postApiEncryptionKeyGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Encryption"],"summary":"List my key share groups","operationId":"getApiEncryptionKeyGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-groups/{id}":{"get":{"tags":["Encryption"],"summary":"Get key share group details","operationId":"getApiEncryptionKeyGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Encryption"],"summary":"Delete key share group","operationId":"deleteApiEncryptionKeyGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-groups/{id}/keys":{"get":{"tags":["Encryption"],"summary":"Get keys shared with a group","operationId":"getApiEncryptionKeyGroupsByidKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-groups/{id}/members":{"post":{"tags":["Encryption"],"summary":"Add member to group","operationId":"postApiEncryptionKeyGroupsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-groups/{id}/members/{userId}":{"delete":{"tags":["Encryption"],"summary":"Remove member from group","operationId":"deleteApiEncryptionKeyGroupsByidMembersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/key-sharing/audit":{"get":{"tags":["Encryption"],"summary":"Get key sharing audit log","operationId":"getApiEncryptionKeySharingAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys":{"post":{"tags":["Encryption"],"summary":"Generate new encryption key (rate-limited via RateLimitMiddleware::SENSITIVE_ENDPOINTS)","operationId":"postApiEncryptionKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Encryption"],"summary":"List user's encryption keys","operationId":"getApiEncryptionKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/shared-with-me":{"get":{"tags":["Encryption"],"summary":"List keys shared with me","operationId":"getApiEncryptionKeysSharedWithMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/verify":{"post":{"tags":["Encryption"],"summary":"Verify encryption key (rate-limited via RateLimitMiddleware::SENSITIVE_ENDPOINTS)","operationId":"postApiEncryptionKeysVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}":{"delete":{"tags":["Encryption"],"summary":"Revoke encryption key (rate-limited via RateLimitMiddleware::SENSITIVE_ENDPOINTS)","operationId":"deleteApiEncryptionKeysBykeyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}/share":{"post":{"tags":["Encryption"],"summary":"Share encryption key with another user","operationId":"postApiEncryptionKeysBykeyidShare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}/share-with-group":{"post":{"tags":["Encryption"],"summary":"Share key with group","operationId":"postApiEncryptionKeysBykeyidShareWithGroup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}/share/{userId}":{"delete":{"tags":["Encryption"],"summary":"Revoke key share","operationId":"deleteApiEncryptionKeysBykeyidShareByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}/shares":{"get":{"tags":["Encryption"],"summary":"List who I've shared a key with","operationId":"getApiEncryptionKeysBykeyidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/encryption/keys/{keyId}/unwrap":{"post":{"tags":["Encryption"],"summary":"Get wrapped key for unwrapping client-side","operationId":"postApiEncryptionKeysBykeyidUnwrap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoint-access-tokens":{"get":{"tags":["Endpoint access tokens"],"summary":"List ALL the user's endpoint access tokens across endpoints (one query).","operationId":"getApiEndpointAccessTokens","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoint-access-tokens/{tokenId}":{"get":{"tags":["Endpoint access tokens"],"summary":"Get endpoint access token","operationId":"getApiEndpointAccessTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoint access tokens"],"summary":"Delete endpoint access token","operationId":"deleteApiEndpointAccessTokensBytokenid","security":[],"parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoint-fields":{"get":{"tags":["Endpoint fields"],"summary":"Fields for every owned endpoint, keyed by endpoint id, in one query.","operationId":"getApiEndpointFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoint-mesh":{"get":{"tags":["Endpoint mesh"],"summary":"List endpoint mesh","operationId":"getApiEndpointMesh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoint-relationships/{id}":{"put":{"tags":["Endpoint relationships"],"summary":"Update endpoint relationship","operationId":"putApiEndpointRelationshipsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoint relationships"],"summary":"Delete endpoint relationship","operationId":"deleteApiEndpointRelationshipsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints":{"get":{"tags":["Endpoints"],"summary":"List all custom endpoints","operationId":"getApiEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create new endpoint","operationId":"postApiEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/alias-modes":{"get":{"tags":["Endpoints"],"summary":"Route alias: test uses /api/endpoints/alias-modes","operationId":"getApiEndpointsAliasModes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/blueprints":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsBlueprints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List blueprints","operationId":"getApiEndpointsBlueprints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/blueprints/{id}":{"get":{"tags":["Endpoints"],"summary":"Get blueprint","operationId":"getApiEndpointsBlueprintsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete blueprint","operationId":"deleteApiEndpointsBlueprintsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/blueprints/{id}/apply":{"post":{"tags":["Endpoints"],"summary":"Create apply","operationId":"postApiEndpointsBlueprintsByidApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/blueprints/{id}/refine":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsBlueprintsByidRefine","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/by-customer/{tag}":{"get":{"tags":["Endpoints"],"summary":"Get by customer","operationId":"getApiEndpointsByCustomerBytag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/clone":{"post":{"tags":["Endpoints"],"summary":"----- Endpoint Utilities Routes -----","operationId":"postApiEndpointsClone","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/dependency-graph":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsDependencyGraph","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/field-alias-modes":{"get":{"tags":["Endpoints"],"summary":"List field alias modes","operationId":"getApiEndpointsFieldAliasModes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/fusion":{"post":{"tags":["Endpoints"],"summary":"Create fusion","operationId":"postApiEndpointsFusion","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/stats":{"get":{"tags":["Endpoints"],"summary":"Endpoints stats - alias for summary, must be before @id route","operationId":"getApiEndpointsStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/summary":{"get":{"tags":["Endpoints"],"summary":"Endpoints summary - must be before @id route to avoid matching 'summary' as an ID","operationId":"getApiEndpointsSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/access-policies":{"post":{"tags":["Endpoints"],"summary":"ABAC access policies","operationId":"postApiEndpointsByendpointidAccessPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List access policies","operationId":"getApiEndpointsByendpointidAccessPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/access-policies/evaluate":{"post":{"tags":["Endpoints"],"summary":"Create evaluate","operationId":"postApiEndpointsByendpointidAccessPoliciesEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/access-policies/history":{"get":{"tags":["Endpoints"],"summary":"List history","operationId":"getApiEndpointsByendpointidAccessPoliciesHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/aggregate":{"post":{"tags":["Endpoints"],"summary":"----- Aggregation Routes -----","operationId":"postApiEndpointsByendpointidAggregate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/anomalies":{"get":{"tags":["Endpoints"],"summary":"List anomalies","operationId":"getApiEndpointsByendpointidAiAnomalies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/anomalies/detect":{"post":{"tags":["Endpoints"],"summary":"--- Anomaly Detection (manual trigger) ---","operationId":"postApiEndpointsByendpointidAiAnomaliesDetect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/ask":{"post":{"tags":["Endpoints"],"summary":"--- Natural Language Query ---","operationId":"postApiEndpointsByendpointidAiAsk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/classification/stats":{"get":{"tags":["Endpoints"],"summary":"--- Classification Stats ---","operationId":"getApiEndpointsByendpointidAiClassificationStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/classify":{"post":{"tags":["Endpoints"],"summary":"Create classify","operationId":"postApiEndpointsByendpointidAiClassify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/config":{"get":{"tags":["Endpoints"],"summary":"List config","operationId":"getApiEndpointsByendpointidAiConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update config","operationId":"putApiEndpointsByendpointidAiConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/insights":{"get":{"tags":["Endpoints"],"summary":"--- Insights ---","operationId":"getApiEndpointsByendpointidAiInsights","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"--- Insights (manual creation + LLM generation) ---","operationId":"postApiEndpointsByendpointidAiInsights","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/insights/generate":{"post":{"tags":["Endpoints"],"summary":"Create generate","operationId":"postApiEndpointsByendpointidAiInsightsGenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/quality":{"get":{"tags":["Endpoints"],"summary":"--- Quality & Anomalies ---","operationId":"getApiEndpointsByendpointidAiQuality","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/stats":{"get":{"tags":["Endpoints"],"summary":"--- Statistics ---","operationId":"getApiEndpointsByendpointidAiStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/stats/compute":{"post":{"tags":["Endpoints"],"summary":"Create compute","operationId":"postApiEndpointsByendpointidAiStatsCompute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ai/training":{"post":{"tags":["Endpoints"],"summary":"--- Training & Classification ---","operationId":"postApiEndpointsByendpointidAiTraining","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/alerts":{"get":{"tags":["Endpoints"],"summary":"List alerts","operationId":"getApiEndpointsByendpointidAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/alerts/{alertId}/acknowledge":{"post":{"tags":["Endpoints"],"summary":"Create acknowledge","operationId":"postApiEndpointsByendpointidAlertsByalertidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alertId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/annotations/summary":{"get":{"tags":["Endpoints"],"summary":"Get annotation summary for an endpoint","operationId":"getApiEndpointsByendpointidAnnotationsSummary","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/approval-workflows":{"post":{"tags":["Endpoints"],"summary":"--- Workflow CRUD ---","operationId":"postApiEndpointsByendpointidApprovalWorkflows","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List approval workflows","operationId":"getApiEndpointsByendpointidApprovalWorkflows","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/attachments":{"post":{"tags":["Endpoints"],"summary":"----- File Attachments Routes -----","operationId":"postApiEndpointsByendpointidAttachments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/automations":{"post":{"tags":["Endpoints"],"summary":"--- Rule CRUD ---","operationId":"postApiEndpointsByendpointidAutomations","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List automations","operationId":"getApiEndpointsByendpointidAutomations","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/breaking-changes":{"get":{"tags":["Endpoints"],"summary":"List breaking changes","operationId":"getApiEndpointsByendpointidBreakingChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/cache/disable":{"post":{"tags":["Endpoints"],"summary":"Create disable","operationId":"postApiEndpointsByendpointidCacheDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/cache/enable":{"post":{"tags":["Endpoints"],"summary":"----- Query Cache Routes -----","operationId":"postApiEndpointsByendpointidCacheEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/cache/invalidate":{"post":{"tags":["Endpoints"],"summary":"Create invalidate","operationId":"postApiEndpointsByendpointidCacheInvalidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/cache/stats":{"get":{"tags":["Endpoints"],"summary":"List stats","operationId":"getApiEndpointsByendpointidCacheStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/calculated-fields":{"get":{"tags":["Endpoints"],"summary":"List calculated fields for an endpoint","operationId":"getApiEndpointsByendpointidCalculatedFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create a calculated field for an endpoint","operationId":"postApiEndpointsByendpointidCalculatedFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/changelog":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByendpointidChangelog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/changelog/versions":{"get":{"tags":["Endpoints"],"summary":"List versions","operationId":"getApiEndpointsByendpointidChangelogVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/changelog/versions/compare":{"get":{"tags":["Endpoints"],"summary":"because these are different paths rather than the same one twice.","operationId":"getApiEndpointsByendpointidChangelogVersionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/changelog/{changeId}":{"get":{"tags":["Endpoints"],"summary":"Get changelog","operationId":"getApiEndpointsByendpointidChangelogBychangeid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"changeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/chaos":{"post":{"tags":["Endpoints"],"summary":"Create chaos config","operationId":"postApiEndpointsByendpointidChaos","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List chaos configs for an endpoint","operationId":"getApiEndpointsByendpointidChaos","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/chaos/check":{"post":{"tags":["Endpoints"],"summary":"Check if chaos would apply (dry run)","operationId":"postApiEndpointsByendpointidChaosCheck","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/chaos/{configId}":{"get":{"tags":["Endpoints"],"summary":"Get a specific chaos config","operationId":"getApiEndpointsByendpointidChaosByconfigid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"configId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update a chaos config","operationId":"putApiEndpointsByendpointidChaosByconfigid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"configId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete a chaos config","operationId":"deleteApiEndpointsByendpointidChaosByconfigid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"configId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/children":{"get":{"tags":["Endpoints"],"summary":"Endpoint inheritance management","operationId":"getApiEndpointsByendpointidChildren","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create children","operationId":"postApiEndpointsByendpointidChildren","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/consumers":{"get":{"tags":["Endpoints"],"summary":"Contract Guarantees & Schema Version Pinning Routes","operationId":"getApiEndpointsByendpointidConsumers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contract-status":{"get":{"tags":["Endpoints"],"summary":"List contract status","operationId":"getApiEndpointsByendpointidContractStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts":{"post":{"tags":["Endpoints"],"summary":"Subscribe to schema changes","operationId":"postApiEndpointsByendpointidContracts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Unsubscribe from schema changes","operationId":"deleteApiEndpointsByendpointidContracts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/acknowledge":{"post":{"tags":["Endpoints"],"summary":"Acknowledge a schema version","operationId":"postApiEndpointsByendpointidContractsAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/check":{"post":{"tags":["Endpoints"],"summary":"Check compatibility of proposed changes","operationId":"postApiEndpointsByendpointidContractsCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/force-acknowledge":{"post":{"tags":["Endpoints"],"summary":"Create force acknowledge","operationId":"postApiEndpointsByendpointidContractsForceAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/matrix":{"get":{"tags":["Endpoints"],"summary":"Get compatibility matrix","operationId":"getApiEndpointsByendpointidContractsMatrix","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/notify":{"post":{"tags":["Endpoints"],"summary":"Notify subscribers of changes","operationId":"postApiEndpointsByendpointidContractsNotify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/settings":{"put":{"tags":["Endpoints"],"summary":"Owner controls: toggle consumer contracts, force-acknowledge, remove subscriber","operationId":"putApiEndpointsByendpointidContractsSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/subscribers":{"get":{"tags":["Endpoints"],"summary":"List subscribers (endpoint owner only)","operationId":"getApiEndpointsByendpointidContractsSubscribers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/contracts/subscribers/{subscriberId}":{"delete":{"tags":["Endpoints"],"summary":"Delete subscriber","operationId":"deleteApiEndpointsByendpointidContractsSubscribersBysubscriberid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subscriberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup-rules":{"post":{"tags":["Endpoints"],"summary":"Rule CRUD (endpoint-scoped)","operationId":"postApiEndpointsByendpointidDedupRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List dedup rules","operationId":"getApiEndpointsByendpointidDedupRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup/auto-merge":{"post":{"tags":["Endpoints"],"summary":"Create auto merge","operationId":"postApiEndpointsByendpointidDedupAutoMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup/dismiss":{"post":{"tags":["Endpoints"],"summary":"Create dismiss","operationId":"postApiEndpointsByendpointidDedupDismiss","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup/merge":{"post":{"tags":["Endpoints"],"summary":"Create merge","operationId":"postApiEndpointsByendpointidDedupMerge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup/pairs":{"get":{"tags":["Endpoints"],"summary":"List pairs","operationId":"getApiEndpointsByendpointidDedupPairs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/dedup/scan":{"post":{"tags":["Endpoints"],"summary":"Scan & pair management (endpoint-scoped)","operationId":"postApiEndpointsByendpointidDedupScan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/distinct/{field}":{"get":{"tags":["Endpoints"],"summary":"Get distinct","operationId":"getApiEndpointsByendpointidDistinctByfield","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"field","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/embeddings/config/{configId}":{"delete":{"tags":["Endpoints"],"summary":"Delete config","operationId":"deleteApiEndpointsByendpointidEmbeddingsConfigByconfigid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"configId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/field-permissions":{"get":{"tags":["Endpoints"],"summary":"List field permissions","operationId":"getApiEndpointsByendpointidFieldPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/fields/{fieldId}/override":{"put":{"tags":["Endpoints"],"summary":"Update override","operationId":"putApiEndpointsByendpointidFieldsByfieldidOverride","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/fission":{"post":{"tags":["Endpoints"],"summary":"Create fission","operationId":"postApiEndpointsByendpointidFission","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/freshness":{"put":{"tags":["Endpoints"],"summary":"Set/update freshness config","operationId":"putApiEndpointsByendpointidFreshness","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"Get freshness config","operationId":"getApiEndpointsByendpointidFreshness","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete freshness config","operationId":"deleteApiEndpointsByendpointidFreshness","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/freshness/check":{"get":{"tags":["Endpoints"],"summary":"Check freshness status","operationId":"getApiEndpointsByendpointidFreshnessCheck","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/freshness/last-update":{"get":{"tags":["Endpoints"],"summary":"Get last update time","operationId":"getApiEndpointsByendpointidFreshnessLastUpdate","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/generate":{"post":{"tags":["Endpoints"],"summary":"Generate synthetic data for an endpoint","operationId":"postApiEndpointsByendpointidGenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/health":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByendpointidHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/health/history":{"get":{"tags":["Endpoints"],"summary":"List history","operationId":"getApiEndpointsByendpointidHealthHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/i18n":{"put":{"tags":["Endpoints"],"summary":"============================================","operationId":"putApiEndpointsByendpointidI18n","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List i18n","operationId":"getApiEndpointsByendpointidI18n","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/i18n/missing":{"get":{"tags":["Endpoints"],"summary":"List missing","operationId":"getApiEndpointsByendpointidI18nMissing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/inheritance":{"get":{"tags":["Endpoints"],"summary":"List inheritance","operationId":"getApiEndpointsByendpointidInheritance","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/masking-profiles":{"post":{"tags":["Endpoints"],"summary":"Profile CRUD (endpoint-scoped create/list)","operationId":"postApiEndpointsByendpointidMaskingProfiles","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List masking profiles","operationId":"getApiEndpointsByendpointidMaskingProfiles","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/ml/models":{"post":{"tags":["Endpoints"],"summary":"Create ML model for endpoint","operationId":"postApiEndpointsByendpointidMlModels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List ML models for endpoint","operationId":"getApiEndpointsByendpointidMlModels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/monetization/catalog":{"post":{"tags":["Endpoints"],"summary":"--- Catalog Management (auth required) ---","operationId":"postApiEndpointsByendpointidMonetizationCatalog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/monetization/plans":{"post":{"tags":["Endpoints"],"summary":"--- Plans (auth required) ---","operationId":"postApiEndpointsByendpointidMonetizationPlans","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List plans","operationId":"getApiEndpointsByendpointidMonetizationPlans","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/not-found-message":{"put":{"tags":["Endpoints"],"summary":"Update not found message","operationId":"putApiEndpointsByendpointidNotFoundMessage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/notarizations":{"get":{"tags":["Endpoints"],"summary":"List notarizations","operationId":"getApiEndpointsByendpointidNotarizations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/notarize":{"post":{"tags":["Endpoints"],"summary":"--- Notarize records for an endpoint ---","operationId":"postApiEndpointsByendpointidNotarize","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/notarize/bulk":{"post":{"tags":["Endpoints"],"summary":"Create bulk","operationId":"postApiEndpointsByendpointidNotarizeBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/performance":{"get":{"tags":["Endpoints"],"summary":"List recommendations for endpoint","operationId":"getApiEndpointsByendpointidPerformance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/performance/analyze":{"post":{"tags":["Endpoints"],"summary":"Analyze endpoint and generate recommendations","operationId":"postApiEndpointsByendpointidPerformanceAnalyze","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/pipelines":{"post":{"tags":["Endpoints"],"summary":"--- Endpoint-scoped routes ---","operationId":"postApiEndpointsByendpointidPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List pipelines","operationId":"getApiEndpointsByendpointidPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/projections":{"post":{"tags":["Endpoints"],"summary":"Configure a new projection","operationId":"postApiEndpointsByendpointidProjections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List all projections for an endpoint","operationId":"getApiEndpointsByendpointidProjections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/projections/{type}":{"get":{"tags":["Endpoints"],"summary":"Get a specific projection config","operationId":"getApiEndpointsByendpointidProjectionsBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update a projection config","operationId":"putApiEndpointsByendpointidProjectionsBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete a projection","operationId":"deleteApiEndpointsByendpointidProjectionsBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/propagate-field":{"post":{"tags":["Endpoints"],"summary":"Create propagate field","operationId":"postApiEndpointsByendpointidPropagateField","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/provenance-summary":{"get":{"tags":["Endpoints"],"summary":"List provenance summary","operationId":"getApiEndpointsByendpointidProvenanceSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/quality-score/batch":{"post":{"tags":["Endpoints"],"summary":"Create batch","operationId":"postApiEndpointsByendpointidQualityScoreBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/quality-score/summary":{"get":{"tags":["Endpoints"],"summary":"List summary","operationId":"getApiEndpointsByendpointidQualityScoreSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/quality-summary":{"get":{"tags":["Endpoints"],"summary":"Endpoint quality summary","operationId":"getApiEndpointsByendpointidQualitySummary","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/rate-limits":{"get":{"tags":["Endpoints"],"summary":"Per-endpoint rate limits","operationId":"getApiEndpointsByendpointidRateLimits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update rate limits","operationId":"putApiEndpointsByendpointidRateLimits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete rate limits","operationId":"deleteApiEndpointsByendpointidRateLimits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/readonly":{"put":{"tags":["Endpoints"],"summary":"Update readonly","operationId":"putApiEndpointsByendpointidReadonly","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/record-views":{"post":{"tags":["Endpoints"],"summary":"Create record views","operationId":"postApiEndpointsByendpointidRecordViews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List record views","operationId":"getApiEndpointsByendpointidRecordViews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/record-views/default":{"get":{"tags":["Endpoints"],"summary":"Default view must come BEFORE the wildcard @endpointId/views pattern","operationId":"getApiEndpointsByendpointidRecordViewsDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/activity":{"get":{"tags":["Endpoints"],"summary":"List activity","operationId":"getApiEndpointsByendpointidRecordsByrecordidActivity","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/calculated-fields":{"get":{"tags":["Endpoints"],"summary":"Evaluate all calculated fields for a specific record","operationId":"getApiEndpointsByendpointidRecordsByrecordidCalculatedFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/files":{"get":{"tags":["Endpoints"],"summary":"List files","operationId":"getApiEndpointsByendpointidRecordsByrecordidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/graph":{"get":{"tags":["Endpoints"],"summary":"List graph","operationId":"getApiEndpointsByendpointidRecordsByrecordidGraph","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/graph/expand":{"get":{"tags":["Endpoints"],"summary":"List expand","operationId":"getApiEndpointsByendpointidRecordsByrecordidGraphExpand","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/graph/search":{"get":{"tags":["Endpoints"],"summary":"List search","operationId":"getApiEndpointsByendpointidRecordsByrecordidGraphSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/graph/summary":{"get":{"tags":["Endpoints"],"summary":"List summary","operationId":"getApiEndpointsByendpointidRecordsByrecordidGraphSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/subscribe":{"post":{"tags":["Endpoints"],"summary":"Subscribe to a specific record","operationId":"postApiEndpointsByendpointidRecordsByrecordidSubscribe","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/records/{recordId}/workflow-history":{"get":{"tags":["Endpoints"],"summary":"List workflow history","operationId":"getApiEndpointsByendpointidRecordsByrecordidWorkflowHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/recurring-records":{"post":{"tags":["Endpoints"],"summary":"Endpoint-scoped routes","operationId":"postApiEndpointsByendpointidRecurringRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List recurring records","operationId":"getApiEndpointsByendpointidRecurringRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/relationship-map":{"get":{"tags":["Endpoints"],"summary":"List relationship map","operationId":"getApiEndpointsByendpointidRelationshipMap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/rls-policies":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByendpointidRlsPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create rls policies","operationId":"postApiEndpointsByendpointidRlsPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/scheduled-mutations":{"get":{"tags":["Endpoints"],"summary":"Endpoint-scoped list","operationId":"getApiEndpointsByendpointidScheduledMutations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/diff":{"post":{"tags":["Endpoints"],"summary":"Create diff","operationId":"postApiEndpointsByendpointidSchemaDiff","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/impact":{"post":{"tags":["Endpoints"],"summary":"Create impact","operationId":"postApiEndpointsByendpointidSchemaImpact","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/migration-plan":{"post":{"tags":["Endpoints"],"summary":"Create migration plan","operationId":"postApiEndpointsByendpointidSchemaMigrationPlan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions":{"post":{"tags":["Endpoints"],"summary":"POST /api/endpoints/{endpointId}/schema/transitions \u2014 Initiate a new transition","operationId":"postApiEndpointsByendpointidSchemaTransitions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"GET /api/endpoints/{endpointId}/schema/transitions \u2014 List all transitions","operationId":"getApiEndpointsByendpointidSchemaTransitions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}":{"get":{"tags":["Endpoints"],"summary":"GET /api/endpoints/{endpointId}/schema/transitions/{transitionId} \u2014 Get transition details","operationId":"getApiEndpointsByendpointidSchemaTransitionsBytransitionid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}/abort":{"post":{"tags":["Endpoints"],"summary":"POST /api/endpoints/{endpointId}/schema/transitions/{transitionId}/abort \u2014 Abort transition","operationId":"postApiEndpointsByendpointidSchemaTransitionsBytransitionidAbort","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}/activate":{"post":{"tags":["Endpoints"],"summary":"POST /api/endpoints/{endpointId}/schema/transitions/{transitionId}/activate \u2014 Activate (apply new columns)","operationId":"postApiEndpointsByendpointidSchemaTransitionsBytransitionidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}/backfill":{"post":{"tags":["Endpoints"],"summary":"POST /api/endpoints/{endpointId}/schema/transitions/{transitionId}/backfill \u2014 Trigger backfill batch","operationId":"postApiEndpointsByendpointidSchemaTransitionsBytransitionidBackfill","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}/readiness":{"get":{"tags":["Endpoints"],"summary":"GET /api/endpoints/{endpointId}/schema/transitions/{transitionId}/readiness \u2014 Consumer readiness report","operationId":"getApiEndpointsByendpointidSchemaTransitionsBytransitionidReadiness","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/schema/transitions/{transitionId}/retire":{"post":{"tags":["Endpoints"],"summary":"POST /api/endpoints/{endpointId}/schema/transitions/{transitionId}/retire \u2014 Retire old schema","operationId":"postApiEndpointsByendpointidSchemaTransitionsBytransitionidRetire","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transitionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/sla":{"put":{"tags":["Endpoints"],"summary":"Update sla","operationId":"putApiEndpointsByendpointidSla","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List sla","operationId":"getApiEndpointsByendpointidSla","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete sla","operationId":"deleteApiEndpointsByendpointidSla","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/snapshots":{"post":{"tags":["Endpoints"],"summary":"Create a snapshot","operationId":"postApiEndpointsByendpointidSnapshots","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List snapshots","operationId":"getApiEndpointsByendpointidSnapshots","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/snapshots/{snapshotId}":{"delete":{"tags":["Endpoints"],"summary":"Delete a snapshot","operationId":"deleteApiEndpointsByendpointidSnapshotsBysnapshotid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"snapshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/snapshots/{snapshotId}/diff":{"get":{"tags":["Endpoints"],"summary":"Diff a snapshot against current data","operationId":"getApiEndpointsByendpointidSnapshotsBysnapshotidDiff","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"snapshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/snapshots/{snapshotId}/restore":{"post":{"tags":["Endpoints"],"summary":"Restore a snapshot","operationId":"postApiEndpointsByendpointidSnapshotsBysnapshotidRestore","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"snapshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/statistics":{"get":{"tags":["Endpoints"],"summary":"List statistics","operationId":"getApiEndpointsByendpointidStatistics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/time-series":{"post":{"tags":["Endpoints"],"summary":"Create time series","operationId":"postApiEndpointsByendpointidTimeSeries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/time-travel/records/{recordId}":{"get":{"tags":["Endpoints"],"summary":"Get record","operationId":"getApiEndpointsByendpointidTimeTravelRecordsByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/time-travel/records/{recordId}/history":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsByendpointidTimeTravelRecordsByrecordidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/trash-log":{"get":{"tags":["Endpoints"],"summary":"Trash restore log","operationId":"getApiEndpointsByendpointidTrashLog","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/trash-settings":{"get":{"tags":["Endpoints"],"summary":"Trash settings (per-endpoint)","operationId":"getApiEndpointsByendpointidTrashSettings","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update trash settings","operationId":"putApiEndpointsByendpointidTrashSettings","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/validation-rules":{"get":{"tags":["Endpoints"],"summary":"List validation rules","operationId":"getApiEndpointsByendpointidValidationRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/versions/{versionNumber}/impact":{"get":{"tags":["Endpoints"],"summary":"List impact","operationId":"getApiEndpointsByendpointidVersionsByversionnumberImpact","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/view/{type}":{"get":{"tags":["Endpoints"],"summary":"Query data through a projection view","operationId":"getApiEndpointsByendpointidViewBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointId}/views":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByendpointidViews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create views","operationId":"postApiEndpointsByendpointidViews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{endpointName}/change-requests":{"post":{"tags":["Endpoints"],"summary":"Create a change request on an endpoint","operationId":"postApiEndpointsByendpointnameChangeRequests","security":[],"parameters":[{"name":"endpointName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}":{"get":{"tags":["Endpoints"],"summary":"Get single endpoint definition","operationId":"getApiEndpointsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update endpoint","operationId":"putApiEndpointsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete endpoint (always allowed \u2014 users should be able to clean up)","operationId":"deleteApiEndpointsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/access-tokens":{"post":{"tags":["Endpoints"],"summary":"============================================","operationId":"postApiEndpointsByidAccessTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List access tokens","operationId":"getApiEndpointsByidAccessTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/alias-mode":{"put":{"tags":["Endpoints"],"summary":"Set endpoint alias mode","operationId":"putApiEndpointsByidAliasMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"Get endpoint alias mode","operationId":"getApiEndpointsByidAliasMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/analytics":{"get":{"tags":["Endpoints"],"summary":"List analytics","operationId":"getApiEndpointsByidAnalytics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/analytics/summary":{"get":{"tags":["Endpoints"],"summary":"List summary","operationId":"getApiEndpointsByidAnalyticsSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/branches":{"get":{"tags":["Endpoints"],"summary":"--- Endpoint-scoped branch shortcuts ---","operationId":"getApiEndpointsByidBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create branches","operationId":"postApiEndpointsByidBranches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/capability-tokens":{"post":{"tags":["Endpoints"],"summary":"Create token for an endpoint","operationId":"postApiEndpointsByidCapabilityTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List tokens for an endpoint","operationId":"getApiEndpointsByidCapabilityTokens","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/count":{"get":{"tags":["Endpoints"],"summary":"Get estimated row count","operationId":"getApiEndpointsByidCount","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/cursor-pagination":{"post":{"tags":["Endpoints"],"summary":"Enable cursor-based pagination","operationId":"postApiEndpointsByidCursorPagination","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/customer-tag":{"put":{"tags":["Endpoints"],"summary":"Customer tag management","operationId":"putApiEndpointsByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List customer tag","operationId":"getApiEndpointsByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete customer tag","operationId":"deleteApiEndpointsByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/data-alerts":{"post":{"tags":["Endpoints"],"summary":"Alert rules scoped to endpoint (using /data-alerts to avoid conflict with health monitoring /alerts)","operationId":"postApiEndpointsByidDataAlerts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List data alerts","operationId":"getApiEndpointsByidDataAlerts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/dependencies":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsByidDependencies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/dependencies/field/{fieldName}":{"get":{"tags":["Endpoints"],"summary":"Get field","operationId":"getApiEndpointsByidDependenciesFieldByfieldname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/discover-relationships":{"post":{"tags":["Endpoints"],"summary":"Create discover relationships","operationId":"postApiEndpointsByidDiscoverRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embargoes":{"post":{"tags":["Endpoints"],"summary":"Embargoes scoped to endpoint","operationId":"postApiEndpointsByidEmbargoes","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List embargoes","operationId":"getApiEndpointsByidEmbargoes","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embargoes/check":{"get":{"tags":["Endpoints"],"summary":"List check","operationId":"getApiEndpointsByidEmbargoesCheck","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embeddable-tables":{"post":{"tags":["Endpoints"],"summary":"============================================","operationId":"postApiEndpointsByidEmbeddableTables","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List embeddable tables","operationId":"getApiEndpointsByidEmbeddableTables","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embeddings/config":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidEmbeddingsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List config","operationId":"getApiEndpointsByidEmbeddingsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embeddings/generate":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidEmbeddingsGenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/embeddings/search":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidEmbeddingsSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/ephemeral":{"put":{"tags":["Endpoints"],"summary":"Endpoint-scoped ephemeral configuration","operationId":"putApiEndpointsByidEphemeral","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List ephemeral","operationId":"getApiEndpointsByidEphemeral","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete ephemeral","operationId":"deleteApiEndpointsByidEphemeral","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/ephemeral/extend":{"post":{"tags":["Endpoints"],"summary":"Create extend","operationId":"postApiEndpointsByidEphemeralExtend","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/ephemeral/share-link":{"post":{"tags":["Endpoints"],"summary":"Create share link","operationId":"postApiEndpointsByidEphemeralShareLink","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/feed":{"post":{"tags":["Endpoints"],"summary":"Feed configuration routes \u2014 always authenticated","operationId":"postApiEndpointsByidFeed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/feed/config":{"get":{"tags":["Endpoints"],"summary":"List config","operationId":"getApiEndpointsByidFeedConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/field-changes":{"get":{"tags":["Endpoints"],"summary":"Recent changes across an endpoint (by endpoint UUID)","operationId":"getApiEndpointsByidFieldChanges","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/field-permission-policies":{"post":{"tags":["Endpoints"],"summary":"CRUD scoped under endpoint","operationId":"postApiEndpointsByidFieldPermissionPolicies","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List field permission policies","operationId":"getApiEndpointsByidFieldPermissionPolicies","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/field-permission-policies/effective":{"get":{"tags":["Endpoints"],"summary":"Effective permissions for the current user on an endpoint","operationId":"getApiEndpointsByidFieldPermissionPoliciesEffective","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/forecast":{"post":{"tags":["Endpoints"],"summary":"Create forecast","operationId":"postApiEndpointsByidForecast","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List forecast","operationId":"getApiEndpointsByidForecast","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/forecast/growth":{"get":{"tags":["Endpoints"],"summary":"List growth","operationId":"getApiEndpointsByidForecastGrowth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/forecast/history":{"get":{"tags":["Endpoints"],"summary":"List history","operationId":"getApiEndpointsByidForecastHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/fork":{"post":{"tags":["Endpoints"],"summary":"============================================","operationId":"postApiEndpointsByidFork","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/geo-blocking":{"get":{"tags":["Endpoints"],"summary":"Get endpoint geo blocking settings","operationId":"getApiEndpointsByidGeoBlocking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Set endpoint geo blocking settings","operationId":"putApiEndpointsByidGeoBlocking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/index-suggestions":{"post":{"tags":["Endpoints"],"summary":"Create index suggestions","operationId":"postApiEndpointsByidIndexSuggestions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/metadata":{"patch":{"tags":["Endpoints"],"summary":"against MetadataValidator (max 50 keys, 8 KB total, PII-key red-flag).","operationId":"patchApiEndpointsByidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/optimize":{"post":{"tags":["Endpoints"],"summary":"Optimize endpoint table","operationId":"postApiEndpointsByidOptimize","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/preview":{"post":{"tags":["Endpoints"],"summary":"Preview schema changes without applying","operationId":"postApiEndpointsByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/quarantine":{"get":{"tags":["Endpoints"],"summary":"Quarantine records scoped to endpoint","operationId":"getApiEndpointsByidQuarantine","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/quarantine/evaluate":{"post":{"tags":["Endpoints"],"summary":"Evaluate data against quarantine rules (dry run)","operationId":"postApiEndpointsByidQuarantineEvaluate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/quarantine/rules":{"post":{"tags":["Endpoints"],"summary":"Quarantine rules scoped to endpoint","operationId":"postApiEndpointsByidQuarantineRules","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List rules","operationId":"getApiEndpointsByidQuarantineRules","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/query-budget":{"put":{"tags":["Endpoints"],"summary":"Update query budget","operationId":"putApiEndpointsByidQueryBudget","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List query budget","operationId":"getApiEndpointsByidQueryBudget","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/query-stats":{"get":{"tags":["Endpoints"],"summary":"Endpoint-scoped routes","operationId":"getApiEndpointsByidQueryStats","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/query-suggestions":{"get":{"tags":["Endpoints"],"summary":"List query suggestions","operationId":"getApiEndpointsByidQuerySuggestions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/records/{recordId}/provenance-signatures":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByidRecordsByrecordidProvenanceSignatures","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/records/{recordId}/provenance-signatures/sign":{"post":{"tags":["Endpoints"],"summary":"Create sign","operationId":"postApiEndpointsByidRecordsByrecordidProvenanceSignaturesSign","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/relationships":{"get":{"tags":["Endpoints"],"summary":"List relationships","operationId":"getApiEndpointsByidRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create relationships","operationId":"postApiEndpointsByidRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/replication":{"get":{"tags":["Endpoints"],"summary":"Get replication config for an endpoint","operationId":"getApiEndpointsByidReplication","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update replication config for an endpoint","operationId":"putApiEndpointsByidReplication","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/replication/conflicts":{"get":{"tags":["Endpoints"],"summary":"List conflicts for an endpoint","operationId":"getApiEndpointsByidReplicationConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/replication/conflicts/bulk-resolve":{"post":{"tags":["Endpoints"],"summary":"Bulk resolve conflicts for an endpoint","operationId":"postApiEndpointsByidReplicationConflictsBulkResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/replication/status":{"get":{"tags":["Endpoints"],"summary":"Get replication status for an endpoint","operationId":"getApiEndpointsByidReplicationStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/replication/sync":{"post":{"tags":["Endpoints"],"summary":"Force sync an endpoint","operationId":"postApiEndpointsByidReplicationSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/resonance-rules":{"post":{"tags":["Endpoints"],"summary":"Per-endpoint rule management","operationId":"postApiEndpointsByidResonanceRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List resonance rules","operationId":"getApiEndpointsByidResonanceRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/response-envelope":{"post":{"tags":["Endpoints"],"summary":"--- Custom Response Envelopes ---","operationId":"postApiEndpointsByidResponseEnvelope","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List response envelope","operationId":"getApiEndpointsByidResponseEnvelope","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete response envelope","operationId":"deleteApiEndpointsByidResponseEnvelope","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sandboxes":{"post":{"tags":["Endpoints"],"summary":"Create sandbox from an endpoint","operationId":"postApiEndpointsByidSandboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/scalability":{"post":{"tags":["Endpoints"],"summary":"Enable scalability optimization for an endpoint","operationId":"postApiEndpointsByidScalability","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"Get scalability configuration","operationId":"getApiEndpointsByidScalability","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/scalability/maintain":{"post":{"tags":["Endpoints"],"summary":"Trigger scalability maintenance","operationId":"postApiEndpointsByidScalabilityMaintain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/schema/schedule":{"post":{"tags":["Endpoints"],"summary":"Create schedule","operationId":"postApiEndpointsByidSchemaSchedule","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List schedule","operationId":"getApiEndpointsByidSchemaSchedule","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/schema/schedule/{changeId}":{"delete":{"tags":["Endpoints"],"summary":"Delete schedule","operationId":"deleteApiEndpointsByidSchemaScheduleBychangeid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"changeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sdk":{"post":{"tags":["Endpoints"],"summary":"Generate SDK","operationId":"postApiEndpointsByidSdk","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"Download SDK as file","operationId":"getApiEndpointsByidSdk","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sdk/history":{"get":{"tags":["Endpoints"],"summary":"Generation history (must be before the GET /api/endpoints/@id/sdk route)","operationId":"getApiEndpointsByidSdkHistory","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/searchable-fields":{"get":{"tags":["Endpoints"],"summary":"v1.312.92+. Read-permission for GET; owner / org-admin for PUT/DELETE.","operationId":"getApiEndpointsByidSearchableFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update searchable fields","operationId":"putApiEndpointsByidSearchableFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete searchable fields","operationId":"deleteApiEndpointsByidSearchableFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/self-ref-fields":{"get":{"tags":["Endpoints"],"summary":"List self ref fields","operationId":"getApiEndpointsByidSelfRefFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sequence":{"get":{"tags":["Endpoints"],"summary":"============================================","operationId":"getApiEndpointsByidSequence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create sequence","operationId":"postApiEndpointsByidSequence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete sequence","operationId":"deleteApiEndpointsByidSequence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sequence/next":{"post":{"tags":["Endpoints"],"summary":"(deferred / issue-time numbering). Owner-scoped, same auth as above.","operationId":"postApiEndpointsByidSequenceNext","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sequence/reset":{"post":{"tags":["Endpoints"],"summary":"Create reset","operationId":"postApiEndpointsByidSequenceReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/simulate-change":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidSimulateChange","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sla-config":{"post":{"tags":["Endpoints"],"summary":"Create sla config","operationId":"postApiEndpointsByidSlaConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List sla config","operationId":"getApiEndpointsByidSlaConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete sla config","operationId":"deleteApiEndpointsByidSlaConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/sla-config/history":{"get":{"tags":["Endpoints"],"summary":"List history","operationId":"getApiEndpointsByidSlaConfigHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/smart-links":{"post":{"tags":["Endpoints"],"summary":"============================================","operationId":"postApiEndpointsByidSmartLinks","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List smart links","operationId":"getApiEndpointsByidSmartLinks","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/tags":{"get":{"tags":["Endpoints"],"summary":"Endpoint-level tagging","operationId":"getApiEndpointsByidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create tags","operationId":"postApiEndpointsByidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/tags/{tagId}":{"delete":{"tags":["Endpoints"],"summary":"Delete tag","operationId":"deleteApiEndpointsByidTagsBytagid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tagId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/temporal-triggers":{"post":{"tags":["Endpoints"],"summary":"--- Scoped to endpoint ---","operationId":"postApiEndpointsByidTemporalTriggers","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List temporal triggers","operationId":"getApiEndpointsByidTemporalTriggers","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/time-travel/changes":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsByidTimeTravelChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/time-travel/compare":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidTimeTravelCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/time-travel/config":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsByidTimeTravelConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Endpoints"],"summary":"Patch config","operationId":"patchApiEndpointsByidTimeTravelConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/time-travel/query":{"get":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"getApiEndpointsByidTimeTravelQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/time-travel/snapshots":{"post":{"tags":["Endpoints"],"summary":"=============================================================================","operationId":"postApiEndpointsByidTimeTravelSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Endpoints"],"summary":"List snapshots","operationId":"getApiEndpointsByidTimeTravelSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/versions":{"get":{"tags":["Endpoints"],"summary":"Get schema versions for an endpoint","operationId":"getApiEndpointsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create a draft schema version","operationId":"postApiEndpointsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/versions/{versionId}":{"delete":{"tags":["Endpoints"],"summary":"Delete a draft version","operationId":"deleteApiEndpointsByidVersionsByversionid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/versions/{versionId}/publish":{"post":{"tags":["Endpoints"],"summary":"Publish a tested version","operationId":"postApiEndpointsByidVersionsByversionidPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/versions/{versionId}/test":{"post":{"tags":["Endpoints"],"summary":"Start testing a draft version","operationId":"postApiEndpointsByidVersionsByversionidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/vpn-policy":{"get":{"tags":["Endpoints"],"summary":"Get VPN policy for an endpoint","operationId":"getApiEndpointsByidVpnPolicy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update VPN policy for an endpoint","operationId":"putApiEndpointsByidVpnPolicy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{id}/vpn-stats":{"get":{"tags":["Endpoints"],"summary":"Get VPN detection stats for an endpoint","operationId":"getApiEndpointsByidVpnStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/anonymization/suggest":{"get":{"tags":["Endpoints"],"summary":"Suggest rules","operationId":"getApiEndpointsBynameAnonymizationSuggest","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/spatial/enable":{"post":{"tags":["Endpoints"],"summary":"------------------------------------------------------------------","operationId":"postApiEndpointsBynameSpatialEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/spatial/status":{"get":{"tags":["Endpoints"],"summary":"List status","operationId":"getApiEndpointsBynameSpatialStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/spatial/{fieldName}":{"delete":{"tags":["Endpoints"],"summary":"Delete spatial","operationId":"deleteApiEndpointsBynameSpatialByfieldname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/templates":{"get":{"tags":["Endpoints"],"summary":"Record Template CRUD \u2014 scoped under endpoints","operationId":"getApiEndpointsBynameTemplates","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Endpoints"],"summary":"Create templates","operationId":"postApiEndpointsBynameTemplates","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/templates/{id}":{"get":{"tags":["Endpoints"],"summary":"Get template","operationId":"getApiEndpointsBynameTemplatesByid","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Endpoints"],"summary":"Update template","operationId":"putApiEndpointsBynameTemplatesByid","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Endpoints"],"summary":"Delete template","operationId":"deleteApiEndpointsBynameTemplatesByid","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/endpoints/{name}/templates/{id}/resolve":{"post":{"tags":["Endpoints"],"summary":"Resolve template \u2014 fill placeholders and return ready-to-use data","operationId":"postApiEndpointsBynameTemplatesByidResolve","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/entity-relationships/graph":{"get":{"tags":["Entity relationships"],"summary":"Live graph computation","operationId":"getApiEntityRelationshipsGraph","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/entity-relationships/maps":{"post":{"tags":["Entity relationships"],"summary":"Saved maps CRUD","operationId":"postApiEntityRelationshipsMaps","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Entity relationships"],"summary":"List maps","operationId":"getApiEntityRelationshipsMaps","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/entity-relationships/maps/{id}":{"get":{"tags":["Entity relationships"],"summary":"Get map","operationId":"getApiEntityRelationshipsMapsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Entity relationships"],"summary":"Update map","operationId":"putApiEntityRelationshipsMapsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Entity relationships"],"summary":"Delete map","operationId":"deleteApiEntityRelationshipsMapsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environment-snapshots/{snapshotId}":{"delete":{"tags":["Environment snapshots"],"summary":"Delete environment snapshot","operationId":"deleteApiEnvironmentSnapshotsBysnapshotid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"snapshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments":{"get":{"tags":["Environments"],"summary":"Environment CRUD","operationId":"getApiEnvironments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Environments"],"summary":"Create environments","operationId":"postApiEnvironments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}":{"get":{"tags":["Environments"],"summary":"Get environment","operationId":"getApiEnvironmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Environments"],"summary":"Update environment","operationId":"putApiEnvironmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Environments"],"summary":"Delete environment","operationId":"deleteApiEnvironmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/changes":{"get":{"tags":["Environments"],"summary":"Changes & Promotion","operationId":"getApiEnvironmentsByidChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/endpoints":{"get":{"tags":["Environments"],"summary":"Endpoint mappings","operationId":"getApiEnvironmentsByidEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/promote":{"post":{"tags":["Environments"],"summary":"Create promote","operationId":"postApiEnvironmentsByidPromote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/promote/preview":{"get":{"tags":["Environments"],"summary":"List preview","operationId":"getApiEnvironmentsByidPromotePreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/snapshots":{"get":{"tags":["Environments"],"summary":"Snapshots (environment-specific)","operationId":"getApiEnvironmentsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Environments"],"summary":"Create snapshots","operationId":"postApiEnvironmentsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/sync":{"post":{"tags":["Environments"],"summary":"Sync operations","operationId":"postApiEnvironmentsByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/environments/{id}/sync/history":{"get":{"tags":["Environments"],"summary":"List history","operationId":"getApiEnvironmentsByidSyncHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ephemeral/expiring":{"get":{"tags":["Ephemeral"],"summary":"Authenticated routes \u2014 static paths before parameterized ones","operationId":"getApiEphemeralExpiring","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ephemeral/share/{token}":{"get":{"tags":["Ephemeral"],"summary":"Public route \u2014 no auth required","operationId":"getApiEphemeralShareBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/commands/{id}":{"get":{"tags":["Erp"],"summary":"Get command","operationId":"getApiErpCommandsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete command","operationId":"deleteApiErpCommandsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connection-templates":{"get":{"tags":["Erp"],"summary":"an integration id pattern.","operationId":"getApiErpConnectionTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connection-templates/{id}":{"get":{"tags":["Erp"],"summary":"Get connection template","operationId":"getApiErpConnectionTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Erp"],"summary":"Update connection template","operationId":"putApiErpConnectionTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete connection template","operationId":"deleteApiErpConnectionTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connection-templates/{id}/connections":{"post":{"tags":["Erp"],"summary":"Stand up a new connection from a template.","operationId":"postApiErpConnectionTemplatesByidConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/authenticate":{"post":{"tags":["Erp"],"summary":"Connector authentication - no JWT required, uses proxy credentials","operationId":"postApiErpConnectorAuthenticate","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/commands":{"get":{"tags":["Erp"],"summary":"Get pending commands - session token required","operationId":"getApiErpConnectorCommands","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/commands/{id}/ack":{"post":{"tags":["Erp"],"summary":"Acknowledge command - session token required","operationId":"postApiErpConnectorCommandsByidAck","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/commands/{id}/complete":{"post":{"tags":["Erp"],"summary":"Complete command - session token required","operationId":"postApiErpConnectorCommandsByidComplete","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/events":{"post":{"tags":["Erp"],"summary":"Submit event - session token required","operationId":"postApiErpConnectorEvents","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/events/batch":{"post":{"tags":["Erp"],"summary":"Submit events batch - session token required","operationId":"postApiErpConnectorEventsBatch","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/heartbeat":{"post":{"tags":["Erp"],"summary":"Heartbeat - session token required","operationId":"postApiErpConnectorHeartbeat","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connector/websocket":{"get":{"tags":["Erp"],"summary":"Get WebSocket connection info - session token required","operationId":"getApiErpConnectorWebsocket","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connectors":{"get":{"tags":["Erp"],"summary":"============================================================================","operationId":"getApiErpConnectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/connectors/{slug}":{"get":{"tags":["Erp"],"summary":"Get connector","operationId":"getApiErpConnectorsByslug","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/entities/{id}":{"get":{"tags":["Erp"],"summary":"Get entitie","operationId":"getApiErpEntitiesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Erp"],"summary":"Update entitie","operationId":"putApiErpEntitiesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete entitie","operationId":"deleteApiErpEntitiesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/entities/{id}/discover-fields":{"post":{"tags":["Erp"],"summary":"Create discover fields","operationId":"postApiErpEntitiesByidDiscoverFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/entities/{id}/preview":{"get":{"tags":["Erp"],"summary":"List preview","operationId":"getApiErpEntitiesByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations":{"post":{"tags":["Erp"],"summary":"Create integrations","operationId":"postApiErpIntegrations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Erp"],"summary":"List integrations","operationId":"getApiErpIntegrations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}":{"get":{"tags":["Erp"],"summary":"Get integration","operationId":"getApiErpIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Erp"],"summary":"Update integration","operationId":"putApiErpIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete integration","operationId":"deleteApiErpIntegrationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/commands":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpIntegrationsByidCommands","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/discover":{"post":{"tags":["Erp"],"summary":"Create discover","operationId":"postApiErpIntegrationsByidDiscover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/disable":{"post":{"tags":["Erp"],"summary":"Create disable","operationId":"postApiErpIntegrationsByidProxyDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/enable":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpIntegrationsByidProxyEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/provision-key":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpIntegrationsByidProxyProvisionKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/regenerate":{"post":{"tags":["Erp"],"summary":"Create regenerate","operationId":"postApiErpIntegrationsByidProxyRegenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/revoke-key":{"post":{"tags":["Erp"],"summary":"Create revoke key","operationId":"postApiErpIntegrationsByidProxyRevokeKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/stats":{"get":{"tags":["Erp"],"summary":"List stats","operationId":"getApiErpIntegrationsByidProxyStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/proxy/status":{"get":{"tags":["Erp"],"summary":"List status","operationId":"getApiErpIntegrationsByidProxyStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/query":{"post":{"tags":["Erp"],"summary":"Create query","operationId":"postApiErpIntegrationsByidQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/template":{"post":{"tags":["Erp"],"summary":"Capture a template FROM an existing connection.","operationId":"postApiErpIntegrationsByidTemplate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/template-drift":{"get":{"tags":["Erp"],"summary":"has no linked mode, so this only ever informs.","operationId":"getApiErpIntegrationsByidTemplateDrift","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{id}/test":{"post":{"tags":["Erp"],"summary":"Create test","operationId":"postApiErpIntegrationsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{integrationId}/entities":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpIntegrationsByintegrationidEntities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Erp"],"summary":"List entities","operationId":"getApiErpIntegrationsByintegrationidEntities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{integrationId}/sync-runs":{"get":{"tags":["Erp"],"summary":"Recent sync runs across all of an integration's mappings, in one query.","operationId":"getApiErpIntegrationsByintegrationidSyncRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/integrations/{integrationId}/transforms":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpIntegrationsByintegrationidTransforms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Erp"],"summary":"List transforms","operationId":"getApiErpIntegrationsByintegrationidTransforms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpMappings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Erp"],"summary":"List mappings","operationId":"getApiErpMappings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{id}":{"get":{"tags":["Erp"],"summary":"Get mapping","operationId":"getApiErpMappingsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Erp"],"summary":"Update mapping","operationId":"putApiErpMappingsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete mapping","operationId":"deleteApiErpMappingsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{id}/freshness":{"get":{"tags":["Erp"],"summary":"Check freshness status of an ERP mapping (without triggering sync)","operationId":"getApiErpMappingsByidFreshness","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{id}/refresh":{"post":{"tags":["Erp"],"summary":"Force immediate refresh of an ERP mapping (regardless of staleness)","operationId":"postApiErpMappingsByidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{id}/validate":{"post":{"tags":["Erp"],"summary":"Create validate","operationId":"postApiErpMappingsByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{mappingId}/sync":{"post":{"tags":["Erp"],"summary":"============================================================================","operationId":"postApiErpMappingsBymappingidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{mappingId}/sync/cancel":{"post":{"tags":["Erp"],"summary":"Create cancel","operationId":"postApiErpMappingsBymappingidSyncCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{mappingId}/sync/history":{"get":{"tags":["Erp"],"summary":"List history","operationId":"getApiErpMappingsBymappingidSyncHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/mappings/{mappingId}/sync/status":{"get":{"tags":["Erp"],"summary":"List status","operationId":"getApiErpMappingsBymappingidSyncStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/sync-runs/{id}":{"get":{"tags":["Erp"],"summary":"Get sync run","operationId":"getApiErpSyncRunsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/sync-runs/{syncRunId}/errors":{"get":{"tags":["Erp"],"summary":"List errors","operationId":"getApiErpSyncRunsBysyncrunidErrors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"syncRunId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/transforms":{"get":{"tags":["Erp"],"summary":"List transforms","operationId":"getApiErpTransforms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/transforms/preview":{"post":{"tags":["Erp"],"summary":"Static segment before @id so 'preview' isn't captured as an id.","operationId":"postApiErpTransformsPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/transforms/{id}":{"get":{"tags":["Erp"],"summary":"Get transform","operationId":"getApiErpTransformsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Erp"],"summary":"Update transform","operationId":"putApiErpTransformsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Erp"],"summary":"Delete transform","operationId":"deleteApiErpTransformsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/erp/transforms/{id}/run":{"post":{"tags":["Erp"],"summary":"Create run","operationId":"postApiErpTransformsByidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/escrow":{"post":{"tags":["Escrow"],"summary":"Create escrow","operationId":"postApiEscrow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Escrow"],"summary":"List escrow","operationId":"getApiEscrow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/escrow/{id}":{"get":{"tags":["Escrow"],"summary":"Get escrow","operationId":"getApiEscrowByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/escrow/{id}/cancel":{"post":{"tags":["Escrow"],"summary":"Create cancel","operationId":"postApiEscrowByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/escrow/{id}/open":{"post":{"tags":["Escrow"],"summary":"Create open","operationId":"postApiEscrowByidOpen","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/escrow/{id}/submit":{"post":{"tags":["Escrow"],"summary":"Create submit","operationId":"postApiEscrowByidSubmit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export-profiles":{"post":{"tags":["Export profiles"],"summary":"Profile CRUD","operationId":"postApiExportProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Export profiles"],"summary":"List export profiles","operationId":"getApiExportProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export-profiles/{id}":{"get":{"tags":["Export profiles"],"summary":"Main resource routes AFTER sub-resource routes","operationId":"getApiExportProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Export profiles"],"summary":"Update export profile","operationId":"putApiExportProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Export profiles"],"summary":"Delete export profile","operationId":"deleteApiExportProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export-profiles/{id}/run":{"post":{"tags":["Export profiles"],"summary":"Sub-resource routes BEFORE /@id to prevent FlightPHP matching them as an ID","operationId":"postApiExportProfilesByidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export-profiles/{id}/runs":{"get":{"tags":["Export profiles"],"summary":"List runs","operationId":"getApiExportProfilesByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export-runs/{runId}/download":{"get":{"tags":["Export runs"],"summary":"Export run download (separate top-level resource for clean URL)","operationId":"getApiExportRunsByrunidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/curl":{"get":{"tags":["Export"],"summary":"List curl","operationId":"getApiExportCurl","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/formats":{"get":{"tags":["Export"],"summary":"List formats","operationId":"getApiExportFormats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/httpie":{"get":{"tags":["Export"],"summary":"List httpie","operationId":"getApiExportHttpie","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/insomnia":{"get":{"tags":["Export"],"summary":"List insomnia","operationId":"getApiExportInsomnia","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/openapi":{"get":{"tags":["Export"],"summary":"List openapi","operationId":"getApiExportOpenapi","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/postman":{"get":{"tags":["Export"],"summary":"List postman","operationId":"getApiExportPostman","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/export/soapui":{"get":{"tags":["Export"],"summary":"List soapui","operationId":"getApiExportSoapui","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-costs/features":{"get":{"tags":["Feature costs"],"summary":"List available features with pricing info","operationId":"getApiFeatureCostsFeatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-costs/my/endpoints/{endpointId}":{"get":{"tags":["Feature costs"],"summary":"Get endpoint","operationId":"getApiFeatureCostsMyEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-costs/my/history":{"get":{"tags":["Feature costs"],"summary":"List history","operationId":"getApiFeatureCostsMyHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-costs/my/redeem":{"post":{"tags":["Feature costs"],"summary":"Redeem promo code","operationId":"postApiFeatureCostsMyRedeem","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-costs/my/summary":{"get":{"tags":["Feature costs"],"summary":"My billing dashboard","operationId":"getApiFeatureCostsMySummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags":{"post":{"tags":["Feature flags"],"summary":"--- Flag CRUD ---","operationId":"postApiFeatureFlags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Feature flags"],"summary":"List feature flags","operationId":"getApiFeatureFlags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/evaluate":{"post":{"tags":["Feature flags"],"summary":"--- Evaluation ---","operationId":"postApiFeatureFlagsEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/evaluate-batch":{"post":{"tags":["Feature flags"],"summary":"Create evaluate batch","operationId":"postApiFeatureFlagsEvaluateBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/{flagId}/overrides/{overrideId}":{"delete":{"tags":["Feature flags"],"summary":"Delete override","operationId":"deleteApiFeatureFlagsByflagidOverridesByoverrideid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"flagId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"overrideId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/{id}":{"get":{"tags":["Feature flags"],"summary":"Get feature flag","operationId":"getApiFeatureFlagsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Feature flags"],"summary":"Update feature flag","operationId":"putApiFeatureFlagsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Feature flags"],"summary":"Delete feature flag","operationId":"deleteApiFeatureFlagsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/{id}/audit-log":{"get":{"tags":["Feature flags"],"summary":"--- Audit Log ---","operationId":"getApiFeatureFlagsByidAuditLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/{id}/overrides":{"post":{"tags":["Feature flags"],"summary":"--- Overrides ---","operationId":"postApiFeatureFlagsByidOverrides","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Feature flags"],"summary":"List overrides","operationId":"getApiFeatureFlagsByidOverrides","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/feature-flags/{id}/stats":{"get":{"tags":["Feature flags"],"summary":"--- Stats ---","operationId":"getApiFeatureFlagsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups":{"post":{"tags":["Federation"],"summary":"=============================================================================","operationId":"postApiFederationGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Federation"],"summary":"List groups","operationId":"getApiFederationGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{groupId}/aggregate/{federatedEndpoint}":{"post":{"tags":["Federation"],"summary":"Create aggregate","operationId":"postApiFederationGroupsBygroupidAggregateByfederatedendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"federatedEndpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{groupId}/endpoints/{mappingId}":{"put":{"tags":["Federation"],"summary":"Update endpoint","operationId":"putApiFederationGroupsBygroupidEndpointsBymappingid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Federation"],"summary":"Delete endpoint","operationId":"deleteApiFederationGroupsBygroupidEndpointsBymappingid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"mappingId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{groupId}/members/{memberId}":{"put":{"tags":["Federation"],"summary":"Update member","operationId":"putApiFederationGroupsBygroupidMembersBymemberid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Federation"],"summary":"Delete member","operationId":"deleteApiFederationGroupsBygroupidMembersBymemberid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{groupId}/query/{federatedEndpoint}":{"get":{"tags":["Federation"],"summary":"=============================================================================","operationId":"getApiFederationGroupsBygroupidQueryByfederatedendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"federatedEndpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{id}":{"get":{"tags":["Federation"],"summary":"Get group","operationId":"getApiFederationGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Federation"],"summary":"Update group","operationId":"putApiFederationGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Federation"],"summary":"Delete group","operationId":"deleteApiFederationGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{id}/endpoints":{"get":{"tags":["Federation"],"summary":"=============================================================================","operationId":"getApiFederationGroupsByidEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Federation"],"summary":"Create endpoints","operationId":"postApiFederationGroupsByidEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{id}/history":{"get":{"tags":["Federation"],"summary":"List history","operationId":"getApiFederationGroupsByidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{id}/members":{"get":{"tags":["Federation"],"summary":"=============================================================================","operationId":"getApiFederationGroupsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Federation"],"summary":"Create members","operationId":"postApiFederationGroupsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/groups/{id}/regenerate-invite":{"post":{"tags":["Federation"],"summary":"Create regenerate invite","operationId":"postApiFederationGroupsByidRegenerateInvite","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/join":{"post":{"tags":["Federation"],"summary":"Create join","operationId":"postApiFederationJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/peers":{"post":{"tags":["Federation"],"summary":"=============================================================================","operationId":"postApiFederationPeers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Federation"],"summary":"List peers","operationId":"getApiFederationPeers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/peers/{id}":{"get":{"tags":["Federation"],"summary":"Get peer","operationId":"getApiFederationPeersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Federation"],"summary":"Update peer","operationId":"putApiFederationPeersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Federation"],"summary":"Delete peer","operationId":"deleteApiFederationPeersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/peers/{id}/health-check":{"post":{"tags":["Federation"],"summary":"=============================================================================","operationId":"postApiFederationPeersByidHealthCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/federation/query":{"post":{"tags":["Federation"],"summary":"=============================================================================","operationId":"postApiFederationQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/field-permission-policies/{policyId}":{"put":{"tags":["Field permission policies"],"summary":"Update / Delete by policy UUID (not scoped under endpoint in URL)","operationId":"putApiFieldPermissionPoliciesBypolicyid","security":[],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Field permission policies"],"summary":"Delete field permission policie","operationId":"deleteApiFieldPermissionPoliciesBypolicyid","security":[],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/field-permissions":{"post":{"tags":["Field permissions"],"summary":"----- Field Permissions Routes -----","operationId":"postApiFieldPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-area-import-jobs":{"get":{"tags":["File area import jobs"],"summary":"All of the user's import jobs across every file area (one query). Before /@jobId.","operationId":"getApiFileAreaImportJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-area-import-jobs/{jobId}":{"get":{"tags":["File area import jobs"],"summary":"Get import job status","operationId":"getApiFileAreaImportJobsByjobid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-area-import-jobs/{jobId}/cancel":{"post":{"tags":["File area import jobs"],"summary":"Cancel an import job","operationId":"postApiFileAreaImportJobsByjobidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas":{"post":{"tags":["File areas"],"summary":"--- Area CRUD ---","operationId":"postApiFileAreas","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File areas"],"summary":"List file areas","operationId":"getApiFileAreas","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/bulk":{"post":{"tags":["File areas"],"summary":"Before '/@id' as well: 'bulk' must not be read as an area id.","operationId":"postApiFileAreasBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/sharers":{"get":{"tags":["File areas"],"summary":"Also before '/@id', for the same reason.","operationId":"getApiFileAreasSharers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests":{"get":{"tags":["File areas"],"summary":"List transfer requests","operationId":"getApiFileAreasTransferRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/by-id/{id}/accept":{"post":{"tags":["File areas"],"summary":"Create accept","operationId":"postApiFileAreasTransferRequestsByIdByidAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/by-id/{id}/decline":{"post":{"tags":["File areas"],"summary":"Create decline","operationId":"postApiFileAreasTransferRequestsByIdByidDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/by-token/{token}":{"get":{"tags":["File areas"],"summary":"What the link in the notification email resolves to.","operationId":"getApiFileAreasTransferRequestsByTokenBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/{id}":{"delete":{"tags":["File areas"],"summary":"Delete transfer request","operationId":"deleteApiFileAreasTransferRequestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/{token}/accept":{"post":{"tags":["File areas"],"summary":"Create accept","operationId":"postApiFileAreasTransferRequestsBytokenAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/transfer-requests/{token}/decline":{"post":{"tags":["File areas"],"summary":"Create decline","operationId":"postApiFileAreasTransferRequestsBytokenDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/access":{"get":{"tags":["File areas"],"summary":"#425: who reaches this area and by what authority.","operationId":"getApiFileAreasByareaidAccess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/access-log":{"get":{"tags":["File areas"],"summary":"List access log","operationId":"getApiFileAreasByareaidAccessLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/bulk-delete":{"post":{"tags":["File areas"],"summary":"Bulk operations","operationId":"postApiFileAreasByareaidBulkDelete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/bulk-move":{"post":{"tags":["File areas"],"summary":"Create bulk move","operationId":"postApiFileAreasByareaidBulkMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/chunked-upload/init":{"post":{"tags":["File areas \u2014 chunked upload"],"summary":"Initialize a chunked upload session","description":"Start a new chunked-upload session for a large file. Returns an `upload_token` and the negotiated `chunk_size` + `total_chunks` the client should split the file into. The `chunk_size` argument is a hint \u2014 the server may clamp it to per-area policy.\n\nSession files (the on-disk chunk staging area) auto-expire after 24h via the cleanup-chunked-uploads cron, but explicit /abort is preferred when the client knows it won't resume.","operationId":"postApiFileAreasByareaidChunkedUploadInit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"201":{"description":"Session created","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"upload_token":{"type":"string"},"chunk_size":{"type":"integer","format":"int64"},"total_chunks":{"type":"integer"}}}}}}}},"400":{"description":"Missing fields, file too large, or invalid input"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"File area not found or insufficient permissions"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/chunked-upload/{token}":{"delete":{"tags":["File areas \u2014 chunked upload"],"summary":"Abort and clean up a chunked upload session","description":"Drop the in-progress session and delete every chunk on disk. Safe to call repeatedly. Sessions auto-expire after 24 h via the cleanup-chunked-uploads cron, but explicit abort is preferred when the client knows it won't resume.","operationId":"deleteApiFileAreasByareaidChunkedUploadBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"upload_token returned by /init"}],"responses":{"204":{"description":"Session removed"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Token does not match area"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/chunked-upload/{token}/chunk/{index}":{"post":{"tags":["File areas \u2014 chunked upload"],"summary":"Upload a single chunk","description":"Upload a single chunk of the file. The request body is the **raw chunk bytes** with `Content-Type: application/octet-stream` \u2014 do NOT wrap in multipart or JSON.\n\nRe-uploading the same `index` is idempotent (the server returns success without rewriting the chunk). Use this property to recover from network failures: query /status, then re-push only the indices the server is missing.\n\nMaximum chunk size: **256 MB** hard ceiling. The per-session `chunk_size` from /init is also enforced.","operationId":"postApiFileAreasByareaidChunkedUploadBytokenChunkByindex","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"upload_token returned by /init"},{"name":"index","in":"path","required":true,"schema":{"type":"string"},"description":"Zero-based chunk index"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Chunk accepted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"chunks_received":{"type":"integer"},"total_chunks":{"type":"integer"},"complete":{"type":"boolean","description":"True once every chunk has been received \u2014 caller may now POST /complete."}}}}}}}},"400":{"description":"Empty body or out-of-range index"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Token does not belong to this area"},"413":{"description":"Chunk exceeds 256 MB or per-session chunk_size"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/chunked-upload/{token}/complete":{"post":{"tags":["File areas \u2014 chunked upload"],"summary":"Finalize the upload and assemble the file","description":"Reassemble all chunks into the final file and create a regular file record in the area. Cleans up the staging chunks whether assembly succeeds or fails.","operationId":"postApiFileAreasByareaidChunkedUploadBytokenComplete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"upload_token returned by /init"}],"responses":{"201":{"description":"File created \u2014 same shape as the regular POST /api/file-areas/{areaId}/files response"},"400":{"description":"Upload incomplete (missing chunks) or assembled-size mismatch"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Permission revoked since /init, or token does not match area"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/chunked-upload/{token}/status":{"get":{"tags":["File areas \u2014 chunked upload"],"summary":"Inspect chunked-upload progress","description":"Return how many chunks the server has accepted so far, plus the original file_name and file_size from /init. Use this to resume an interrupted upload \u2014 the client compares its sent indices against `chunks_received` and re-pushes only the gaps. Combine with the idempotency of POST /chunk for transparent resume.","operationId":"getApiFileAreasByareaidChunkedUploadBytokenStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"},"description":"upload_token returned by /init"}],"responses":{"200":{"description":"Session status","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"chunks_received":{"type":"integer"},"total_chunks":{"type":"integer"},"file_name":{"type":"string"},"file_size":{"type":"integer","format":"int64"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Token does not match area"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/download-zip":{"get":{"tags":["File areas"],"summary":"List download zip","operationId":"getApiFileAreasByareaidDownloadZip","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/external-shares":{"post":{"tags":["File areas"],"summary":"--- External Sharing (authenticated API) ---","operationId":"postApiFileAreasByareaidExternalShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File areas"],"summary":"List external shares","operationId":"getApiFileAreasByareaidExternalShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/external-shares/{shareId}":{"delete":{"tags":["File areas"],"summary":"Delete external share","operationId":"deleteApiFileAreasByareaidExternalSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files":{"post":{"tags":["File areas"],"summary":"--- File Management ---","operationId":"postApiFileAreasByareaidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File areas"],"summary":"List files","operationId":"getApiFileAreasByareaidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/exists":{"post":{"tags":["File areas"],"summary":"isn't captured by the placeholder.","operationId":"postApiFileAreasByareaidFilesExists","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/presigned-confirm":{"post":{"tags":["File areas"],"summary":"Create presigned confirm","operationId":"postApiFileAreasByareaidFilesPresignedConfirm","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/presigned-upload":{"post":{"tags":["File areas"],"summary":"--- Presigned Uploads: File Areas ---","operationId":"postApiFileAreasByareaidFilesPresignedUpload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/search-by-metadata":{"get":{"tags":["File areas"],"summary":"metadata\" segment doesn't get caught by the @fileId placeholder.","operationId":"getApiFileAreasByareaidFilesSearchByMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}":{"delete":{"tags":["File areas"],"summary":"Delete file","operationId":"deleteApiFileAreasByareaidFilesByfileid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Rename file/folder","operationId":"putApiFileAreasByareaidFilesByfileid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/approve":{"post":{"tags":["File areas"],"summary":"Create approve","operationId":"postApiFileAreasByareaidFilesByfileidApprove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/download":{"get":{"tags":["File areas"],"summary":"List download","operationId":"getApiFileAreasByareaidFilesByfileidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/metadata":{"get":{"tags":["File areas"],"summary":"List metadata","operationId":"getApiFileAreasByareaidFilesByfileidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update metadata","operationId":"putApiFileAreasByareaidFilesByfileidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["File areas"],"summary":"Patch metadata","operationId":"patchApiFileAreasByareaidFilesByfileidMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/move":{"post":{"tags":["File areas"],"summary":"Move file/folder","operationId":"postApiFileAreasByareaidFilesByfileidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update move","operationId":"putApiFileAreasByareaidFilesByfileidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/rename":{"put":{"tags":["File areas"],"summary":"--- Rename & Move: File Area Files ---","operationId":"putApiFileAreasByareaidFilesByfileidRename","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/revisions":{"get":{"tags":["File areas"],"summary":"--- File Revisions ---","operationId":"getApiFileAreasByareaidFilesByfileidRevisions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/revisions/compare":{"get":{"tags":["File areas"],"summary":"List compare","operationId":"getApiFileAreasByareaidFilesByfileidRevisionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/revisions/{rev}":{"get":{"tags":["File areas"],"summary":"Get revision","operationId":"getApiFileAreasByareaidFilesByfileidRevisionsByrev","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"rev","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/revisions/{rev}/download":{"get":{"tags":["File areas"],"summary":"List download","operationId":"getApiFileAreasByareaidFilesByfileidRevisionsByrevDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"rev","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/revisions/{rev}/restore":{"post":{"tags":["File areas"],"summary":"Create restore","operationId":"postApiFileAreasByareaidFilesByfileidRevisionsByrevRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"rev","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/tags":{"get":{"tags":["File areas"],"summary":"--- File Tags ---","operationId":"getApiFileAreasByareaidFilesByfileidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["File areas"],"summary":"Create tags","operationId":"postApiFileAreasByareaidFilesByfileidTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/files/{fileId}/tags/{tagId}":{"delete":{"tags":["File areas"],"summary":"Delete tag","operationId":"deleteApiFileAreasByareaidFilesByfileidTagsBytagid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tagId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/folders":{"post":{"tags":["File areas"],"summary":"--- Folder Management ---","operationId":"postApiFileAreasByareaidFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File areas"],"summary":"List folders","operationId":"getApiFileAreasByareaidFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/folders/{folderId}":{"delete":{"tags":["File areas"],"summary":"Delete folder","operationId":"deleteApiFileAreasByareaidFoldersByfolderid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update folder","operationId":"putApiFileAreasByareaidFoldersByfolderid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/folders/{folderId}/move":{"post":{"tags":["File areas"],"summary":"Create move","operationId":"postApiFileAreasByareaidFoldersByfolderidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update move","operationId":"putApiFileAreasByareaidFoldersByfolderidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/folders/{folderId}/rename":{"put":{"tags":["File areas"],"summary":"--- Rename & Move: File Area Folders ---","operationId":"putApiFileAreasByareaidFoldersByfolderidRename","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/import":{"post":{"tags":["File areas"],"summary":"Start a file import into a file area","operationId":"postApiFileAreasByareaidImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/import-jobs":{"get":{"tags":["File areas"],"summary":"List import jobs for a file area","operationId":"getApiFileAreasByareaidImportJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/object-lock":{"get":{"tags":["File areas"],"summary":"List object lock","operationId":"getApiFileAreasByareaidObjectLock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update object lock","operationId":"putApiFileAreasByareaidObjectLock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/objects":{"get":{"tags":["File areas"],"summary":"the agent enumerates snapshots/ + index/ and uploads/downloads packs directly.","operationId":"getApiFileAreasByareaidObjects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/objects/delete":{"post":{"tags":["File areas"],"summary":"`delete` permission; WORM-retained objects are refused (skipped_locked).","operationId":"postApiFileAreasByareaidObjectsDelete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/permissions":{"get":{"tags":["File areas"],"summary":"List permissions","operationId":"getApiFileAreasByareaidPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/presigned-download":{"post":{"tags":["File areas"],"summary":"Create presigned download","operationId":"postApiFileAreasByareaidPresignedDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/presigned-upload":{"post":{"tags":["File areas"],"summary":"Create presigned upload","operationId":"postApiFileAreasByareaidPresignedUpload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/search-text":{"get":{"tags":["File areas"],"summary":"FileAreaService, so there is one rule about who may read an area.","operationId":"getApiFileAreasByareaidSearchText","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/shares":{"get":{"tags":["File areas"],"summary":"List shares","operationId":"getApiFileAreasByareaidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["File areas"],"summary":"Create shares","operationId":"postApiFileAreasByareaidShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/shares/{shareId}":{"put":{"tags":["File areas"],"summary":"Update share","operationId":"putApiFileAreasByareaidSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File areas"],"summary":"Delete share","operationId":"deleteApiFileAreasByareaidSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/stats":{"get":{"tags":["File areas"],"summary":"--- Stats & Access Log ---","operationId":"getApiFileAreasByareaidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/subscriptions":{"post":{"tags":["File areas"],"summary":"--- Subscriptions (Watch notifications) ---","operationId":"postApiFileAreasByareaidSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File areas"],"summary":"List subscriptions","operationId":"getApiFileAreasByareaidSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/subscriptions/{subId}":{"delete":{"tags":["File areas"],"summary":"Delete subscription","operationId":"deleteApiFileAreasByareaidSubscriptionsBysubid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links":{"get":{"tags":["File areas"],"summary":"List links on an area","operationId":"getApiFileAreasByareaidSyncLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["File areas"],"summary":"Create a link (starts in preview)","operationId":"postApiFileAreasByareaidSyncLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}":{"get":{"tags":["File areas"],"summary":"Get sync link","operationId":"getApiFileAreasByareaidSyncLinksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update sync link","operationId":"putApiFileAreasByareaidSyncLinksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File areas"],"summary":"Delete sync link","operationId":"deleteApiFileAreasByareaidSyncLinksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/approve":{"post":{"tags":["File areas"],"summary":"Create approve","operationId":"postApiFileAreasByareaidSyncLinksByidApprove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/conflicts":{"get":{"tags":["File areas"],"summary":"List conflicts","operationId":"getApiFileAreasByareaidSyncLinksByidConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/preview":{"post":{"tags":["File areas"],"summary":"trailing segments are not swallowed by the id parameter.","operationId":"postApiFileAreasByareaidSyncLinksByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/resume":{"post":{"tags":["File areas"],"summary":"Create resume","operationId":"postApiFileAreasByareaidSyncLinksByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/runs":{"get":{"tags":["File areas"],"summary":"List runs","operationId":"getApiFileAreasByareaidSyncLinksByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/sync-links/{id}/sync":{"post":{"tags":["File areas"],"summary":"Create sync","operationId":"postApiFileAreasByareaidSyncLinksByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{areaId}/tree":{"get":{"tags":["File areas"],"summary":"--- Combined folder+file tree (roadmap #253) ---","operationId":"getApiFileAreasByareaidTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}":{"get":{"tags":["File areas"],"summary":"Get file area","operationId":"getApiFileAreasByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File areas"],"summary":"Update file area","operationId":"putApiFileAreasByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File areas"],"summary":"Delete file area","operationId":"deleteApiFileAreasByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}/activate":{"post":{"tags":["File areas"],"summary":"Create activate","operationId":"postApiFileAreasByidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}/disable":{"post":{"tags":["File areas"],"summary":"Create disable","operationId":"postApiFileAreasByidDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}/storage-task":{"get":{"tags":["File areas"],"summary":"--- Storage Task Status ---","operationId":"getApiFileAreasByidStorageTask","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}/storage-task/cancel":{"post":{"tags":["File areas"],"summary":"could clear it. Audit finding #8.","operationId":"postApiFileAreasByidStorageTaskCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{id}/transfer":{"post":{"tags":["File areas"],"summary":"transfer-request routes near the top of this file.","operationId":"postApiFileAreasByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{sourceId}/copy-to-new":{"post":{"tags":["File areas"],"summary":"Create copy to new","operationId":"postApiFileAreasBysourceidCopyToNew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-areas/{sourceId}/copy-to/{targetId}":{"post":{"tags":["File areas"],"summary":"--- Copy Files ---","operationId":"postApiFileAreasBysourceidCopyToBytargetid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"targetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-preview/generators":{"post":{"tags":["File preview"],"summary":"--- Generator CRUD ---","operationId":"postApiFilePreviewGenerators","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File preview"],"summary":"List generators","operationId":"getApiFilePreviewGenerators","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-preview/generators/{id}":{"get":{"tags":["File preview"],"summary":"Get generator","operationId":"getApiFilePreviewGeneratorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File preview"],"summary":"Update generator","operationId":"putApiFilePreviewGeneratorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File preview"],"summary":"Delete generator","operationId":"deleteApiFilePreviewGeneratorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-preview/webhook-callback/{queueItemId}":{"post":{"tags":["File preview"],"summary":"--- Webhook Callback (NO auth required) ---","operationId":"postApiFilePreviewWebhookCallbackByqueueitemid","security":[],"parameters":[{"name":"queueItemId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file-preview/{previewId}/regenerate":{"post":{"tags":["File preview"],"summary":"Create regenerate","operationId":"postApiFilePreviewBypreviewidRegenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"previewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files":{"get":{"tags":["File Library"],"summary":"List user's files with optional folder filter","operationId":"getApiFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/copy-from-file-area":{"post":{"tags":["File Library"],"summary":"copy collapses the bridge to one auth'd same-origin call.","operationId":"postApiFilesCopyFromFileArea","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders":{"post":{"tags":["File Library"],"summary":"----- File Folder Routes -----","operationId":"postApiFilesFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File Library"],"summary":"List folders","operationId":"getApiFilesFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/browse":{"get":{"tags":["File Library"],"summary":"List browse","operationId":"getApiFilesFoldersBrowse","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/search":{"get":{"tags":["File Library"],"summary":"List search","operationId":"getApiFilesFoldersSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/tree":{"get":{"tags":["File Library"],"summary":"List tree","operationId":"getApiFilesFoldersTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/{id}":{"get":{"tags":["File Library"],"summary":"Get folder","operationId":"getApiFilesFoldersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["File Library"],"summary":"Update folder","operationId":"putApiFilesFoldersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File Library"],"summary":"Delete folder","operationId":"deleteApiFilesFoldersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/{id}/contents":{"get":{"tags":["File Library"],"summary":"List contents","operationId":"getApiFilesFoldersByidContents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/folders/{id}/move":{"put":{"tags":["File Library"],"summary":"Update move","operationId":"putApiFilesFoldersByidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/links":{"post":{"tags":["File Library"],"summary":"----- File Record Link Routes -----","operationId":"postApiFilesLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/links/stats":{"get":{"tags":["File Library"],"summary":"and this handler never runs. Enforced by bin/route-check.php.","operationId":"getApiFilesLinksStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/links/{linkId}":{"get":{"tags":["File Library"],"summary":"Get link","operationId":"getApiFilesLinksBylinkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"linkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File Library"],"summary":"Delete link","operationId":"deleteApiFilesLinksBylinkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"linkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/presigned-confirm":{"post":{"tags":["File Library"],"summary":"Create presigned confirm","operationId":"postApiFilesPresignedConfirm","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/presigned-upload":{"post":{"tags":["File Library"],"summary":"--- Presigned Uploads: File Library ---","operationId":"postApiFilesPresignedUpload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/upload":{"post":{"tags":["File Library"],"summary":"Upload file without requiring an endpoint (into a folder or unfiled)","operationId":"postApiFilesUpload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{attachmentId}/links":{"get":{"tags":["File Library"],"summary":"List links","operationId":"getApiFilesByattachmentidLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/download":{"get":{"tags":["File Library"],"summary":"--- Presigned Downloads: File Library ---","operationId":"getApiFilesByfileidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/previews":{"post":{"tags":["File Library"],"summary":"--- Preview Operations ---","operationId":"postApiFilesByfileidPreviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["File Library"],"summary":"List previews","operationId":"getApiFilesByfileidPreviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/previews/all":{"post":{"tags":["File Library"],"summary":"Create all","operationId":"postApiFilesByfileidPreviewsAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/previews/{type}":{"get":{"tags":["File Library"],"summary":"Get preview","operationId":"getApiFilesByfileidPreviewsBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File Library"],"summary":"Delete preview","operationId":"deleteApiFilesByfileidPreviewsBytype","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/process":{"post":{"tags":["File Library"],"summary":"File-scoped routes: process and variants","operationId":"postApiFilesByfileidProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/variants":{"get":{"tags":["File Library"],"summary":"Variant collection routes (GET list, DELETE all) BEFORE parameterized variant name routes","operationId":"getApiFilesByfileidVariants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File Library"],"summary":"Delete variants","operationId":"deleteApiFilesByfileidVariants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/variants/{variantName}":{"get":{"tags":["File Library"],"summary":"Get variant","operationId":"getApiFilesByfileidVariantsByvariantname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"variantName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["File Library"],"summary":"Delete variant","operationId":"deleteApiFilesByfileidVariantsByvariantname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"variantName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{fileId}/variants/{variantName}/download":{"get":{"tags":["File Library"],"summary":"literal \"/download\" suffix doesn't get caught by the placeholder.","operationId":"getApiFilesByfileidVariantsByvariantnameDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"variantName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{id}":{"delete":{"tags":["File Library"],"summary":"Delete a file from the library","operationId":"deleteApiFilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/files/{id}/move":{"put":{"tags":["File Library"],"summary":"Move file to folder","operationId":"putApiFilesByidMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/firewall-policies":{"get":{"tags":["Firewall policies"],"summary":"============================ Policies ============================","operationId":"getApiFirewallPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Firewall policies"],"summary":"Create firewall policies","operationId":"postApiFirewallPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/firewall-policies/{policyId}":{"patch":{"tags":["Firewall policies"],"summary":"Rename / re-describe a firewall policy","description":"**Access:** policy owner, or manage/admin share on the policy.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"patchApiFirewallPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"1-80 chars"},"description":{"type":"string","description":"Up to 400 chars","nullable":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"name required (1-80 chars)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Policy not found (also with view-only access)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Firewall policies"],"summary":"Get firewall policie","operationId":"getApiFirewallPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Firewall policies"],"summary":"Delete firewall policie","operationId":"deleteApiFirewallPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/firewall-policies/{policyId}/rules":{"get":{"tags":["Firewall policies"],"summary":"List rules","operationId":"getApiFirewallPoliciesBypolicyidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Firewall policies"],"summary":"Create rules","operationId":"postApiFirewallPoliciesBypolicyidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/firewall-rules/{ruleId}":{"get":{"tags":["Firewall rules"],"summary":"Get a firewall rule","description":"**Access:** rule owner, or view on its policy or agent.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"getApiFirewallRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Rule not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Firewall rules"],"summary":"Update a firewall rule","description":"**Access:** rule owner, or manage on its policy or agent.\n\nMerged with the existing rule; any change resets applied_status to pending until the next sync.\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"patchApiFirewallRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rule_action":{"type":"string","enum":["allow","deny"]},"direction":{"type":"string","enum":["inbound","outbound"]},"protocol":{"type":"string","enum":["tcp","udp","both","icmp","any"]},"ports":{"type":"string","description":"Port, list and/or ranges, e.g. 80,443,8000-9000"},"sources":{"type":"string","description":"Comma-separated IPs/CIDRs/hostnames; null = any source","nullable":true},"description":{"type":"string"},"is_persistent":{"type":"boolean"},"expires_at":{"type":"string","format":"date-time","nullable":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Validation message","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"rule access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Rule not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Firewall rules"],"summary":"Delete a firewall rule","description":"**Access:** rule owner, or manage on its policy or agent.\n\n\n\nResponse shapes and the access-level model: Remote Agents API Reference (remote-agents-reference.md).","operationId":"deleteApiFirewallRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"rule access denied","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"404":{"description":"Rule not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/fission-fusion":{"get":{"tags":["Fission fusion"],"summary":"List fission fusion","operationId":"getApiFissionFusion","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/fission-fusion/{jobId}":{"get":{"tags":["Fission fusion"],"summary":"Get fission fusion","operationId":"getApiFissionFusionByjobid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/flow-collectors/{id}":{"get":{"tags":["Flow collectors"],"summary":"Get flow collector","operationId":"getApiFlowCollectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Flow collectors"],"summary":"Update flow collector","operationId":"putApiFlowCollectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Flow collectors"],"summary":"Delete flow collector","operationId":"deleteApiFlowCollectorsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/flow-collectors/{id}/regenerate-token":{"post":{"tags":["Flow collectors"],"summary":"Create regenerate token","operationId":"postApiFlowCollectorsByidRegenerateToken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/following":{"get":{"tags":["Following"],"summary":"List following","operationId":"getApiFollowing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forecasts":{"get":{"tags":["Forecasts"],"summary":"Latest forecast for every endpoint the user owns, in one query (admin overview).","operationId":"getApiForecasts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forks":{"get":{"tags":["Forks"],"summary":"List forks","operationId":"getApiForks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forks/{id}":{"get":{"tags":["Forks"],"summary":"Get fork","operationId":"getApiForksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forks/{id}/pull-request":{"post":{"tags":["Forks"],"summary":"Create pull request","operationId":"postApiForksByidPullRequest","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forks/{id}/sync":{"post":{"tags":["Forks"],"summary":"Create sync","operationId":"postApiForksByidSync","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/formats":{"get":{"tags":["Formats"],"summary":"Supported response formats","operationId":"getApiFormats","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms":{"post":{"tags":["Forms"],"summary":"------------------------------------------","operationId":"postApiForms","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Forms"],"summary":"List forms","operationId":"getApiForms","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}":{"get":{"tags":["Forms"],"summary":"Get form","operationId":"getApiFormsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Forms"],"summary":"Update form","operationId":"putApiFormsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Forms"],"summary":"Delete form","operationId":"deleteApiFormsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/abandonment":{"get":{"tags":["Forms"],"summary":"List abandonment","operationId":"getApiFormsByidAbandonment","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/analytics":{"get":{"tags":["Forms"],"summary":"List analytics","operationId":"getApiFormsByidAnalytics","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/analytics/detailed":{"get":{"tags":["Forms"],"summary":"List detailed","operationId":"getApiFormsByidAnalyticsDetailed","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/close":{"post":{"tags":["Forms"],"summary":"Create close","operationId":"postApiFormsByidClose","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/draft":{"put":{"tags":["Forms"],"summary":"Draft Versioning (for published forms)","operationId":"putApiFormsByidDraft","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Forms"],"summary":"Delete draft","operationId":"deleteApiFormsByidDraft","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/draft/publish":{"post":{"tags":["Forms"],"summary":"Create publish","operationId":"postApiFormsByidDraftPublish","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/publish":{"post":{"tags":["Forms"],"summary":"Create publish","operationId":"postApiFormsByidPublish","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/revisions":{"get":{"tags":["Forms"],"summary":"Form Revisions","operationId":"getApiFormsByidRevisions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Forms"],"summary":"Create revisions","operationId":"postApiFormsByidRevisions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/revisions/{revId}":{"get":{"tags":["Forms"],"summary":"Get revision","operationId":"getApiFormsByidRevisionsByrevid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/revisions/{revId}/fork":{"post":{"tags":["Forms"],"summary":"Create fork","operationId":"postApiFormsByidRevisionsByrevidFork","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/revisions/{revId}/restore":{"post":{"tags":["Forms"],"summary":"Create restore","operationId":"postApiFormsByidRevisionsByrevidRestore","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"revId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions":{"get":{"tags":["Forms"],"summary":"List submissions","operationId":"getApiFormsByidSubmissions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions/{sid}":{"get":{"tags":["Forms"],"summary":"Get submission","operationId":"getApiFormsByidSubmissionsBysid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Forms"],"summary":"Delete submission","operationId":"deleteApiFormsByidSubmissionsBysid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions/{sid}/approve":{"post":{"tags":["Forms"],"summary":"Create approve","operationId":"postApiFormsByidSubmissionsBysidApprove","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions/{sid}/files":{"get":{"tags":["Forms"],"summary":"List files","operationId":"getApiFormsByidSubmissionsBysidFiles","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions/{sid}/files/{fid}":{"get":{"tags":["Forms"],"summary":"Get file","operationId":"getApiFormsByidSubmissionsBysidFilesByfid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submissions/{sid}/reject":{"post":{"tags":["Forms"],"summary":"Create reject","operationId":"postApiFormsByidSubmissionsBysidReject","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/forms/{id}/submit-api":{"post":{"tags":["Forms"],"summary":"------------------------------------------","operationId":"postApiFormsByidSubmitApi","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/free-tier":{"get":{"tags":["Free tier"],"summary":"Also expose free tier info in the public pricing endpoint","operationId":"getApiFreeTier","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions":{"get":{"tags":["Functions"],"summary":"============================================","operationId":"getApiFunctions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Functions"],"summary":"Create functions","operationId":"postApiFunctions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/triggers/{triggerId}":{"put":{"tags":["Functions"],"summary":"Update trigger","operationId":"putApiFunctionsTriggersBytriggerid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Functions"],"summary":"Delete trigger","operationId":"deleteApiFunctionsTriggersBytriggerid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/webhooks/{triggerId}":{"post":{"tags":["Functions"],"summary":"ambiguous.","operationId":"postApiFunctionsWebhooksBytriggerid","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}":{"get":{"tags":["Functions"],"summary":"Get function","operationId":"getApiFunctionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Functions"],"summary":"Update function","operationId":"putApiFunctionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Functions"],"summary":"Delete function","operationId":"deleteApiFunctionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/external-credentials":{"get":{"tags":["Functions"],"summary":"our own API host and getting a 401 with nothing to reject.","operationId":"getApiFunctionsByidExternalCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Functions"],"summary":"Create external credentials","operationId":"postApiFunctionsByidExternalCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/external-credentials/{credentialId}":{"delete":{"tags":["Functions"],"summary":"Delete external credential","operationId":"deleteApiFunctionsByidExternalCredentialsBycredentialid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/external-hosts":{"get":{"tags":["Functions"],"summary":"============================================","operationId":"getApiFunctionsByidExternalHosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Functions"],"summary":"Create external hosts","operationId":"postApiFunctionsByidExternalHosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/external-hosts/{hostId}":{"delete":{"tags":["Functions"],"summary":"Delete external host","operationId":"deleteApiFunctionsByidExternalHostsByhostid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"hostId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/invocations":{"get":{"tags":["Functions"],"summary":"List invocations","operationId":"getApiFunctionsByidInvocations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/invocations/{invocationId}":{"get":{"tags":["Functions"],"summary":"literal id segment is not swallowed by the collection handler.","operationId":"getApiFunctionsByidInvocationsByinvocationid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"invocationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/triggers":{"get":{"tags":["Functions"],"summary":"============================================","operationId":"getApiFunctionsByidTriggers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Functions"],"summary":"Create triggers","operationId":"postApiFunctionsByidTriggers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{id}/versions":{"post":{"tags":["Functions"],"summary":"Create versions","operationId":"postApiFunctionsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Functions"],"summary":"List versions","operationId":"getApiFunctionsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/functions/{slug}/invoke":{"post":{"tags":["Functions"],"summary":"(#407). If invocation volume grows before then, that is the thing to add.","operationId":"postApiFunctionsByslugInvoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/edge-rules/{ruleId}":{"get":{"tags":["Gateway"],"summary":"Get single rule","operationId":"getApiGatewayEdgeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Gateway"],"summary":"Update rule","operationId":"putApiGatewayEdgeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Gateway"],"summary":"Delete rule","operationId":"deleteApiGatewayEdgeRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/logs":{"get":{"tags":["Gateway"],"summary":"============================================","operationId":"getApiGatewayLogs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/routes/{id}":{"get":{"tags":["Gateway"],"summary":"Get route","operationId":"getApiGatewayRoutesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Gateway"],"summary":"Update route","operationId":"putApiGatewayRoutesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Gateway"],"summary":"Delete route","operationId":"deleteApiGatewayRoutesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/routes/{id}/analytics":{"get":{"tags":["Gateway"],"summary":"Route analytics","operationId":"getApiGatewayRoutesByidAnalytics","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/routes/{routeId}/rules":{"get":{"tags":["Gateway"],"summary":"List rules for a route","operationId":"getApiGatewayRoutesByrouteidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Gateway"],"summary":"Create rule for a route","operationId":"postApiGatewayRoutesByrouteidRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/routes/{routeId}/rules/evaluate":{"post":{"tags":["Gateway"],"summary":"Evaluate rules (dry-run)","operationId":"postApiGatewayRoutesByrouteidRulesEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"routeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/upstreams":{"get":{"tags":["Gateway"],"summary":"============================================","operationId":"getApiGatewayUpstreams","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Gateway"],"summary":"Create upstreams","operationId":"postApiGatewayUpstreams","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/upstreams/{id}":{"get":{"tags":["Gateway"],"summary":"Get upstream","operationId":"getApiGatewayUpstreamsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Gateway"],"summary":"Update upstream","operationId":"putApiGatewayUpstreamsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Gateway"],"summary":"Delete upstream","operationId":"deleteApiGatewayUpstreamsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/upstreams/{id}/analytics":{"get":{"tags":["Gateway"],"summary":"Upstream analytics","operationId":"getApiGatewayUpstreamsByidAnalytics","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/upstreams/{id}/health-check":{"post":{"tags":["Gateway"],"summary":"Health check","operationId":"postApiGatewayUpstreamsByidHealthCheck","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gateway/upstreams/{upstreamId}/routes":{"get":{"tags":["Gateway"],"summary":"============================================","operationId":"getApiGatewayUpstreamsByupstreamidRoutes","security":[],"parameters":[{"name":"upstreamId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Gateway"],"summary":"Create routes","operationId":"postApiGatewayUpstreamsByupstreamidRoutes","security":[],"parameters":[{"name":"upstreamId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/geofences":{"post":{"tags":["Geofences"],"summary":"------------------------------------------------------------------","operationId":"postApiGeofences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Geofences"],"summary":"List geofences","operationId":"getApiGeofences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/geofences/{id}":{"get":{"tags":["Geofences"],"summary":"Get geofence","operationId":"getApiGeofencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Geofences"],"summary":"Update geofence","operationId":"putApiGeofencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Geofences"],"summary":"Delete geofence","operationId":"deleteApiGeofencesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql":{"post":{"tags":["GraphQL"],"summary":"--- Query Execution ---","operationId":"postApiGraphql","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/introspection":{"get":{"tags":["GraphQL"],"summary":"List introspection","operationId":"getApiGraphqlIntrospection","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/persisted-queries":{"post":{"tags":["GraphQL"],"summary":"--- Persisted Queries ---","operationId":"postApiGraphqlPersistedQueries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["GraphQL"],"summary":"List persisted queries","operationId":"getApiGraphqlPersistedQueries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/persisted-queries/{id}":{"get":{"tags":["GraphQL"],"summary":"Get persisted querie","operationId":"getApiGraphqlPersistedQueriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["GraphQL"],"summary":"Delete persisted querie","operationId":"deleteApiGraphqlPersistedQueriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/persisted-queries/{id}/execute":{"post":{"tags":["GraphQL"],"summary":"Create execute","operationId":"postApiGraphqlPersistedQueriesByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/playground":{"get":{"tags":["GraphQL"],"summary":"--- Playground ---","operationId":"getApiGraphqlPlayground","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/schema":{"get":{"tags":["GraphQL"],"summary":"--- Schema & Introspection ---","operationId":"getApiGraphqlSchema","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/subscriptions":{"post":{"tags":["GraphQL"],"summary":"Subscribe to data changes","operationId":"postApiGraphqlSubscriptions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["GraphQL"],"summary":"List active subscriptions","operationId":"getApiGraphqlSubscriptions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/graphql/subscriptions/{id}":{"delete":{"tags":["GraphQL"],"summary":"Unsubscribe","operationId":"deleteApiGraphqlSubscriptionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gravity-wells":{"post":{"tags":["Gravity wells"],"summary":"Create gravity wells","operationId":"postApiGravityWells","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Gravity wells"],"summary":"List gravity wells","operationId":"getApiGravityWells","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gravity-wells/{id}":{"get":{"tags":["Gravity wells"],"summary":"Main resource routes AFTER sub-resource routes","operationId":"getApiGravityWellsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Gravity wells"],"summary":"Update gravity well","operationId":"putApiGravityWellsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Gravity wells"],"summary":"Delete gravity well","operationId":"deleteApiGravityWellsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gravity-wells/{id}/evaluate":{"post":{"tags":["Gravity wells"],"summary":"Sub-resource routes BEFORE /@id","operationId":"postApiGravityWellsByidEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/gravity-wells/{id}/records":{"get":{"tags":["Gravity wells"],"summary":"List records","operationId":"getApiGravityWellsByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups":{"get":{"tags":["Groups"],"summary":"List all groups","operationId":"getApiGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Groups"],"summary":"Create new group","operationId":"postApiGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{groupId}/access/{email}":{"delete":{"tags":["Groups"],"summary":"Revoke group access","operationId":"deleteApiGroupsBygroupidAccessByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{groupId}/members/{email}":{"delete":{"tags":["Groups"],"summary":"Remove member from group","operationId":"deleteApiGroupsBygroupidMembersByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Groups"],"summary":"Update member permissions","operationId":"putApiGroupsBygroupidMembersByemail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"email","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}":{"get":{"tags":["Groups"],"summary":"Get single group","operationId":"getApiGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Groups"],"summary":"Update group","operationId":"putApiGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Groups"],"summary":"Delete group","operationId":"deleteApiGroupsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/access":{"post":{"tags":["Groups"],"summary":"Share group access with another user","operationId":"postApiGroupsByidAccess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/copy":{"post":{"tags":["Groups"],"summary":"Copy a group","operationId":"postApiGroupsByidCopy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/derive":{"post":{"tags":["Groups"],"summary":"Derive a group (create child that inherits members)","operationId":"postApiGroupsByidDerive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/effective-members":{"get":{"tags":["Groups"],"summary":"Get effective members (including inherited)","operationId":"getApiGroupsByidEffectiveMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/inheritance":{"get":{"tags":["Groups"],"summary":"Get inheritance chain","operationId":"getApiGroupsByidInheritance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/groups/{id}/members":{"post":{"tags":["Groups"],"summary":"Add member(s) to group","operationId":"postApiGroupsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/health/dashboard":{"get":{"tags":["Health"],"summary":"List dashboard","operationId":"getApiHealthDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots":{"post":{"tags":["Honeypots"],"summary":"============================================","operationId":"postApiHoneypots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Honeypots"],"summary":"List honeypots","operationId":"getApiHoneypots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots/{id}":{"get":{"tags":["Honeypots"],"summary":"Get honeypot","operationId":"getApiHoneypotsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Honeypots"],"summary":"Update honeypot","operationId":"putApiHoneypotsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Honeypots"],"summary":"Delete honeypot","operationId":"deleteApiHoneypotsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots/{id}/log":{"get":{"tags":["Honeypots"],"summary":"List log","operationId":"getApiHoneypotsByidLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots/{id}/regenerate":{"post":{"tags":["Honeypots"],"summary":"Create regenerate","operationId":"postApiHoneypotsByidRegenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots/{id}/stats":{"get":{"tags":["Honeypots"],"summary":"List stats","operationId":"getApiHoneypotsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/honeypots/{id}/toggle":{"post":{"tags":["Honeypots"],"summary":"Create toggle","operationId":"postApiHoneypotsByidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/hooks/{slug}":{"post":{"tags":["Hooks"],"summary":"Public webhook receive endpoint (NO auth required!)","operationId":"postApiHooksByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/import-templates":{"post":{"tags":["Import templates"],"summary":"Import Mapping Templates \u2014 reusable field mapping configs for CSV imports","operationId":"postApiImportTemplates","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Import templates"],"summary":"List import templates","operationId":"getApiImportTemplates","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/import-templates/{id}":{"get":{"tags":["Import templates"],"summary":"Get import template","operationId":"getApiImportTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Import templates"],"summary":"Update import template","operationId":"putApiImportTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Import templates"],"summary":"Delete import template","operationId":"deleteApiImportTemplatesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/deliveries/{deliveryId}":{"get":{"tags":["Inbound webhooks"],"summary":"Get deliverie","operationId":"getApiInboundWebhooksDeliveriesBydeliveryid","security":[],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/deliveries/{deliveryId}/replay":{"post":{"tags":["Inbound webhooks"],"summary":"Create replay","operationId":"postApiInboundWebhooksDeliveriesBydeliveryidReplay","security":[],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/receivers":{"get":{"tags":["Inbound webhooks"],"summary":"Receiver CRUD (authenticated)","operationId":"getApiInboundWebhooksReceivers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Inbound webhooks"],"summary":"Create receivers","operationId":"postApiInboundWebhooksReceivers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/receivers/{id}":{"get":{"tags":["Inbound webhooks"],"summary":"Get receiver","operationId":"getApiInboundWebhooksReceiversByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Inbound webhooks"],"summary":"Update receiver","operationId":"putApiInboundWebhooksReceiversByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Inbound webhooks"],"summary":"Delete receiver","operationId":"deleteApiInboundWebhooksReceiversByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/receivers/{id}/test":{"post":{"tags":["Inbound webhooks"],"summary":"Test webhook (authenticated)","operationId":"postApiInboundWebhooksReceiversByidTest","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/receivers/{receiverId}/deliveries":{"get":{"tags":["Inbound webhooks"],"summary":"Deliveries (authenticated)","operationId":"getApiInboundWebhooksReceiversByreceiveridDeliveries","security":[],"parameters":[{"name":"receiverId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/inbound-webhooks/transforms":{"get":{"tags":["Inbound webhooks"],"summary":"Reference: list available transforms","operationId":"getApiInboundWebhooksTransforms","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/jobs":{"get":{"tags":["Job Queue"],"summary":"List jobs for authenticated user","operationId":"getApiJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/jobs/{id}":{"get":{"tags":["Job Queue"],"summary":"Get job status","operationId":"getApiJobsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Job Queue"],"summary":"Cancel a pending job","operationId":"deleteApiJobsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/jobs/{id}/result":{"get":{"tags":["Job Queue"],"summary":"Download job result (for export jobs)","operationId":"getApiJobsByidResult","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/audit":{"get":{"tags":["Key vault"],"summary":"Vault access log","description":"Every vault operation, successful or not. Each row carries `vault_id` and `vault_name`; both are null for a vault that has since been deleted.","operationId":"getApiKeyVaultAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults":{"post":{"tags":["Key vault"],"summary":"Create a vault","description":"Create a password-protected vault. The vault password is never stored \u2014 it derives an encryption key via Argon2id. It cannot be recovered; the recovery codes returned here are the only way back in, and they are shown exactly once.","operationId":"postApiKeyVaultVaults","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Display name for the vault"},"vault_password":{"type":"string","description":"Separate from your login password. Never stored, and not recoverable."},"description":{"type":"string","nullable":true},"generate_recovery_codes":{"type":"boolean","description":"Ten single-use codes, returned once at creation","default":true}},"required":["name","vault_password"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Key vault"],"summary":"List user's vaults","operationId":"getApiKeyVaultVaults","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}":{"delete":{"tags":["Key vault"],"summary":"Delete a vault","description":"Requires the vault password, which is genuinely verified. Deletes the vault and every sealed secret in it. Irreversible.","operationId":"deleteApiKeyVaultVaultsByvaultid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Key vault"],"summary":"Get vault details","operationId":"getApiKeyVaultVaultsByvaultid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/change-password":{"post":{"tags":["Key vault"],"summary":"Change a vault password","description":"Re-encrypts every stored key under a key derived from the new password, and invalidates the old recovery codes in favour of fresh ones.","operationId":"postApiKeyVaultVaultsByvaultidChangePassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"current_password":{"type":"string"},"new_password":{"type":"string"}},"required":["current_password","new_password"]}}}},"responses":{"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many failed credential attempts. Carries `retry_after_seconds`, `retry_at`, `error_code: vault_locked_out`, and a standard `Retry-After` header. The counter is scoped to the USER, not the vault: failures on your other vaults count towards it, and a key lookup that simply misses does not."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/keys":{"post":{"tags":["Key vault"],"summary":"Back up an encryption key into a vault","description":"THIS MODE CANNOT STORE AN ARBITRARY SECRET. `key_id` must name an encryption key you already own and have not revoked \u2014 one created via `POST /api/encryption/keys`. If it does not resolve, the call fails with \"Encryption key not found or not owned by you\".\n\nIf what you have is a passphrase, a private key the platform does not model, or any other blob, use the sealed-secret endpoints instead.","operationId":"postApiKeyVaultVaultsByvaultidKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vault_password":{"type":"string"},"key_id":{"type":"string","description":"key_id of an EXISTING, non-revoked encryption key you own"},"encryption_key":{"type":"string","description":"The key material itself, which is re-encrypted under the vault password"},"blind_index_key":{"type":"string"},"metadata":{"type":"object","description":"Optional caller metadata stored beside the key"}},"required":["vault_password","key_id","encryption_key","blind_index_key"]}}}},"responses":{"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many failed credential attempts. Carries `retry_after_seconds`, `retry_at`, `error_code: vault_locked_out`, and a standard `Retry-After` header. The counter is scoped to the USER, not the vault: failures on your other vaults count towards it, and a key lookup that simply misses does not."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/keys/{keyId}":{"delete":{"tags":["Key vault"],"summary":"Remove a key from a vault","description":"Removes the vault copy only. The encryption key record itself is untouched.","operationId":"deleteApiKeyVaultVaultsByvaultidKeysBykeyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"},"description":"The key_id of an encryption key you own"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/keys/{keyId}/retrieve":{"post":{"tags":["Key vault"],"summary":"Retrieve a backed-up encryption key","description":"Asking for a key that is not in the vault returns a plain \"not found\" and does NOT count towards the failed-attempt lockout \u2014 checking whether material exists before writing it is expected.","operationId":"postApiKeyVaultVaultsByvaultidKeysBykeyidRetrieve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string"},"description":"The key_id of an encryption key you own"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vault_password":{"type":"string"}},"required":["vault_password"]}}}},"responses":{"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many failed credential attempts. Carries `retry_after_seconds`, `retry_at`, `error_code: vault_locked_out`, and a standard `Retry-After` header. The counter is scoped to the USER, not the vault: failures on your other vaults count towards it, and a key lookup that simply misses does not."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/recover":{"post":{"tags":["Key vault"],"summary":"Reset a vault password with a recovery code","description":"Each code is single-use. Stored keys are cleared as part of the reset, because the old ones can no longer be decrypted.","operationId":"postApiKeyVaultVaultsByvaultidRecover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recovery_code":{"type":"string"},"new_password":{"type":"string"}},"required":["recovery_code","new_password"]}}}},"responses":{"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many failed credential attempts. Carries `retry_after_seconds`, `retry_at`, `error_code: vault_locked_out`, and a standard `Retry-After` header. The counter is scoped to the USER, not the vault: failures on your other vaults count towards it, and a key lookup that simply misses does not."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/sealed":{"get":{"tags":["Key vault \u2014 sealed secrets"],"summary":"List sealed secrets (metadata only), searchable by open metadata","description":"Never returns ciphertext \u2014 neither the secret's nor the sealed metadata's \u2014 so checking whether material exists does not require downloading it. Each row carries `secret_ref`, `content_type`, `byte_size`, `open_metadata`, `has_sealed_metadata`, `created_at`, `updated_at`.\n\nSearch by open metadata: every label given must be present with that value (labels narrow, they do not widen). Values compare correctly whether stored as a string, a number or a boolean, so `match[port]=5432` finds `{\"port\": 5432}`. A `match` that cannot be parsed is a 400, NOT an unfiltered list \u2014 answering a search with everything is how a caller concludes a secret is missing when it is not. Sealed metadata is not searchable and will not become searchable: filtering on it would mean we could read it.","operationId":"getApiKeyVaultVaultsByvaultidSealed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"match","in":"query","required":false,"schema":{"type":"string"},"description":"Open-metadata labels to require, as repeated `match[key]=value` parameters or one url-encoded JSON object."},{"name":"ref_prefix","in":"query","required":false,"schema":{"type":"string"},"description":"Only secrets whose `secret_ref` starts with this. A `%` is a literal, not a wildcard."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/sealed/{secretRef}":{"put":{"tags":["Key vault \u2014 sealed secrets"],"summary":"Store or replace a sealed secret","description":"Stores an opaque blob you encrypted yourself, plus the derivation parameters needed to open it again. Both are returned unchanged on read.\n\nTWO KINDS OF METADATA, and they are NOT interchangeable. `open_metadata` is stored in PLAINTEXT on our side and is indexed so it can be searched \u2014 put labels there (host, env, purpose) and never a secret. `sealed_metadata_b64` is a SECOND ciphertext under the same passphrase and the same `kdf` as the secret, opaque to us \u2014 put there the things that would themselves be a leak. There is one `kdf` per secret, not two: each ciphertext carries its own nonce, which is your format and not ours. Sealed mode takes NO vault password, deliberately: the server holds nothing it could verify one against. Access is ownership of the vault; the secrecy is your client-side encryption. Because there is no password check, the failed-attempt lockout does not apply here at all.\n\nAnyone holding an API credential for this account can fetch the ciphertext. That is harmless without your passphrase \u2014 which is exactly why the two must not live in the same place. Keep a sealed vault under a different account from the credential whose data it protects.","operationId":"putApiKeyVaultVaultsByvaultidSealedBysecretref","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"secretRef","in":"path","required":true,"schema":{"type":"string"},"description":"Your own name for the sealed secret"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ciphertext_b64":{"type":"string","description":"Base64 of your ciphertext. Must be valid base64. Capped at 64 KiB \u2014 this is a key store, not a file store."},"kdf":{"type":"object","description":"Derivation parameters, stored verbatim and handed back unchanged. `alg` and `salt` are required; cost parameters are kept as given. We never see the plaintext and do not judge how hard it should be to derive.","properties":{"alg":{"type":"string","example":"argon2id"},"salt":{"type":"string","description":"base64"},"m_cost":{"type":"integer"},"t_cost":{"type":"integer"},"p_cost":{"type":"integer"}}},"content_type":{"type":"string","description":"Optional caller hint. Opaque \u2014 never branched on.","nullable":true},"open_metadata":{"type":"object","description":"PLAINTEXT, server-readable, searchable labels. Flat object of strings/numbers/booleans \u2014 a nested value is REFUSED, because the search cannot match one and a label you can never find again is worse than a refusal. At most 40 keys, 64-character keys, 512-character string values, 4 KB encoded. Never put a secret here.","nullable":true},"sealed_metadata_b64":{"type":"string","description":"Base64 of a second ciphertext, encrypted client-side under the SAME passphrase and `kdf` as the secret. Opaque to us and not searchable. Shares the 64 KiB cap.","nullable":true}},"required":["ciphertext_b64","kdf"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Key vault \u2014 sealed secrets"],"summary":"Read a sealed secret back","description":"Returns exactly what was stored: `ciphertext_b64`, `kdf`, `content_type`, `byte_size`, `open_metadata`, `sealed_metadata_b64`. No decryption happens server-side, because there is nothing to decrypt it with \u2014 the sealed metadata comes back as ciphertext just like the secret. Sealed mode takes NO vault password, deliberately: the server holds nothing it could verify one against. Access is ownership of the vault; the secrecy is your client-side encryption. Because there is no password check, the failed-attempt lockout does not apply here at all.\n\nAnyone holding an API credential for this account can fetch the ciphertext. That is harmless without your passphrase \u2014 which is exactly why the two must not live in the same place. Keep a sealed vault under a different account from the credential whose data it protects.","operationId":"getApiKeyVaultVaultsByvaultidSealedBysecretref","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"secretRef","in":"path","required":true,"schema":{"type":"string"},"description":"Your own name for the sealed secret"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Key vault \u2014 sealed secrets"],"summary":"Remove a sealed secret","description":"Irreversible. We cannot help you recover it; that is the point of the mode.","operationId":"deleteApiKeyVaultVaultsByvaultidSealedBysecretref","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"secretRef","in":"path","required":true,"schema":{"type":"string"},"description":"Your own name for the sealed secret"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/sealed/{secretRef}/metadata":{"patch":{"tags":["Key vault \u2014 sealed secrets"],"summary":"Re-label a sealed secret without re-sealing it","description":"Changes metadata only. The secret, its `kdf` and its `byte_size` are untouched \u2014 which is the reason sealed metadata is a separate ciphertext rather than something to bundle into the secret's own blob: correcting a label must not require decrypting and rewriting key material.\n\nSend either field or both. A field you omit is left alone; `sealed_metadata_b64: \"\"` clears it. A request naming neither is refused rather than recorded as a change. `open_metadata` is REPLACED, not merged \u2014 to drop one label, send the set you want without it. The response is the row read back, including the half you did not touch. Sealed mode takes NO vault password, deliberately: the server holds nothing it could verify one against. Access is ownership of the vault; the secrecy is your client-side encryption. Because there is no password check, the failed-attempt lockout does not apply here at all.\n\nAnyone holding an API credential for this account can fetch the ciphertext. That is harmless without your passphrase \u2014 which is exactly why the two must not live in the same place. Keep a sealed vault under a different account from the credential whose data it protects.","operationId":"patchApiKeyVaultVaultsByvaultidSealedBysecretrefMetadata","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}},{"name":"secretRef","in":"path","required":true,"schema":{"type":"string"},"description":"Your own name for the sealed secret"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"open_metadata":{"type":"object","description":"Replacement plaintext labels. Same shape and limits as on the PUT.","nullable":true},"sealed_metadata_b64":{"type":"string","description":"Replacement sealed blob, or an empty string to clear it.","nullable":true}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/key-vault/vaults/{vaultId}/verify":{"post":{"tags":["Key vault"],"summary":"Verify a vault password","operationId":"postApiKeyVaultVaultsByvaultidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"vaultId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"vault_password":{"type":"string"}},"required":["vault_password"]}}}},"responses":{"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too many failed credential attempts. Carries `retry_after_seconds`, `retry_at`, `error_code: vault_locked_out`, and a standard `Retry-After` header. The counter is scoped to the USER, not the vault: failures on your other vaults count towards it, and a key lookup that simply misses does not."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards":{"post":{"tags":["Leaderboards"],"summary":"--- Leaderboard CRUD ---","operationId":"postApiLeaderboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Leaderboards"],"summary":"List leaderboards","operationId":"getApiLeaderboards","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}":{"get":{"tags":["Leaderboards"],"summary":"Get leaderboard","operationId":"getApiLeaderboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Leaderboards"],"summary":"Update leaderboard","operationId":"putApiLeaderboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Leaderboards"],"summary":"Delete leaderboard","operationId":"deleteApiLeaderboardsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/rankings":{"get":{"tags":["Leaderboards"],"summary":"--- Rankings ---","operationId":"getApiLeaderboardsByidRankings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/rankings/{entityId}":{"get":{"tags":["Leaderboards"],"summary":"Get ranking","operationId":"getApiLeaderboardsByidRankingsByentityid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/rankings/{entityId}/around":{"get":{"tags":["Leaderboards"],"summary":"List around","operationId":"getApiLeaderboardsByidRankingsByentityidAround","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/reset":{"post":{"tags":["Leaderboards"],"summary":"--- Reset ---","operationId":"postApiLeaderboardsByidReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/score-log":{"get":{"tags":["Leaderboards"],"summary":"--- Score Log ---","operationId":"getApiLeaderboardsByidScoreLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/scores":{"post":{"tags":["Leaderboards"],"summary":"--- Scores ---","operationId":"postApiLeaderboardsByidScores","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/snapshots":{"post":{"tags":["Leaderboards"],"summary":"--- Snapshots ---","operationId":"postApiLeaderboardsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Leaderboards"],"summary":"List snapshots","operationId":"getApiLeaderboardsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/leaderboards/{id}/stats":{"get":{"tags":["Leaderboards"],"summary":"--- Stats ---","operationId":"getApiLeaderboardsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/audit":{"get":{"tags":["Licensing"],"summary":"Audit trail across your products","description":"Includes product-level events (key rotation, product changes). Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"product_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"event","in":"query","required":false,"schema":{"type":"string"},"description":"One event name, e.g. `activation.created`"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100},"description":"1-500"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Audit rows (adds license_id, product_id)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}}}}}}},"400":{"description":"Invalid event filter","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/activate":{"post":{"tags":["Licensing"],"summary":"Activate this machine (node-locked)","description":"Binds the fingerprint to the license (one seat; idempotent for the same machine) and returns a signed node document valid 7 days (or until the license expires). Floating licenses are refused with `use_lease`. No authentication: the license key is the credential.","operationId":"postApiLicensingClientActivate","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"},"machine_fingerprint":{"type":"string","description":"128 chars max; SDK v2 fingerprint"},"machine_name":{"type":"string"},"os":{"type":"string"},"hostname":{"type":"string"},"client_version":{"type":"string"},"challenge":{"type":"string","description":"Optional, 1-64 chars `[A-Za-z0-9_-]`; echoed as `chal` inside the signed document"},"product":{"type":"string","description":"Optional product slug or id; a key for another product is refused with `wrong_product`"}},"required":["license_key","machine_fingerprint"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `license`, `signed_license` (mode \"node\"). On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"license":{"type":"object","description":"Display copy only; trust the signed_license","properties":{"license_key":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"is_trial":{"type":"boolean"},"is_floating":{"type":"boolean"},"seat_count":{"type":"integer"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"features":{"type":"object"}}},"signed_license":{"type":"string","description":"`v1.<base64url(payload)>.<base64url(Ed25519 signature)>`; verify with the SDK before trusting anything"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/branding/{slug}":{"get":{"tags":["Licensing"],"summary":"Product branding and key set (client)","description":"What the software shows when unlicensed, plus the public key set. 404 unless the product is active. No authentication: the license key is the credential.","operationId":"getApiLicensingClientBrandingByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Licensing product slug (globally unique)"}],"responses":{"200":{"description":"Branding","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"product":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"white_label":{"type":"object","description":"Unlicensed-screen branding","properties":{"product_name":{"type":"string"},"company_name":{"type":"string"},"logo_url":{"type":"string","description":"https:// only"},"accent_color":{"type":"string","description":"#RRGGBB"},"support_email":{"type":"string"},"support_url":{"type":"string"},"purchase_url":{"type":"string"},"unlicensed_title":{"type":"string"},"unlicensed_message":{"type":"string"},"trial_message":{"type":"string"},"show_trial_countdown":{"type":"boolean"}}},"public_key":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"keyset":{"type":"string","description":"`kid:key;kid:key`, active first"},"blob_version":{"type":"string","example":"v1"},"contract_version":{"type":"string","example":"1.2"}}}}}}}},"404":{"description":"Unknown or inactive product"},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/deactivate":{"post":{"tags":["Licensing"],"summary":"Free this machine","description":"Counts toward the product's daily deactivation limit (refusal `rate_limited` on HTTP 200 when used up). No authentication: the license key is the credential.","operationId":"postApiLicensingClientDeactivate","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"},"machine_fingerprint":{"type":"string"}},"required":["license_key","machine_fingerprint"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `seats_available`. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"seats_available":{"type":"integer"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/keys/{slug}":{"get":{"tags":["Licensing"],"summary":"Published public key set (client)","description":"For your BUILD pipeline: compile the key set into the application, never fetch it at run time. Served for active and archived products. `Cache-Control: public, max-age=300`. No authentication: the license key is the credential.","operationId":"getApiLicensingClientKeysByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Licensing product slug (globally unique)"}],"responses":{"200":{"description":"Key set","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"product_slug":{"type":"string"},"algorithm":{"type":"string","example":"ed25519"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"keyset":{"type":"string"},"contract_version":{"type":"string"}}}}}}}},"404":{"description":"Unknown product"},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/lease/checkout":{"post":{"tags":["Licensing"],"summary":"Check out a floating lease","description":"Floating licenses only (others: `invalid_request`). Lease lasts 900 s; heartbeat ~every 300 s. A machine that already holds a lease gets it renewed (`renewed: true`). A full pool is `lease_limit` with `in_use` and `cap`. No authentication: the license key is the credential.","operationId":"postApiLicensingClientLeaseCheckout","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"},"machine_fingerprint":{"type":"string"},"machine_name":{"type":"string"},"user_name":{"type":"string"},"challenge":{"type":"string","description":"Optional, 1-64 chars `[A-Za-z0-9_-]`; echoed as `chal` inside the signed document"},"product":{"type":"string","description":"Optional product slug or id; a key for another product is refused with `wrong_product`"}},"required":["license_key","machine_fingerprint"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: lease fields and `signed_license` (mode \"lease\"). On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"lease_token":{"type":"string"},"lease_id":{"type":"string"},"expires_in":{"type":"integer","example":900},"renewed":{"type":"boolean"},"signed_license":{"type":"string","description":"`v1.<base64url(payload)>.<base64url(Ed25519 signature)>`; verify with the SDK before trusting anything"},"in_use":{"type":"integer"},"cap":{"type":"integer"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/lease/heartbeat":{"post":{"tags":["Licensing"],"summary":"Extend a floating lease","description":"Re-checks the license every time and returns a FRESH lease document with the extended expiry. A dead lease or unusable license is `lease_lost` (with `license_reason` when the license is the cause). No authentication: the license key is the credential.","operationId":"postApiLicensingClientLeaseHeartbeat","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lease_token":{"type":"string"},"challenge":{"type":"string","description":"Optional, 1-64 chars `[A-Za-z0-9_-]`; echoed as `chal` inside the signed document"}},"required":["lease_token"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `expires_in`, `signed_license`. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"expires_in":{"type":"integer"},"signed_license":{"type":"string","description":"`v1.<base64url(payload)>.<base64url(Ed25519 signature)>`; verify with the SDK before trusting anything"},"license_reason":{"type":"string"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/lease/release":{"post":{"tags":["Licensing"],"summary":"Release a floating lease","description":"Frees the seat immediately. Already released or expired: `lease_lost`. No authentication: the license key is the credential.","operationId":"postApiLicensingClientLeaseRelease","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lease_token":{"type":"string"}},"required":["lease_token"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `{success:true}`. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/machines":{"post":{"tags":["Licensing"],"summary":"List a license's machines (customer self-service)","description":"Fingerprints are shown as an 8-character prefix only. No authentication: the license key is the credential.","operationId":"postApiLicensingClientMachines","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"}},"required":["license_key"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: seat usage and machines. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"machines":{"type":"array","items":{"type":"object","properties":{"activation_id":{"type":"string"},"label":{"type":"string"},"os":{"type":"string","nullable":true},"type":{"type":"string"},"fingerprint_prefix":{"type":"string"},"first_seen_at":{"type":"string"},"last_seen_at":{"type":"string","nullable":true}}}},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/machines/remove":{"post":{"tags":["Licensing"],"summary":"Free a machine (customer self-service)","description":"Counts toward the product's daily deactivation limit. No authentication: the license key is the credential.","operationId":"postApiLicensingClientMachinesRemove","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"},"activation_id":{"type":"string","format":"uuid"}},"required":["license_key","activation_id"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `seats_available`. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"seats_available":{"type":"integer"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/client/validate":{"post":{"tags":["Licensing"],"summary":"Re-validate this machine","description":"Returns a fresh node document; this is how revocation, suspension and license changes reach the machine. Floating licenses are refused with `use_lease`. No authentication: the license key is the credential.","operationId":"postApiLicensingClientValidate","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"license_key":{"type":"string"},"machine_fingerprint":{"type":"string"},"challenge":{"type":"string","description":"Optional, 1-64 chars `[A-Za-z0-9_-]`; echoed as `chal` inside the signed document"},"product":{"type":"string","description":"Optional product slug or id; a key for another product is refused with `wrong_product`"}},"required":["license_key","machine_fingerprint"]}}}},"responses":{"200":{"description":"HTTP 200 for success AND for a refusal \u2014 read `success`. Success: `license`, `signed_license`. On refusal: `{success:false, reason, message}`.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"license":{"type":"object","description":"Display copy only; trust the signed_license","properties":{"license_key":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"is_trial":{"type":"boolean"},"is_floating":{"type":"boolean"},"seat_count":{"type":"integer"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"features":{"type":"object"}}},"signed_license":{"type":"string","description":"`v1.<base64url(payload)>.<base64url(Ed25519 signature)>`; verify with the SDK before trusting anything"},"reason":{"type":"string","enum":["not_found","wrong_product","invalid_request","revoked","suspended","expired","use_lease","seat_limit","not_activated","lease_limit","lease_lost","rate_limited","replayed","trial_used"],"description":"Present on refusal"},"message":{"type":"string","description":"Present on refusal"}}}}}},"429":{"description":"Rate limited per address or per license key. Honour `Retry-After`. Per-key refusals carry top-level `reason: \"rate_limited\"`."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses":{"get":{"tags":["Licensing"],"summary":"List licenses across your products","description":"Paginated. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingLicenses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"product_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","suspended","revoked","expired"]}},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Customer name, email, reference or license key (substring, case-insensitive)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50},"description":"1-200"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Licenses","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}}}}}}},"400":{"description":"Unknown status filter","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}":{"get":{"tags":["Licensing"],"summary":"Get a license","description":"Includes the first 100 `activations`, `activations_total`, and active `leases`. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingLicensesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"License","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Licensing"],"summary":"Edit, extend, suspend or unsuspend a license","description":"Changes only what is sent; re-signs the stored copy and audits the change. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"patchApiLicensingLicensesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expires_at":{"type":"string","description":"null only for perpetual","nullable":true},"extend_days":{"type":"integer","description":"1-36500, added to the later of now and the current expiry; reactivates an expired license"},"seat_count":{"type":"integer"},"max_concurrent":{"type":"integer","description":"Floating only","nullable":true},"features":{"type":"object"},"updates_until":{"type":"string","nullable":true},"status":{"type":"string","enum":["suspended","active"]},"reason":{"type":"string","description":"Required with status=suspended"},"customer_name":{"type":"string"},"customer_email":{"type":"string"},"customer_reference":{"type":"string"},"notes":{"type":"string"}}}}}},"responses":{"200":{"description":"Updated license","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"409":{"description":"Change not allowed (revoked license; expired license set active instead of extended)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}/activations":{"get":{"tags":["Licensing"],"summary":"List a license's machines","description":"Active machines first. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingLicensesByidActivations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"`active`, or any other value for deactivated machines"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50},"description":"1-500"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Activations","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"machine_fingerprint":{"type":"string"},"machine_name":{"type":"string","nullable":true},"os":{"type":"string","nullable":true},"hostname":{"type":"string","nullable":true},"activation_type":{"type":"string","enum":["online","offline"]},"status":{"type":"string"},"client_version":{"type":"string","nullable":true},"ip_address":{"type":"string","nullable":true},"activated_at":{"type":"string"},"last_seen_at":{"type":"string","nullable":true},"deactivated_at":{"type":"string","nullable":true},"deactivated_by":{"type":"string","nullable":true}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}/audit":{"get":{"tags":["Licensing"],"summary":"A license's audit trail","description":"Newest first. High-volume events (validate, heartbeat, update check) are recorded at most once per machine per hour. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingLicensesByidAudit","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100},"description":"1-500"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Audit rows `{id, event, actor, machine_fingerprint, ip_address, detail, created_at}`","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}/deactivate-machine":{"post":{"tags":["Licensing"],"summary":"Free a machine (vendor)","description":"Never subject to the customer deactivation limit. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingLicensesByidDeactivateMachine","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"machine_fingerprint":{"type":"string","description":"This or activation_id is required"},"activation_id":{"type":"string","format":"uuid"}}}}}},"responses":{"200":{"description":"`{success, data:{success, seats_available}, seats_available}`"},"400":{"description":"Neither field sent","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"License not found, or that machine holds no seat (`reason: not_activated`)"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}/revoke":{"post":{"tags":["Licensing"],"summary":"Revoke a license","description":"Permanent. Releases all active leases immediately. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingLicensesByidRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}}}},"responses":{"200":{"description":"Revoked license","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}}}}}},"400":{"description":"reason missing","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/licenses/{id}/send":{"post":{"tags":["Licensing"],"summary":"Email the license key","description":"At most 10 sends per license per hour; a revoked license cannot be sent. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:issue` scope.","operationId":"postApiLicensingLicensesByidSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","description":"Recipient; default customer_email. `email` is accepted as an alias"},"message":{"type":"string","description":"Note added to the email"}}}}}},"responses":{"200":{"description":"Sent","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}}}}}}}},"400":{"description":"No valid recipient (`error.reason: invalid_request`)"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"409":{"description":"License revoked"},"429":{"description":"Emailed 10 times in the last hour"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Delivery failed (`error.reason: send_failed`)"}}}},"/api/licensing/offline/process":{"post":{"tags":["Licensing"],"summary":"Answer an offline request code","description":"Activate \u2192 signed response code (`mode: \"offline\"`, consumes a seat). Deactivate \u2192 signed receipt (`receipt: true`). Each request code works once. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:issue` scope.","operationId":"postApiLicensingOfflineProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"request_code":{"type":"string"},"license_key":{"type":"string","description":"Optional; must match the key inside the request code"}},"required":["request_code"]}}}},"responses":{"200":{"description":"Answered. Fields at top level and mirrored in `data`","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"response_code":{"type":"string"},"kind":{"type":"string","enum":["activate","deactivate"]},"receipt":{"type":"boolean"},"data":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Refused. Top-level `{success:false, reason, message}` plus `error:{message, reason}`. 422 for refusals (invalid_request, not_found, replayed, offline_disabled, trials_disabled, trial_used, seat_limit, use_lease, not_activated, revoked, suspended, expired, rate_limited); 404 when the license is not one of yours."},"422":{"description":"Refused. Top-level `{success:false, reason, message}` plus `error:{message, reason}`. 422 for refusals (invalid_request, not_found, replayed, offline_disabled, trials_disabled, trial_used, seat_limit, use_lease, not_activated, revoked, suspended, expired, rate_limited); 404 when the license is not one of yours."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/offline/trial":{"post":{"tags":["Licensing"],"summary":"Issue an offline trial from a request code","description":"One trial per machine per product. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:issue` scope.","operationId":"postApiLicensingOfflineTrial","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_slug":{"type":"string"},"request_code":{"type":"string"}},"required":["product_slug","request_code"]}}}},"responses":{"201":{"description":"Trial issued. Fields at top level and mirrored in `data`","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"license_key":{"type":"string"},"response_code":{"type":"string"},"expires_at":{"type":"string"},"kind":{"type":"string","example":"trial"},"data":{"type":"object"}}}}}},"400":{"description":"product_slug or request_code missing","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"422":{"description":"Refused. Top-level `{success:false, reason, message}` plus `error:{message, reason}`. 422 for refusals (invalid_request, not_found, replayed, offline_disabled, trials_disabled, trial_used, seat_limit, use_lease, not_activated, revoked, suspended, expired, rate_limited); 404 when the license is not one of yours."},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products":{"get":{"tags":["Licensing"],"summary":"List licensing products","description":"Products owned by the caller or an organization they belong to, with `license_count` and `active_count`. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingProducts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Products","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Licensing"],"summary":"Create a licensing product","description":"Creates the product and its first (active) signing key. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingProducts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"200 chars max"},"slug":{"type":"string","description":"Defaults from name. Letters, digits, dashes; 120 max; globally unique"},"organization_id":{"type":"string","format":"uuid","description":"Create it owned by this organization (you must be a member)"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"See white_label schema on the product response"},"default_trial_days":{"type":"integer","description":"0-3650, default 14"},"default_seat_count":{"type":"integer","description":"1-1000000, default 1"},"allow_offline":{"type":"boolean","default":true},"allow_trials":{"type":"boolean","default":true},"offline_ttl_days":{"type":"integer","description":"0-3650, default 30; 0 = until the license expires"},"deactivation_limit_per_day":{"type":"integer","description":"0-10000, default 10; 0 = unlimited. Customer-initiated only"}},"required":["name"]}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"Unlicensed-screen branding","properties":{"product_name":{"type":"string"},"company_name":{"type":"string"},"logo_url":{"type":"string","description":"https:// only"},"accent_color":{"type":"string","description":"#RRGGBB"},"support_email":{"type":"string"},"support_url":{"type":"string"},"purchase_url":{"type":"string"},"unlicensed_title":{"type":"string"},"unlicensed_message":{"type":"string"},"trial_message":{"type":"string"},"show_trial_countdown":{"type":"boolean"}}},"default_trial_days":{"type":"integer"},"default_seat_count":{"type":"integer"},"allow_offline":{"type":"boolean"},"allow_trials":{"type":"boolean"},"offline_ttl_days":{"type":"integer"},"deactivation_limit_per_day":{"type":"integer"},"public_key":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"status":{"type":"string","enum":["active","suspended","archived"]},"archived_at":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"organization_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not a member of that organization, or app token","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"409":{"description":"Slug not available","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}":{"get":{"tags":["Licensing"],"summary":"Get a licensing product","description":"Includes `white_label`, `public_key` and `public_keys`. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"Unlicensed-screen branding","properties":{"product_name":{"type":"string"},"company_name":{"type":"string"},"logo_url":{"type":"string","description":"https:// only"},"accent_color":{"type":"string","description":"#RRGGBB"},"support_email":{"type":"string"},"support_url":{"type":"string"},"purchase_url":{"type":"string"},"unlicensed_title":{"type":"string"},"unlicensed_message":{"type":"string"},"trial_message":{"type":"string"},"show_trial_countdown":{"type":"boolean"}}},"default_trial_days":{"type":"integer"},"default_seat_count":{"type":"integer"},"allow_offline":{"type":"boolean"},"allow_trials":{"type":"boolean"},"offline_ttl_days":{"type":"integer"},"deactivation_limit_per_day":{"type":"integer"},"public_key":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"status":{"type":"string","enum":["active","suspended","archived"]},"archived_at":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"organization_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Licensing"],"summary":"Update a licensing product","description":"Changes only the fields sent. Slug and owner cannot change. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"putApiLicensingProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"200 chars max"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"See white_label schema on the product response"},"default_trial_days":{"type":"integer","description":"0-3650, default 14"},"default_seat_count":{"type":"integer","description":"1-1000000, default 1"},"allow_offline":{"type":"boolean","default":true},"allow_trials":{"type":"boolean","default":true},"offline_ttl_days":{"type":"integer","description":"0-3650, default 30; 0 = until the license expires"},"deactivation_limit_per_day":{"type":"integer","description":"0-10000, default 10; 0 = unlimited. Customer-initiated only"},"status":{"type":"string","enum":["active","suspended","archived"]}}}}}},"responses":{"200":{"description":"Updated product","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"Unlicensed-screen branding","properties":{"product_name":{"type":"string"},"company_name":{"type":"string"},"logo_url":{"type":"string","description":"https:// only"},"accent_color":{"type":"string","description":"#RRGGBB"},"support_email":{"type":"string"},"support_url":{"type":"string"},"purchase_url":{"type":"string"},"unlicensed_title":{"type":"string"},"unlicensed_message":{"type":"string"},"trial_message":{"type":"string"},"show_trial_countdown":{"type":"boolean"}}},"default_trial_days":{"type":"integer"},"default_seat_count":{"type":"integer"},"allow_offline":{"type":"boolean"},"allow_trials":{"type":"boolean"},"offline_ttl_days":{"type":"integer"},"deactivation_limit_per_day":{"type":"integer"},"public_key":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"status":{"type":"string","enum":["active","suspended","archived"]},"archived_at":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"organization_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Licensing"],"summary":"Archive a licensing product","description":"Archive, never delete: refuses new licenses, activations, offline activations and trials; existing activations and leases keep working and the public keys stay published. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"deleteApiLicensingProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Archived product","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string","nullable":true},"white_label":{"type":"object","description":"Unlicensed-screen branding","properties":{"product_name":{"type":"string"},"company_name":{"type":"string"},"logo_url":{"type":"string","description":"https:// only"},"accent_color":{"type":"string","description":"#RRGGBB"},"support_email":{"type":"string"},"support_url":{"type":"string"},"purchase_url":{"type":"string"},"unlicensed_title":{"type":"string"},"unlicensed_message":{"type":"string"},"trial_message":{"type":"string"},"show_trial_countdown":{"type":"boolean"}}},"default_trial_days":{"type":"integer"},"default_seat_count":{"type":"integer"},"allow_offline":{"type":"boolean"},"allow_trials":{"type":"boolean"},"offline_ttl_days":{"type":"integer"},"deactivation_limit_per_day":{"type":"integer"},"public_key":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}},"status":{"type":"string","enum":["active","suspended","archived"]},"archived_at":{"type":"string","nullable":true},"owner_id":{"type":"string","nullable":true},"organization_id":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}/keys":{"get":{"tags":["Licensing"],"summary":"List published signing keys","description":"`next`, `active` and `previous` keys, active first. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingProductsByidKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Keys","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}/licenses":{"get":{"tags":["Licensing"],"summary":"List one product's licenses","description":"Paginated. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:read` (or `licensing:issue`) scope.","operationId":"getApiLicensingProductsByidLicenses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","suspended","revoked","expired"]}},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Customer name, email, reference or license key (substring, case-insensitive)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50},"description":"1-200"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Licenses","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}},"meta":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}}}}}}},"400":{"description":"Unknown status filter","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Licensing"],"summary":"Issue a license","description":"Issues a license and optionally emails the key. The email result is reported in `meta.email` and never fails the issue. Auth: user JWT or app token (`X-App-Token`). An app token needs the `licensing:issue` scope.","operationId":"postApiLicensingProductsByidLicenses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","default":"perpetual","enum":["perpetual","subscription","trial"]},"seat_count":{"type":"integer","description":"Default: the product default"},"is_floating":{"type":"boolean","default":false},"max_concurrent":{"type":"integer","description":"Floating only; default seat_count"},"expires_at":{"type":"string","description":"ISO 8601, unix seconds, or YYYY-MM-DD (end of day UTC). Required for subscription"},"trial_days":{"type":"integer","description":"Trial without expires_at; default the product default"},"updates_until":{"type":"string","description":"Maintenance date"},"features":{"type":"object","description":"Object, or a list of names (stored as {name:true}); 16 KB max"},"customer_name":{"type":"string"},"customer_email":{"type":"string"},"customer_reference":{"type":"string","description":"e.g. your order id"},"notes":{"type":"string"},"email":{"type":"string","description":"`true` = email customer_email; or an address"},"email_message":{"type":"string"}}}}}},"responses":{"201":{"description":"Issued","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"product_id":{"type":"string"},"product_name":{"type":"string"},"product_slug":{"type":"string"},"license_key":{"type":"string","example":"7KQ4M-XW2PD-9HT3N-RB6CF-J8VZE"},"type":{"type":"string","enum":["perpetual","subscription","trial"]},"status":{"type":"string","enum":["active","suspended","revoked","expired"]},"seat_count":{"type":"integer"},"seats_used":{"type":"integer"},"seats_available":{"type":"integer"},"is_floating":{"type":"boolean"},"max_concurrent":{"type":"integer","nullable":true},"leases_active":{"type":"integer"},"features":{"type":"object"},"customer_name":{"type":"string","nullable":true},"customer_email":{"type":"string","nullable":true},"customer_reference":{"type":"string","nullable":true},"is_trial":{"type":"boolean"},"issued_at":{"type":"string"},"expires_at":{"type":"string","nullable":true},"updates_until":{"type":"string","nullable":true},"signing_key_id":{"type":"string"},"notes":{"type":"string","nullable":true},"suspended_at":{"type":"string","nullable":true},"suspended_reason":{"type":"string","nullable":true},"revoked_at":{"type":"string","nullable":true},"revoked_reason":{"type":"string","nullable":true},"signed_blob":{"type":"string","description":"As-issued signed copy (mode \"issue\"); never valid on a machine. Single-license responses only."}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"422":{"description":"Product archived/suspended, or trials disabled","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}/promote-key":{"post":{"tags":["Licensing"],"summary":"Promote the staged key to active","description":"`next` \u2192 `active`; the old active key becomes `previous` (verify-only). Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingProductsByidPromoteKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Promoted","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"key_id":{"type":"string"},"previous_key_id":{"type":"string","nullable":true},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"409":{"description":"No staged (next) key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}/retire-key":{"post":{"tags":["Licensing"],"summary":"Retire a previous key (or discard a staged one)","description":"A retired key is unpublished and nothing it signed verifies any more. The active key cannot be retired. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingProductsByidRetireKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key_id":{"type":"string","description":"The `kid` to retire"}},"required":["key_id"]}}}},"responses":{"200":{"description":"Retired","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"key_id":{"type":"string"},"state":{"type":"string","example":"retired"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}}}}}}}}},"400":{"description":"key_id missing or unknown","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"409":{"description":"That is the active key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/licensing/products/{id}/rotate-key":{"post":{"tags":["Licensing"],"summary":"Stage a new signing key (next)","description":"Creates a `next` key: published at once, signs nothing until promoted. Idempotent (returns the existing `next` key). Ship a client build whose key set contains it before promoting. Auth: user JWT or app token (`X-App-Token`). Requires a signed-in user: app tokens are refused with 403 (`error.required_scope`).","operationId":"postApiLicensingProductsByidRotateKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Staged key","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"key_id":{"type":"string"},"public_key":{"type":"string"},"state":{"type":"string"},"public_keys":{"type":"array","items":{"type":"object","properties":{"kid":{"type":"string"},"public_key":{"type":"string","description":"Ed25519, standard base64"},"state":{"type":"string","enum":["next","active","previous"]}}}}}}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"App token lacks the required licensing scope, or the endpoint needs a signed-in user. `error.required_scope` names the scope.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"404":{"description":"Not found, or not owned by the caller","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"}}}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}":{"get":{"tags":["Live chat"],"summary":"Get conversation","operationId":"getApiLiveChatConversationsBycid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/accept":{"post":{"tags":["Live chat"],"summary":"Create accept","operationId":"postApiLiveChatConversationsBycidAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/close":{"post":{"tags":["Live chat"],"summary":"Create close","operationId":"postApiLiveChatConversationsBycidClose","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/messages":{"post":{"tags":["Live chat"],"summary":"Create messages","operationId":"postApiLiveChatConversationsBycidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/transfer":{"post":{"tags":["Live chat"],"summary":"Create transfer","operationId":"postApiLiveChatConversationsBycidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/typing":{"post":{"tags":["Live chat"],"summary":"Create typing","operationId":"postApiLiveChatConversationsBycidTyping","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/conversations/{cid}/visitor":{"delete":{"tags":["Live chat"],"summary":"Delete visitor","operationId":"deleteApiLiveChatConversationsBycidVisitor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks":{"get":{"tags":["Live chat"],"summary":"List desks","operationId":"getApiLiveChatDesks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Live chat"],"summary":"Create desks","operationId":"postApiLiveChatDesks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}":{"get":{"tags":["Live chat"],"summary":"Get desk","operationId":"getApiLiveChatDesksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Live chat"],"summary":"Update desk","operationId":"putApiLiveChatDesksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Live chat"],"summary":"Delete desk","operationId":"deleteApiLiveChatDesksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/agents":{"post":{"tags":["Live chat"],"summary":"---- Agents ----","operationId":"postApiLiveChatDesksByidAgents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/agents/{agentId}":{"put":{"tags":["Live chat"],"summary":"Update agent","operationId":"putApiLiveChatDesksByidAgentsByagentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Live chat"],"summary":"Delete agent","operationId":"deleteApiLiveChatDesksByidAgentsByagentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/agents/{agentId}/avatar":{"put":{"tags":["Live chat"],"summary":"An agent's picture: a data: URL of a small image, from the console.","operationId":"putApiLiveChatDesksByidAgentsByagentidAvatar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Live chat"],"summary":"Delete avatar","operationId":"deleteApiLiveChatDesksByidAgentsByagentidAvatar","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/cancel":{"post":{"tags":["Live chat"],"summary":"Create cancel","operationId":"postApiLiveChatDesksByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/candidates":{"get":{"tags":["Live chat"],"summary":"List candidates","operationId":"getApiLiveChatDesksByidCandidates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/canned-replies":{"get":{"tags":["Live chat"],"summary":"================================================================","operationId":"getApiLiveChatDesksByidCannedReplies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Live chat"],"summary":"Create canned replies","operationId":"postApiLiveChatDesksByidCannedReplies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/canned-replies/{rid}":{"put":{"tags":["Live chat"],"summary":"Update canned replie","operationId":"putApiLiveChatDesksByidCannedRepliesByrid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"rid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Live chat"],"summary":"Delete canned replie","operationId":"deleteApiLiveChatDesksByidCannedRepliesByrid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"rid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/conversations":{"get":{"tags":["Live chat"],"summary":"List conversations","operationId":"getApiLiveChatDesksByidConversations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/groups":{"post":{"tags":["Live chat"],"summary":"---- Groups ----","operationId":"postApiLiveChatDesksByidGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/groups/{groupId}":{"put":{"tags":["Live chat"],"summary":"Update group","operationId":"putApiLiveChatDesksByidGroupsBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Live chat"],"summary":"Delete group","operationId":"deleteApiLiveChatDesksByidGroupsBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/presence":{"post":{"tags":["Live chat"],"summary":"---- Agents (signed in) ----","operationId":"postApiLiveChatDesksByidPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/purchase":{"post":{"tags":["Live chat"],"summary":"Create purchase","operationId":"postApiLiveChatDesksByidPurchase","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/queue":{"get":{"tags":["Live chat"],"summary":"List queue","operationId":"getApiLiveChatDesksByidQueue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/quote":{"get":{"tags":["Live chat"],"summary":"charged; a price that changed in between is refused, not charged.","operationId":"getApiLiveChatDesksByidQuote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/resume":{"post":{"tags":["Live chat"],"summary":"Create resume","operationId":"postApiLiveChatDesksByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/sites":{"post":{"tags":["Live chat"],"summary":"---- Sites ----","operationId":"postApiLiveChatDesksByidSites","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/sites/{siteId}":{"delete":{"tags":["Live chat"],"summary":"Delete site","operationId":"deleteApiLiveChatDesksByidSitesBysiteid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"siteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/stats":{"get":{"tags":["Live chat"],"summary":"================================================================","operationId":"getApiLiveChatDesksByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/desks/{id}/stats/export":{"get":{"tags":["Live chat"],"summary":"List export","operationId":"getApiLiveChatDesksByidStatsExport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/conversations":{"post":{"tags":["Live chat"],"summary":"Create conversations","operationId":"postApiLiveChatVBykeyConversations","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/conversations/{cid}":{"get":{"tags":["Live chat"],"summary":"Get conversation","operationId":"getApiLiveChatVBykeyConversationsBycid","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/conversations/{cid}/close":{"post":{"tags":["Live chat"],"summary":"Create close","operationId":"postApiLiveChatVBykeyConversationsBycidClose","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/conversations/{cid}/messages":{"post":{"tags":["Live chat"],"summary":"Create messages","operationId":"postApiLiveChatVBykeyConversationsBycidMessages","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/conversations/{cid}/typing":{"post":{"tags":["Live chat"],"summary":"Create typing","operationId":"postApiLiveChatVBykeyConversationsBycidTyping","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"cid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/offline":{"post":{"tags":["Live chat"],"summary":"Create offline","operationId":"postApiLiveChatVBykeyOffline","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/live-chat/v/{key}/status":{"get":{"tags":["Live chat"],"summary":"List status","operationId":"getApiLiveChatVBykeyStatus","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/locks":{"post":{"tags":["Locks"],"summary":"Locks","operationId":"postApiLocks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/locks/endpoint/{endpointId}":{"get":{"tags":["Locks"],"summary":"Get endpoint","operationId":"getApiLocksEndpointByendpointid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/locks/endpoint/{endpointId}/record/{recordId}":{"get":{"tags":["Locks"],"summary":"Get record","operationId":"getApiLocksEndpointByendpointidRecordByrecordid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/locks/{lockId}":{"delete":{"tags":["Locks"],"summary":"Delete lock","operationId":"deleteApiLocksBylockid","security":[],"parameters":[{"name":"lockId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/locks/{lockId}/renew":{"put":{"tags":["Locks"],"summary":"Update renew","operationId":"putApiLocksBylockidRenew","security":[],"parameters":[{"name":"lockId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges":{"post":{"tags":["Machine bridges"],"summary":"--- CRUD ---","operationId":"postApiMachineBridges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Machine bridges"],"summary":"List machine bridges","operationId":"getApiMachineBridges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}":{"get":{"tags":["Machine bridges"],"summary":"Get machine bridge","operationId":"getApiMachineBridgesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Machine bridges"],"summary":"Update machine bridge","operationId":"putApiMachineBridgesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Machine bridges"],"summary":"Delete machine bridge","operationId":"deleteApiMachineBridgesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/ingest":{"post":{"tags":["Machine bridges"],"summary":"--- Data Ingestion ---","operationId":"postApiMachineBridgesByidIngest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/logs":{"get":{"tags":["Machine bridges"],"summary":"List logs","operationId":"getApiMachineBridgesByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/pause":{"post":{"tags":["Machine bridges"],"summary":"Create pause","operationId":"postApiMachineBridgesByidPause","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/restart":{"post":{"tags":["Machine bridges"],"summary":"Create restart","operationId":"postApiMachineBridgesByidRestart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/resume":{"post":{"tags":["Machine bridges"],"summary":"Create resume","operationId":"postApiMachineBridgesByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/start":{"post":{"tags":["Machine bridges"],"summary":"--- Lifecycle Control ---","operationId":"postApiMachineBridgesByidStart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/stats":{"get":{"tags":["Machine bridges"],"summary":"List stats","operationId":"getApiMachineBridgesByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/status":{"get":{"tags":["Machine bridges"],"summary":"List status","operationId":"getApiMachineBridgesByidStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/stop":{"post":{"tags":["Machine bridges"],"summary":"Create stop","operationId":"postApiMachineBridgesByidStop","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/machine-bridges/{id}/test":{"post":{"tags":["Machine bridges"],"summary":"--- Monitoring & Diagnostics ---","operationId":"postApiMachineBridgesByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/asset/{endpointId}/{recordId}":{"get":{"tags":["Maintenance"],"summary":"Get asset","operationId":"getApiMaintenanceAssetByendpointidByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/dashboard":{"get":{"tags":["Maintenance"],"summary":"--- Dashboard & Reports (before /@id routes) ---","operationId":"getApiMaintenanceDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/logs/{logId}":{"get":{"tags":["Maintenance"],"summary":"--- Completion Log routes (before /schedules/@id to avoid conflict) ---","operationId":"getApiMaintenanceLogsBylogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Maintenance"],"summary":"Update log","operationId":"putApiMaintenanceLogsBylogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Maintenance"],"summary":"Delete log","operationId":"deleteApiMaintenanceLogsBylogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/overdue":{"get":{"tags":["Maintenance"],"summary":"List overdue","operationId":"getApiMaintenanceOverdue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/reports/calibration":{"get":{"tags":["Maintenance"],"summary":"List calibration","operationId":"getApiMaintenanceReportsCalibration","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/reports/costs":{"get":{"tags":["Maintenance"],"summary":"List costs","operationId":"getApiMaintenanceReportsCosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules":{"post":{"tags":["Maintenance"],"summary":"--- Schedule CRUD ---","operationId":"postApiMaintenanceSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Maintenance"],"summary":"List schedules","operationId":"getApiMaintenanceSchedules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}":{"get":{"tags":["Maintenance"],"summary":"Get schedule","operationId":"getApiMaintenanceSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Maintenance"],"summary":"Update schedule","operationId":"putApiMaintenanceSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Maintenance"],"summary":"Delete schedule","operationId":"deleteApiMaintenanceSchedulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/archive":{"post":{"tags":["Maintenance"],"summary":"Create archive","operationId":"postApiMaintenanceSchedulesByidArchive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/complete":{"post":{"tags":["Maintenance"],"summary":"--- Schedule sub-resource routes (before /@id) ---","operationId":"postApiMaintenanceSchedulesByidComplete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/history":{"get":{"tags":["Maintenance"],"summary":"List history","operationId":"getApiMaintenanceSchedulesByidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/logs":{"get":{"tags":["Maintenance"],"summary":"List logs","operationId":"getApiMaintenanceSchedulesByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/pause":{"post":{"tags":["Maintenance"],"summary":"Create pause","operationId":"postApiMaintenanceSchedulesByidPause","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/maintenance/schedules/{id}/resume":{"post":{"tags":["Maintenance"],"summary":"Create resume","operationId":"postApiMaintenanceSchedulesByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/info":{"get":{"tags":["Marketplace"],"summary":"to render an \"AI ready / disabled / out-of-credit\" state.","operationId":"getApiMarketplaceAiInfo","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/invoke/chat":{"post":{"tags":["Marketplace"],"summary":"JWT-authenticated requests cannot spend from a subscription wallet.","operationId":"postApiMarketplaceAiInvokeChat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/invoke/transcribe":{"post":{"tags":["Marketplace"],"summary":"as chat; multipart audio in, transcript out, metered by audio seconds.","operationId":"postApiMarketplaceAiInvokeTranscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/usage":{"get":{"tags":["Marketplace"],"summary":"List usage","operationId":"getApiMarketplaceAiUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/wallet":{"get":{"tags":["Marketplace"],"summary":"List wallet","operationId":"getApiMarketplaceAiWallet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/wallet/auto-recharge":{"put":{"tags":["Marketplace"],"summary":"Update auto recharge","operationId":"putApiMarketplaceAiWalletAutoRecharge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/wallet/daily-cap":{"put":{"tags":["Marketplace"],"summary":"Update daily cap","operationId":"putApiMarketplaceAiWalletDailyCap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/wallet/topup-checkout":{"post":{"tags":["Marketplace"],"summary":"Create topup checkout","operationId":"postApiMarketplaceAiWalletTopupCheckout","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/ai/wallet/transactions":{"get":{"tags":["Marketplace"],"summary":"List transactions","operationId":"getApiMarketplaceAiWalletTransactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/forward":{"post":{"tags":["Marketplace"],"summary":"GET proxy. Asked for in that shape by vault56-jboard, 2026-09-21.","operationId":"postApiMarketplaceForward","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/plugins/{pluginId}/icon":{"get":{"tags":["Marketplace"],"summary":"Get a plugin icon (public for an approved plugin; ETag; 404 otherwise)","operationId":"getApiMarketplacePluginsBypluginidIcon","security":[],"parameters":[{"name":"pluginId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Marketplace"],"summary":"Upload a plugin icon (author only; PNG or SVG, square, <=256 KB)","operationId":"postApiMarketplacePluginsBypluginidIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"pluginId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Marketplace"],"summary":"Clear a plugin icon (author only)","operationId":"deleteApiMarketplacePluginsBypluginidIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"pluginId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/marketplace/proxy":{"post":{"tags":["Marketplace"],"summary":"http:fetch scope. GET-only external calls; 1 MB / 10 s caps.","operationId":"postApiMarketplaceProxy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/assignments/{assignmentId}":{"delete":{"tags":["Masking profiles"],"summary":"Delete assignment","operationId":"deleteApiMaskingProfilesAssignmentsByassignmentid","security":[],"parameters":[{"name":"assignmentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/rules/{ruleId}":{"put":{"tags":["Masking profiles"],"summary":"Update rule","operationId":"putApiMaskingProfilesRulesByruleid","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Masking profiles"],"summary":"Delete rule","operationId":"deleteApiMaskingProfilesRulesByruleid","security":[],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/{id}":{"get":{"tags":["Masking profiles"],"summary":"Profile get/update/delete (profile-scoped)","operationId":"getApiMaskingProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Masking profiles"],"summary":"Update masking profile","operationId":"putApiMaskingProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Masking profiles"],"summary":"Delete masking profile","operationId":"deleteApiMaskingProfilesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/{id}/assignments":{"post":{"tags":["Masking profiles"],"summary":"Assignments","operationId":"postApiMaskingProfilesByidAssignments","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/{id}/preview":{"post":{"tags":["Masking profiles"],"summary":"Preview","operationId":"postApiMaskingProfilesByidPreview","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-profiles/{id}/rules":{"post":{"tags":["Masking profiles"],"summary":"Rules","operationId":"postApiMaskingProfilesByidRules","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-rules":{"post":{"tags":["Masking rules"],"summary":"----- Data Masking Routes -----","operationId":"postApiMaskingRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Masking rules"],"summary":"List masking rules","operationId":"getApiMaskingRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-rules/preview":{"post":{"tags":["Masking rules"],"summary":"Create preview","operationId":"postApiMaskingRulesPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-rules/types":{"get":{"tags":["Masking rules"],"summary":"List types","operationId":"getApiMaskingRulesTypes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/masking-rules/{id}":{"get":{"tags":["Masking rules"],"summary":"Get masking rule","operationId":"getApiMaskingRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Masking rules"],"summary":"Update masking rule","operationId":"putApiMaskingRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Masking rules"],"summary":"Delete masking rule","operationId":"deleteApiMaskingRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking":{"post":{"tags":["Matchmaking"],"summary":"--- Matchmaking Queue CRUD ---","operationId":"postApiMatchmaking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Matchmaking"],"summary":"List matchmaking","operationId":"getApiMatchmaking","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}":{"get":{"tags":["Matchmaking"],"summary":"Get matchmaking","operationId":"getApiMatchmakingByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Matchmaking"],"summary":"Update matchmaking","operationId":"putApiMatchmakingByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Matchmaking"],"summary":"Delete matchmaking","operationId":"deleteApiMatchmakingByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/dequeue":{"post":{"tags":["Matchmaking"],"summary":"Create dequeue","operationId":"postApiMatchmakingByidDequeue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/enqueue":{"post":{"tags":["Matchmaking"],"summary":"--- Enqueue / Dequeue ---","operationId":"postApiMatchmakingByidEnqueue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/process":{"post":{"tags":["Matchmaking"],"summary":"--- Process ---","operationId":"postApiMatchmakingByidProcess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/stats":{"get":{"tags":["Matchmaking"],"summary":"--- Stats ---","operationId":"getApiMatchmakingByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/ticket":{"get":{"tags":["Matchmaking"],"summary":"--- Tickets ---","operationId":"getApiMatchmakingByidTicket","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/matchmaking/{id}/tickets":{"get":{"tags":["Matchmaking"],"summary":"List tickets","operationId":"getApiMatchmakingByidTickets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels":{"post":{"tags":["Messaging"],"summary":"--- Channel CRUD ---","operationId":"postApiMessagingChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Messaging"],"summary":"List channels","operationId":"getApiMessagingChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/dm":{"get":{"tags":["Messaging"],"summary":"List dm","operationId":"getApiMessagingChannelsDm","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/unread":{"get":{"tags":["Messaging"],"summary":"List unread","operationId":"getApiMessagingChannelsUnread","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/gallery":{"get":{"tags":["Messaging"],"summary":"List gallery","operationId":"getApiMessagingChannelsBychannelidGallery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/media-stats":{"get":{"tags":["Messaging"],"summary":"--- Stats & Management ---","operationId":"getApiMessagingChannelsBychannelidMediaStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/members":{"get":{"tags":["Messaging"],"summary":"--- Members ---","operationId":"getApiMessagingChannelsBychannelidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Messaging"],"summary":"Create members","operationId":"postApiMessagingChannelsBychannelidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/members/{userId}":{"put":{"tags":["Messaging"],"summary":"Update member","operationId":"putApiMessagingChannelsBychannelidMembersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Messaging"],"summary":"Delete member","operationId":"deleteApiMessagingChannelsBychannelidMembersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/messages":{"post":{"tags":["Messaging"],"summary":"--- Messages ---","operationId":"postApiMessagingChannelsBychannelidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Messaging"],"summary":"List messages","operationId":"getApiMessagingChannelsBychannelidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/pins":{"get":{"tags":["Messaging"],"summary":"--- Pins ---","operationId":"getApiMessagingChannelsBychannelidPins","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/read":{"post":{"tags":["Messaging"],"summary":"--- Read State ---","operationId":"postApiMessagingChannelsBychannelidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/threads":{"get":{"tags":["Messaging"],"summary":"--- Threads ---","operationId":"getApiMessagingChannelsBychannelidThreads","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{channelId}/voice":{"get":{"tags":["Messaging"],"summary":"--- Voice Messages ---","operationId":"getApiMessagingChannelsBychannelidVoice","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{id}":{"get":{"tags":["Messaging"],"summary":"Get channel","operationId":"getApiMessagingChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Messaging"],"summary":"Update channel","operationId":"putApiMessagingChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Messaging"],"summary":"Delete channel","operationId":"deleteApiMessagingChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/channels/{id}/info":{"get":{"tags":["Messaging"],"summary":"List info","operationId":"getApiMessagingChannelsByidInfo","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/link-previews/{previewId}/refresh":{"post":{"tags":["Messaging"],"summary":"Create refresh","operationId":"postApiMessagingLinkPreviewsBypreviewidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"previewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/media/{mediaId}":{"get":{"tags":["Messaging"],"summary":"Get media","operationId":"getApiMessagingMediaBymediaid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Messaging"],"summary":"Delete media","operationId":"deleteApiMessagingMediaBymediaid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/media/{mediaId}/download":{"get":{"tags":["Messaging"],"summary":"--- Download/Stream ---","operationId":"getApiMessagingMediaBymediaidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/media/{mediaId}/thumbnail":{"get":{"tags":["Messaging"],"summary":"List thumbnail","operationId":"getApiMessagingMediaBymediaidThumbnail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}":{"get":{"tags":["Messaging"],"summary":"Get message","operationId":"getApiMessagingMessagesBymessageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Messaging"],"summary":"Update message","operationId":"putApiMessagingMessagesBymessageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Messaging"],"summary":"Delete message","operationId":"deleteApiMessagingMessagesBymessageid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/link-previews":{"get":{"tags":["Messaging"],"summary":"--- Link Previews ---","operationId":"getApiMessagingMessagesBymessageidLinkPreviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/media":{"post":{"tags":["Messaging"],"summary":"--- Upload ---","operationId":"postApiMessagingMessagesBymessageidMedia","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Messaging"],"summary":"--- Retrieval ---","operationId":"getApiMessagingMessagesBymessageidMedia","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/pin":{"post":{"tags":["Messaging"],"summary":"Create pin","operationId":"postApiMessagingMessagesBymessageidPin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Messaging"],"summary":"Delete pin","operationId":"deleteApiMessagingMessagesBymessageidPin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/reactions":{"get":{"tags":["Messaging"],"summary":"--- Reactions ---","operationId":"getApiMessagingMessagesBymessageidReactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Messaging"],"summary":"Create reactions","operationId":"postApiMessagingMessagesBymessageidReactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/reactions/{emoji}":{"delete":{"tags":["Messaging"],"summary":"Delete reaction","operationId":"deleteApiMessagingMessagesBymessageidReactionsByemoji","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"emoji","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/messages/{messageId}/voice":{"post":{"tags":["Messaging"],"summary":"Create voice","operationId":"postApiMessagingMessagesBymessageidVoice","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/search":{"get":{"tags":["Messaging"],"summary":"--- Search ---","operationId":"getApiMessagingSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/messaging/threads/{threadId}/messages":{"get":{"tags":["Messaging"],"summary":"List messages","operationId":"getApiMessagingThreadsBythreadidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"threadId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ml/models/{modelId}":{"get":{"tags":["Ml"],"summary":"Get ML model","operationId":"getApiMlModelsBymodelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Ml"],"summary":"Delete ML model","operationId":"deleteApiMlModelsBymodelid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ml/models/{modelId}/accuracy":{"get":{"tags":["Ml"],"summary":"Get model accuracy/metrics","operationId":"getApiMlModelsBymodelidAccuracy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ml/models/{modelId}/predict":{"post":{"tags":["Ml"],"summary":"Predict using model (direct input)","operationId":"postApiMlModelsBymodelidPredict","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ml/models/{modelId}/train":{"post":{"tags":["Ml"],"summary":"Train model","operationId":"postApiMlModelsBymodelidTrain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/mock/{endpoint}":{"get":{"tags":["Mock"],"summary":"Get mock","operationId":"getApiMockByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/mock/{endpoint}/config":{"get":{"tags":["Mock"],"summary":"and this handler never runs. Enforced by bin/route-check.php.","operationId":"getApiMockByendpointConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Mock"],"summary":"Create config","operationId":"postApiMockByendpointConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Mock"],"summary":"Delete config","operationId":"deleteApiMockByendpointConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/mock/{endpoint}/error":{"post":{"tags":["Mock"],"summary":"Create error","operationId":"postApiMockByendpointError","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/mock/{endpoint}/schema":{"get":{"tags":["Mock"],"summary":"and this handler never runs. Enforced by bin/route-check.php.","operationId":"getApiMockByendpointSchema","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/mock/{endpoint}/{id}":{"get":{"tags":["Mock"],"summary":"Get mock","operationId":"getApiMockByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/catalog":{"get":{"tags":["Monetization"],"summary":"--- Public Catalog (no auth required) ---","operationId":"getApiMonetizationCatalog","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/catalog/{catalogId}":{"get":{"tags":["Monetization"],"summary":"Get catalog","operationId":"getApiMonetizationCatalogBycatalogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"catalogId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Monetization"],"summary":"Update catalog","operationId":"putApiMonetizationCatalogBycatalogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"catalogId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Monetization"],"summary":"Delete catalog","operationId":"deleteApiMonetizationCatalogBycatalogid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"catalogId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/plans/{planId}":{"get":{"tags":["Monetization"],"summary":"Get plan","operationId":"getApiMonetizationPlansByplanid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Monetization"],"summary":"Update plan","operationId":"putApiMonetizationPlansByplanid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Monetization"],"summary":"Delete plan","operationId":"deleteApiMonetizationPlansByplanid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/plans/{planId}/subscribe":{"post":{"tags":["Monetization"],"summary":"--- Subscriptions ---","operationId":"postApiMonetizationPlansByplanidSubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/plans/{planId}/subscribers":{"get":{"tags":["Monetization"],"summary":"--- Subscribers (plan owner) ---","operationId":"getApiMonetizationPlansByplanidSubscribers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/subscriptions":{"get":{"tags":["Monetization"],"summary":"List subscriptions","operationId":"getApiMonetizationSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/subscriptions/{subscriptionId}":{"get":{"tags":["Monetization"],"summary":"Get subscription","operationId":"getApiMonetizationSubscriptionsBysubscriptionid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Monetization"],"summary":"Delete subscription","operationId":"deleteApiMonetizationSubscriptionsBysubscriptionid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/monetization/subscriptions/{subscriptionId}/usage":{"post":{"tags":["Monetization"],"summary":"--- Usage ---","operationId":"postApiMonetizationSubscriptionsBysubscriptionidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Monetization"],"summary":"List usage","operationId":"getApiMonetizationSubscriptionsBysubscriptionidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/features":{"get":{"tags":["My"],"summary":"--- User: Features ---","operationId":"getApiMyFeatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/features/{key}":{"delete":{"tags":["My"],"summary":"Delete feature","operationId":"deleteApiMyFeaturesBykey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/features/{key}/subscribe":{"post":{"tags":["My"],"summary":"Create subscribe","operationId":"postApiMyFeaturesBykeySubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package":{"get":{"tags":["My"],"summary":"--- User: My Package ---","operationId":"getApiMyPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["My"],"summary":"Create package","operationId":"postApiMyPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/auto-renew":{"post":{"tags":["My"],"summary":"what is paid; nothing is refunded.","operationId":"postApiMyPackageAutoRenew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/downgrade-check":{"get":{"tags":["My"],"summary":"List downgrade check","operationId":"getApiMyPackageDowngradeCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/end-of-period":{"get":{"tags":["My"],"summary":"List end of period","operationId":"getApiMyPackageEndOfPeriod","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/purchase":{"post":{"tags":["My"],"summary":"Create purchase","operationId":"postApiMyPackagePurchase","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/purchase-quote":{"get":{"tags":["My"],"summary":"List purchase quote","operationId":"getApiMyPackagePurchaseQuote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/step-down":{"post":{"tags":["My"],"summary":"Create step down","operationId":"postApiMyPackageStepDown","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/my/package/step-down/cancel":{"post":{"tags":["My"],"summary":"Create cancel","operationId":"postApiMyPackageStepDownCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces":{"get":{"tags":["Namespaces"],"summary":"List all namespaces","operationId":"getApiNamespaces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Namespaces"],"summary":"Register new namespace","operationId":"postApiNamespaces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces/resolve":{"get":{"tags":["Namespaces"],"summary":"Resolve a path to namespace","operationId":"getApiNamespacesResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces/{id}":{"get":{"tags":["Namespaces"],"summary":"Get single namespace","operationId":"getApiNamespacesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Namespaces"],"summary":"Update namespace","operationId":"putApiNamespacesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Namespaces"],"summary":"Delete namespace","operationId":"deleteApiNamespacesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces/{id}/children":{"post":{"tags":["Namespaces"],"summary":"Create child namespace","operationId":"postApiNamespacesByidChildren","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces/{id}/customer-tag":{"put":{"tags":["Namespaces"],"summary":"Namespace-level customer tag management","operationId":"putApiNamespacesByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Namespaces"],"summary":"List customer tag","operationId":"getApiNamespacesByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Namespaces"],"summary":"Delete customer tag","operationId":"deleteApiNamespacesByidCustomerTag","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/namespaces/{id}/tree":{"get":{"tags":["Namespaces"],"summary":"Get namespace tree","operationId":"getApiNamespacesByidTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{deviceId}/traffic":{"get":{"tags":["Network devices"],"summary":"List traffic","operationId":"getApiNetworkDevicesBydeviceidTraffic","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}":{"get":{"tags":["Network devices"],"summary":"Get network device","operationId":"getApiNetworkDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Network devices"],"summary":"Update network device","operationId":"putApiNetworkDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Network devices"],"summary":"Delete network device","operationId":"deleteApiNetworkDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}/block":{"post":{"tags":["Network devices"],"summary":"Create block","operationId":"postApiNetworkDevicesByidBlock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}/classify":{"post":{"tags":["Network devices"],"summary":"Device Security Classification, Blocking, Presence Log","operationId":"postApiNetworkDevicesByidClassify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}/link-agent":{"post":{"tags":["Network devices"],"summary":"Create link agent","operationId":"postApiNetworkDevicesByidLinkAgent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}/presence-log":{"get":{"tags":["Network devices"],"summary":"List presence log","operationId":"getApiNetworkDevicesByidPresenceLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-devices/{id}/unblock":{"post":{"tags":["Network devices"],"summary":"Create unblock","operationId":"postApiNetworkDevicesByidUnblock","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-notes":{"post":{"tags":["Network notes"],"summary":"Notes","operationId":"postApiNetworkNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Network notes"],"summary":"List network notes","operationId":"getApiNetworkNotes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-notes/{id}":{"delete":{"tags":["Network notes"],"summary":"Delete network note","operationId":"deleteApiNetworkNotesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-snmp/{id}":{"get":{"tags":["Network snmp"],"summary":"Get network snmp","operationId":"getApiNetworkSnmpByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Network snmp"],"summary":"Update network snmp","operationId":"putApiNetworkSnmpByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Network snmp"],"summary":"Delete network snmp","operationId":"deleteApiNetworkSnmpByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/network-traffic/ingest":{"post":{"tags":["Network traffic"],"summary":"--- Flow Data Ingest (token-based, no JWT required) ---","operationId":"postApiNetworkTrafficIngest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks":{"post":{"tags":["Networks"],"summary":"Networks CRUD","operationId":"postApiNetworks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Networks"],"summary":"List networks","operationId":"getApiNetworks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}":{"get":{"tags":["Networks"],"summary":"Get network","operationId":"getApiNetworksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Networks"],"summary":"Update network","operationId":"putApiNetworksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Networks"],"summary":"Delete network","operationId":"deleteApiNetworksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/cleanup-unseen":{"post":{"tags":["Networks"],"summary":"Remove devices not seen in N+ days","description":"**Access:** admin on the network.\n\nA dry run unless `dry_run` is false AND `expect` (the count the preview showed) is given; more candidates than `expect` = 400, preview again. Never removed: devices linked to an agent, classified (any flag but unknown), blocked, manually edited, or with notes. A never-seen device counts from when it was added. Each removal is the ordinary device delete (presence history and notes go with it) and is written to the activity log.","operationId":"postApiNetworksByidCleanupUnseen","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean","description":"Default true"},"older_than_days":{"type":"integer","description":"Default 90, from 30 to 3650"},"expect":{"type":"integer","description":"Required to apply: the number of devices the preview listed"}}}}}},"responses":{"200":{"description":"{older_than_days, count, kept_linked_agents, kept_classified_noted_or_edited, devices (first 50), applied, deleted}","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"older_than_days out of range, expect missing, or the list changed since the preview","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Admin access to the network required","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/explorers":{"get":{"tags":["Networks"],"summary":"Explorer agents (failover management)","operationId":"getApiNetworksByidExplorers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Networks"],"summary":"Create explorers","operationId":"postApiNetworksByidExplorers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Networks"],"summary":"Update explorers","operationId":"putApiNetworksByidExplorers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/explorers/{agentId}":{"delete":{"tags":["Networks"],"summary":"Delete explorer","operationId":"deleteApiNetworksByidExplorersByagentid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/ping":{"post":{"tags":["Networks"],"summary":"Create ping","operationId":"postApiNetworksByidPing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/scan":{"post":{"tags":["Networks"],"summary":"Scan & Ping","operationId":"postApiNetworksByidScan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/scan-history":{"get":{"tags":["Networks"],"summary":"List scan history","operationId":"getApiNetworksByidScanHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{id}/scan-results":{"post":{"tags":["Networks"],"summary":"Scan results reporting (from agent via agent key)","operationId":"postApiNetworksByidScanResults","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/devices":{"get":{"tags":["Networks"],"summary":"List devices on a network","description":"**Access:** view on the network.\n\nWithout `seen` every device is returned (unchanged behaviour). `seen=active` leaves out devices not seen within the network's `hide_unseen_after_days` (default 14, 0 = never); devices linked to an agent, classified suspicious or dangerous, or blocked are never left out. Each device carries `seen_status` (`active`/`stale`). With `since` the call returns only devices changed after that time plus counts (total, online, offline, active, hidden_unseen) and ignores the other filters.\n\nSee Network Discovery (network-discovery.md).","operationId":"getApiNetworksBynetworkidDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"seen","in":"query","required":false,"schema":{"type":"string","enum":["active","stale","all"]},"description":"active | stale | all. Absent = all"},{"name":"identity","in":"query","required":false,"schema":{"type":"string","enum":["identified","unidentified","ambiguous","stale"]},"description":"identified | unidentified | ambiguous | stale"},{"name":"security_flag","in":"query","required":false,"schema":{"type":"string"},"description":"One flag or a comma-separated list (trusted, known, unknown, foreign, suspicious, dangerous)"},{"name":"is_online","in":"query","required":false,"schema":{"type":"boolean"},"description":"Only online (true) or offline (false) devices"},{"name":"is_blocked","in":"query","required":false,"schema":{"type":"boolean"},"description":"Only blocked (true) or unblocked (false) devices"},{"name":"device_type","in":"query","required":false,"schema":{"type":"string"},"description":"One type or a comma-separated list"},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Matches hostname, IP address or manufacturer"},{"name":"since","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 time: delta mode"}],"responses":{"200":{"description":"Devices (array), or {changed, total, online, offline, active, hidden_unseen, last_update} with since","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}},"400":{"description":"Unknown seen or identity value","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Network not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Networks"],"summary":"Create devices","operationId":"postApiNetworksBynetworkidDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/flow-collectors":{"post":{"tags":["Networks"],"summary":"--- Flow Collectors ---","operationId":"postApiNetworksBynetworkidFlowCollectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Networks"],"summary":"List flow collectors","operationId":"getApiNetworksBynetworkidFlowCollectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/noise-map":{"get":{"tags":["Networks"],"summary":"--- Noise Map & Traffic Queries ---","operationId":"getApiNetworksBynetworkidNoiseMap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/presence-log":{"get":{"tags":["Networks"],"summary":"List presence log","operationId":"getApiNetworksBynetworkidPresenceLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/snmp":{"post":{"tags":["Networks"],"summary":"--- SNMP Configuration ---","operationId":"postApiNetworksBynetworkidSnmp","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Networks"],"summary":"List snmp","operationId":"getApiNetworksBynetworkidSnmp","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/networks/{networkId}/traffic-summary":{"get":{"tags":["Networks"],"summary":"List traffic summary","operationId":"getApiNetworksBynetworkidTrafficSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"networkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/aggregate":{"post":{"tags":["Nl"],"summary":"Execute a natural language aggregation query","operationId":"postApiNlAggregate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/config":{"get":{"tags":["Nl"],"summary":"Get NL configuration","operationId":"getApiNlConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Nl"],"summary":"Update NL configuration","operationId":"patchApiNlConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/endpoints/{id}/hints":{"get":{"tags":["Nl"],"summary":"Get field hints for an endpoint","operationId":"getApiNlEndpointsByidHints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Nl"],"summary":"Update field hints for an endpoint","operationId":"putApiNlEndpointsByidHints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/history":{"get":{"tags":["Nl"],"summary":"Get query history","operationId":"getApiNlHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/history/{id}/feedback":{"post":{"tags":["Nl"],"summary":"Submit feedback on a query","operationId":"postApiNlHistoryByidFeedback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/query":{"post":{"tags":["Nl"],"summary":"Execute a natural language query","operationId":"postApiNlQuery","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/saved":{"get":{"tags":["Nl"],"summary":"List saved queries","operationId":"getApiNlSaved","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Nl"],"summary":"Save a query","operationId":"postApiNlSaved","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/saved/{id}":{"delete":{"tags":["Nl"],"summary":"Delete a saved query","operationId":"deleteApiNlSavedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/nl/suggestions":{"get":{"tags":["Nl"],"summary":"Get query suggestions","operationId":"getApiNlSuggestions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notarizations":{"get":{"tags":["Notarizations"],"summary":"List ALL the user's notarizations across endpoints (one query).","operationId":"getApiNotarizations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notarizations/verify-hash":{"post":{"tags":["Notarizations"],"summary":"--- Public hash verification (no auth, rate-limited) ---","operationId":"postApiNotarizationsVerifyHash","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notarizations/{id}":{"get":{"tags":["Notarizations"],"summary":"--- Individual notarization operations ---","operationId":"getApiNotarizationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notarizations/{id}/attestation":{"get":{"tags":["Notarizations"],"summary":"List attestation","operationId":"getApiNotarizationsByidAttestation","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notarizations/{id}/verify":{"get":{"tags":["Notarizations"],"summary":"List verify","operationId":"getApiNotarizationsByidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications":{"get":{"tags":["Notifications"],"summary":"List notifications","operationId":"getApiNotifications","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Notifications"],"summary":"Create a notification","operationId":"postApiNotifications","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/config":{"get":{"tags":["Notifications"],"summary":"second copy of them that can disagree.","operationId":"getApiNotificationsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Notifications"],"summary":"Update config","operationId":"putApiNotificationsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/config/operators":{"get":{"tags":["Notifications"],"summary":"List operators","operationId":"getApiNotificationsConfigOperators","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/config/targets":{"get":{"tags":["Notifications"],"summary":"List targets","operationId":"getApiNotificationsConfigTargets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/config/triggers":{"get":{"tags":["Notifications"],"summary":"Get notification configuration options","operationId":"getApiNotificationsConfigTriggers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox":{"post":{"tags":["Notifications"],"summary":"way to make any of it fire for its own records.","operationId":"postApiNotificationsInbox","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Notifications"],"summary":"List inbox","operationId":"getApiNotificationsInbox","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox/read":{"delete":{"tags":["Notifications"],"summary":"Delete read","operationId":"deleteApiNotificationsInboxRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox/read-all":{"post":{"tags":["Notifications"],"summary":"Create read all","operationId":"postApiNotificationsInboxReadAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox/unread-count":{"get":{"tags":["Notifications"],"summary":"List unread count","operationId":"getApiNotificationsInboxUnreadCount","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox/{id}":{"delete":{"tags":["Notifications"],"summary":"Delete inbox","operationId":"deleteApiNotificationsInboxByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/inbox/{id}/read":{"put":{"tags":["Notifications"],"summary":"Update read","operationId":"putApiNotificationsInboxByidRead","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/logs":{"get":{"tags":["Notifications"],"summary":"Get notification logs","operationId":"getApiNotificationsLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/preferences":{"get":{"tags":["Notifications"],"summary":"List preferences","operationId":"getApiNotificationsPreferences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Notifications"],"summary":"Update preferences","operationId":"putApiNotificationsPreferences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/preview-template":{"post":{"tags":["Notifications"],"summary":"Preview template rendering","operationId":"postApiNotificationsPreviewTemplate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/targets":{"get":{"tags":["Notifications"],"summary":"List notification targets","operationId":"getApiNotificationsTargets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Notifications"],"summary":"Create a notification target","operationId":"postApiNotificationsTargets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/targets/{id}":{"get":{"tags":["Notifications"],"summary":"Get a notification target","operationId":"getApiNotificationsTargetsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Notifications"],"summary":"Update a notification target","operationId":"putApiNotificationsTargetsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Notifications"],"summary":"Delete a notification target","operationId":"deleteApiNotificationsTargetsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/targets/{id}/test":{"post":{"tags":["Notifications"],"summary":"Test a notification target","operationId":"postApiNotificationsTargetsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/validate-rrule":{"post":{"tags":["Notifications"],"summary":"Validate RRULE format","operationId":"postApiNotificationsValidateRrule","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/{id}":{"get":{"tags":["Notifications"],"summary":"as `@uid:[0-9]+` elsewhere in these routes.","operationId":"getApiNotificationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Notifications"],"summary":"Update a notification","operationId":"putApiNotificationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Notifications"],"summary":"Delete a notification","operationId":"deleteApiNotificationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/{id}/copy":{"post":{"tags":["Notifications"],"summary":"Copy a notification","operationId":"postApiNotificationsByidCopy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/{id}/logs":{"get":{"tags":["Notifications"],"summary":"Get logs for a specific notification","operationId":"getApiNotificationsByidLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/{id}/toggle":{"post":{"tags":["Notifications"],"summary":"Toggle notification active status","operationId":"postApiNotificationsByidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/notifications/{id}/trigger":{"post":{"tags":["Notifications"],"summary":"Manually trigger a notification","operationId":"postApiNotificationsByidTrigger","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/oauth/connections":{"get":{"tags":["Oauth"],"summary":"Connection management (authenticated user): list + revoke connected clients (#318 Phase 3)","operationId":"getApiOauthConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/oauth/connections/{clientId}/revoke":{"post":{"tags":["Oauth"],"summary":"Create revoke","operationId":"postApiOauthConnectionsByclientidRevoke","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"clientId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations":{"get":{"tags":["Organizations"],"summary":"List organizations","operationId":"getApiOrganizations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Organizations"],"summary":"Create organizations","operationId":"postApiOrganizations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/capability-catalog":{"get":{"tags":["Organizations"],"summary":"in v1.312.1028: the org-by-id handler answered with a malformed-UUID 400.","operationId":"getApiOrganizationsCapabilityCatalog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/invitations/{token}/accept":{"post":{"tags":["Organizations"],"summary":"SECURITY FIX: Accept invitation requires token in URL path","operationId":"postApiOrganizationsInvitationsBytokenAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Organizations"],"summary":"Shows a nice HTML page whether logged in or not","operationId":"getApiOrganizationsInvitationsBytokenAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{id}":{"get":{"tags":["Organizations"],"summary":"Get organization","operationId":"getApiOrganizationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Organizations"],"summary":"Update organization","operationId":"putApiOrganizationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Organizations"],"summary":"Delete organization","operationId":"deleteApiOrganizationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{id}/invitations":{"get":{"tags":["Organizations"],"summary":"Organization invitations","operationId":"getApiOrganizationsByidInvitations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{id}/members":{"get":{"tags":["Organizations"],"summary":"Organization members","operationId":"getApiOrganizationsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Organizations"],"summary":"Create members","operationId":"postApiOrganizationsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{id}/transfer":{"post":{"tags":["Organizations"],"summary":"Transfer ownership","operationId":"postApiOrganizationsByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{id}/usage":{"get":{"tags":["Organizations"],"summary":"Organization usage and quotas - SECURITY FIX: Route now calls existing getUsage method","operationId":"getApiOrganizationsByidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/auth-gateways":{"post":{"tags":["Organizations"],"summary":"--- Organization gateway management ---","operationId":"postApiOrganizationsByorgidAuthGateways","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Organizations"],"summary":"List auth gateways","operationId":"getApiOrganizationsByorgidAuthGateways","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/billing":{"get":{"tags":["Organizations"],"summary":"List billing","operationId":"getApiOrganizationsByorgidBilling","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/billing/invoices":{"get":{"tags":["Organizations"],"summary":"List invoices","operationId":"getApiOrganizationsByorgidBillingInvoices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/billing/payment-link":{"post":{"tags":["Organizations"],"summary":"because that is the card an organisation invoice is actually charged to.","operationId":"postApiOrganizationsByorgidBillingPaymentLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/billing/settings":{"get":{"tags":["Organizations"],"summary":"List settings","operationId":"getApiOrganizationsByorgidBillingSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Organizations"],"summary":"Update settings","operationId":"putApiOrganizationsByorgidBillingSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/billing/validate-vat":{"post":{"tags":["Organizations"],"summary":"Create validate vat","operationId":"postApiOrganizationsByorgidBillingValidateVat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/features":{"get":{"tags":["Organizations"],"summary":"--- Organization: Features ---","operationId":"getApiOrganizationsByorgidFeatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/features/{key}":{"delete":{"tags":["Organizations"],"summary":"Delete feature","operationId":"deleteApiOrganizationsByorgidFeaturesBykey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/features/{key}/subscribe":{"post":{"tags":["Organizations"],"summary":"Create subscribe","operationId":"postApiOrganizationsByorgidFeaturesBykeySubscribe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/file-access-log":{"get":{"tags":["Organizations"],"summary":"member been doing\". Gated on org owner/admin inside the service.","operationId":"getApiOrganizationsByorgidFileAccessLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/invitations/{inviteId}":{"delete":{"tags":["Organizations"],"summary":"Delete invitation","operationId":"deleteApiOrganizationsByorgidInvitationsByinviteid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"inviteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/members/{userId}":{"put":{"tags":["Organizations"],"summary":"Update member","operationId":"putApiOrganizationsByorgidMembersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Organizations"],"summary":"Delete member","operationId":"deleteApiOrganizationsByorgidMembersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/members/{userId}/billing-exempt":{"put":{"tags":["Organizations"],"summary":"different decisions.","operationId":"putApiOrganizationsByorgidMembersByuseridBillingExempt","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/members/{userId}/capabilities":{"put":{"tags":["Organizations"],"summary":"actions rather than two meanings of one PUT.","operationId":"putApiOrganizationsByorgidMembersByuseridCapabilities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/organizations/{orgId}/package":{"get":{"tags":["Organizations"],"summary":"--- Organization: Package ---","operationId":"getApiOrganizationsByorgidPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Organizations"],"summary":"Create package","operationId":"postApiOrganizationsByorgidPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/package-purchases/{pid}":{"get":{"tags":["Package purchases"],"summary":"Polled by the window while the 3-D Secure page is open.","operationId":"getApiPackagePurchasesBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/package-purchases/{pid}/cancel":{"post":{"tags":["Package purchases"],"summary":"anyone who may buy for the payer. A payment that went through is honoured.","operationId":"postApiPackagePurchasesBypidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/packages":{"get":{"tags":["Packages"],"summary":"--- Public (no authentication required) ---","operationId":"getApiPackages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/packages/{slug}":{"get":{"tags":["Packages"],"summary":"Get package","operationId":"getApiPackagesByslug","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payment-processors/supported":{"get":{"tags":["Payment processors"],"summary":"Payment Processors","operationId":"getApiPaymentProcessorsSupported","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts":{"get":{"tags":["Payments"],"summary":"---- Accounts (user JWT required) ----","operationId":"getApiPaymentsAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Payments"],"summary":"Create accounts","operationId":"postApiPaymentsAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}":{"get":{"tags":["Payments"],"summary":"Get account","operationId":"getApiPaymentsAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Payments"],"summary":"Update account","operationId":"putApiPaymentsAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Payments"],"summary":"Delete account","operationId":"deleteApiPaymentsAccountsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/charges":{"post":{"tags":["Payments"],"summary":"---- Charges + refunds ----","operationId":"postApiPaymentsAccountsByidCharges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Payments"],"summary":"List charges","operationId":"getApiPaymentsAccountsByidCharges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/charges/{chargeId}":{"get":{"tags":["Payments"],"summary":"Get charge","operationId":"getApiPaymentsAccountsByidChargesBychargeid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chargeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/charges/{chargeId}/refund":{"post":{"tags":["Payments"],"summary":"Create refund","operationId":"postApiPaymentsAccountsByidChargesBychargeidRefund","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"chargeId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/connected-accounts":{"get":{"tags":["Payments"],"summary":"---- Connect sub-accounts (mode='connect_platform' only) ----","operationId":"getApiPaymentsAccountsByidConnectedAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Payments"],"summary":"Create connected accounts","operationId":"postApiPaymentsAccountsByidConnectedAccounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/connected-accounts/{connectedId}/onboarding-link":{"post":{"tags":["Payments"],"summary":"Create onboarding link","operationId":"postApiPaymentsAccountsByidConnectedAccountsByconnectedidOnboardingLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"connectedId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/connected-accounts/{connectedId}/refresh":{"post":{"tags":["Payments"],"summary":"Create refresh","operationId":"postApiPaymentsAccountsByidConnectedAccountsByconnectedidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"connectedId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/payments/accounts/{id}/verify":{"post":{"tags":["Payments"],"summary":"Create verify","operationId":"postApiPaymentsAccountsByidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/categories":{"get":{"tags":["Pdf"],"summary":"Template categories","operationId":"getApiPdfCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/documents":{"get":{"tags":["Pdf"],"summary":"Documents (generated PDFs)","operationId":"getApiPdfDocuments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/documents/{id}":{"get":{"tags":["Pdf"],"summary":"Get document","operationId":"getApiPdfDocumentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Pdf"],"summary":"Delete document","operationId":"deleteApiPdfDocumentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/documents/{id}/download":{"get":{"tags":["Pdf"],"summary":"List download","operationId":"getApiPdfDocumentsByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/generate":{"post":{"tags":["Pdf"],"summary":"PDF Generation","operationId":"postApiPdfGenerate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/settings":{"get":{"tags":["Pdf"],"summary":"User PDF settings (branding)","operationId":"getApiPdfSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Pdf"],"summary":"Update settings","operationId":"putApiPdfSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/templates":{"get":{"tags":["Pdf"],"summary":"Templates","operationId":"getApiPdfTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Pdf"],"summary":"Create templates","operationId":"postApiPdfTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/templates/{id}":{"get":{"tags":["Pdf"],"summary":"Get template","operationId":"getApiPdfTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Pdf"],"summary":"Update template","operationId":"putApiPdfTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Pdf"],"summary":"Delete template","operationId":"deleteApiPdfTemplatesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pdf/usage":{"get":{"tags":["Pdf"],"summary":"PDF usage","operationId":"getApiPdfUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/performance/recommendations/{recId}/apply":{"post":{"tags":["Performance"],"summary":"Apply a recommendation","operationId":"postApiPerformanceRecommendationsByrecidApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"recId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/performance/recommendations/{recId}/dismiss":{"post":{"tags":["Performance"],"summary":"Dismiss a recommendation","operationId":"postApiPerformanceRecommendationsByrecidDismiss","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"recId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/permissions":{"get":{"tags":["Permissions"],"summary":"--- Permission Definitions ---","operationId":"getApiPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipeline-observability/dashboard":{"get":{"tags":["Pipeline observability"],"summary":"operator tooling that shows operator-level state, and it should say so.","operationId":"getApiPipelineObservabilityDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipeline-observability/failures":{"get":{"tags":["Pipeline observability"],"summary":"List failures","operationId":"getApiPipelineObservabilityFailures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipeline-observability/health":{"get":{"tags":["Pipeline observability"],"summary":"List health","operationId":"getApiPipelineObservabilityHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipeline-observability/runs":{"get":{"tags":["Pipeline observability"],"summary":"List runs","operationId":"getApiPipelineObservabilityRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipeline-observability/timeline":{"get":{"tags":["Pipeline observability"],"summary":"List timeline","operationId":"getApiPipelineObservabilityTimeline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines":{"get":{"tags":["Pipelines"],"summary":"============================================","operationId":"getApiPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Pipelines"],"summary":"Create pipelines","operationId":"postApiPipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/runs/{runId}":{"get":{"tags":["Pipelines"],"summary":"Get run","operationId":"getApiPipelinesRunsByrunid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/runs/{runId}/cancel":{"post":{"tags":["Pipelines"],"summary":"Create cancel","operationId":"postApiPipelinesRunsByrunidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/{id}":{"get":{"tags":["Pipelines"],"summary":"Get pipeline","operationId":"getApiPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Pipelines"],"summary":"Update pipeline","operationId":"putApiPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Pipelines"],"summary":"Delete pipeline","operationId":"deleteApiPipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/{id}/execute":{"post":{"tags":["Pipelines"],"summary":"Create execute","operationId":"postApiPipelinesByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/{id}/runs":{"get":{"tags":["Pipelines"],"summary":"List runs","operationId":"getApiPipelinesByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pipelines/{id}/validate":{"post":{"tags":["Pipelines"],"summary":"Create validate","operationId":"postApiPipelinesByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/categories":{"get":{"tags":["Plugin marketplace"],"summary":"List categories","operationId":"getApiPluginMarketplaceCategories","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/categories/{slug}":{"get":{"tags":["Plugin marketplace"],"summary":"Get a category","operationId":"getApiPluginMarketplaceCategoriesByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/featured":{"get":{"tags":["Plugin marketplace"],"summary":"Get featured plugins","operationId":"getApiPluginMarketplaceFeatured","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/install":{"post":{"tags":["Plugin marketplace"],"summary":"Install a plugin","operationId":"postApiPluginMarketplaceInstall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/installations":{"get":{"tags":["Plugin marketplace"],"summary":"List user's installations","operationId":"getApiPluginMarketplaceInstallations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/installations/{id}":{"get":{"tags":["Plugin marketplace"],"summary":"Get a single installation","operationId":"getApiPluginMarketplaceInstallationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Plugin marketplace"],"summary":"Uninstall a plugin","operationId":"deleteApiPluginMarketplaceInstallationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/installations/{id}/config":{"put":{"tags":["Plugin marketplace"],"summary":"Update installation configuration","operationId":"putApiPluginMarketplaceInstallationsByidConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/installations/{id}/update":{"post":{"tags":["Plugin marketplace"],"summary":"Update an installation to a new version","operationId":"postApiPluginMarketplaceInstallationsByidUpdate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/my-plugins":{"get":{"tags":["Plugin marketplace"],"summary":"List user's published plugins","operationId":"getApiPluginMarketplaceMyPlugins","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins":{"get":{"tags":["Plugin marketplace"],"summary":"List/search plugins","operationId":"getApiPluginMarketplacePlugins","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}":{"get":{"tags":["Plugin marketplace"],"summary":"Get plugin details","operationId":"getApiPluginMarketplacePluginsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Plugin marketplace"],"summary":"Update plugin metadata","operationId":"patchApiPluginMarketplacePluginsByslug","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}/analytics":{"get":{"tags":["Plugin marketplace"],"summary":"Get plugin analytics (for authors)","operationId":"getApiPluginMarketplacePluginsByslugAnalytics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}/publish-keys":{"get":{"tags":["Plugin marketplace"],"summary":"List publish keys for a plugin (owner auth)","operationId":"getApiPluginMarketplacePluginsByslugPublishKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Plugin marketplace"],"summary":"Create a new publish key (owner auth)","operationId":"postApiPluginMarketplacePluginsByslugPublishKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}/publish-keys/{keyId}":{"delete":{"tags":["Plugin marketplace"],"summary":"Revoke a publish key (owner auth)","operationId":"deleteApiPluginMarketplacePluginsByslugPublishKeysBykeyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}/reviews":{"get":{"tags":["Plugin marketplace"],"summary":"List reviews for a plugin (public)","operationId":"getApiPluginMarketplacePluginsByslugReviews","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Plugin marketplace"],"summary":"Submit a review","operationId":"postApiPluginMarketplacePluginsByslugReviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/plugins/{slug}/versions":{"post":{"tags":["Plugin marketplace"],"summary":"Publish a new version","operationId":"postApiPluginMarketplacePluginsByslugVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/publish":{"post":{"tags":["Plugin marketplace"],"summary":"Publish a new plugin","operationId":"postApiPluginMarketplacePublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/reviews/{id}":{"delete":{"tags":["Plugin marketplace"],"summary":"Delete a review","operationId":"deleteApiPluginMarketplaceReviewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/reviews/{id}/vote":{"post":{"tags":["Plugin marketplace"],"summary":"Vote on review helpfulness","operationId":"postApiPluginMarketplaceReviewsByidVote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/plugin-marketplace/stats":{"get":{"tags":["Plugin marketplace"],"summary":"Get marketplace stats","operationId":"getApiPluginMarketplaceStats","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles":{"get":{"tags":["Portable bundles"],"summary":"List bundles","operationId":"getApiPortableBundles","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/export":{"post":{"tags":["Portable bundles"],"summary":"Create export bundle","operationId":"postApiPortableBundlesExport","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/import":{"post":{"tags":["Portable bundles"],"summary":"Create import bundle","operationId":"postApiPortableBundlesImport","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/{id}":{"get":{"tags":["Portable bundles"],"summary":"Get single bundle (static routes before parameterized)","operationId":"getApiPortableBundlesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Portable bundles"],"summary":"Delete bundle","operationId":"deleteApiPortableBundlesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/{id}/download":{"get":{"tags":["Portable bundles"],"summary":"Download bundle file","operationId":"getApiPortableBundlesByidDownload","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/{id}/manifest":{"get":{"tags":["Portable bundles"],"summary":"Get bundle manifest","operationId":"getApiPortableBundlesByidManifest","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/portable-bundles/{id}/start":{"post":{"tags":["Portable bundles"],"summary":"server-issued, so the upload happens between create and start).","operationId":"postApiPortableBundlesByidStart","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/presence":{"delete":{"tags":["Presence"],"summary":"Delete presence","operationId":"deleteApiPresence","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/presence/cursor":{"post":{"tags":["Presence"],"summary":"Create cursor","operationId":"postApiPresenceCursor","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/presence/endpoint/{endpointId}":{"get":{"tags":["Presence"],"summary":"Get endpoint","operationId":"getApiPresenceEndpointByendpointid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/presence/endpoint/{endpointId}/record/{recordId}":{"get":{"tags":["Presence"],"summary":"Get record","operationId":"getApiPresenceEndpointByendpointidRecordByrecordid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/presence/heartbeat":{"post":{"tags":["Presence"],"summary":"Presence","operationId":"postApiPresenceHeartbeat","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pricing":{"get":{"tags":["Pricing"],"summary":"Public pricing \u2014 no authentication required","operationId":"getApiPricing","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-jobs":{"get":{"tags":["Processing jobs"],"summary":"Processing Jobs - CRUD","operationId":"getApiProcessingJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-jobs/{jobId}":{"get":{"tags":["Processing jobs"],"summary":"Get processing job","operationId":"getApiProcessingJobsByjobid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-jobs/{jobId}/cancel":{"post":{"tags":["Processing jobs"],"summary":"Processing Jobs - action routes BEFORE parameterized routes","operationId":"postApiProcessingJobsByjobidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-jobs/{jobId}/retry":{"post":{"tags":["Processing jobs"],"summary":"Create retry","operationId":"postApiProcessingJobsByjobidRetry","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-rules":{"post":{"tags":["Processing rules"],"summary":"Auto-Processing Rules - CRUD","operationId":"postApiProcessingRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Processing rules"],"summary":"List processing rules","operationId":"getApiProcessingRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing-rules/{ruleId}":{"get":{"tags":["Processing rules"],"summary":"Get processing rule","operationId":"getApiProcessingRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Processing rules"],"summary":"Update processing rule","operationId":"putApiProcessingRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Processing rules"],"summary":"Delete processing rule","operationId":"deleteApiProcessingRulesByruleid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/processing/capabilities":{"get":{"tags":["Processing"],"summary":"Capabilities (no auth required)","operationId":"getApiProcessingCapabilities","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/products/{slug}/advisories":{"get":{"tags":["Products"],"summary":"List advisories","operationId":"getApiProductsByslugAdvisories","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/products/{slug}/advisories/rss":{"get":{"tags":["Products"],"summary":"List rss","operationId":"getApiProductsByslugAdvisoriesRss","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/products/{slug}/download/latest":{"get":{"tags":["Updates"],"summary":"Permanent latest-download link (public products)","description":"Redirects (302) to the latest released artifact. Refused with 403 `license_required` for a license-gated product: use the update check.","operationId":"getApiProductsByslugDownloadLatest","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"schema":{"type":"string"}},{"name":"channel","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect to the artifact"},"403":{"description":"License-gated product (`error.reason: license_required`)"},"404":{"description":"Not a public product, or nothing released"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/products/{slug}/latest":{"get":{"tags":["Updates"],"summary":"Latest released version and its signed artifacts","description":"The latest `released` version on a channel and ONLY the artifacts whose Ed25519 signature verifies (unsigned, unverifiable and retired-key signatures are left out and counted in `unsigned_excluded`). Anonymous for public products (rate-limited per client IP); private products need the owner's JWT or app token (anonymous: 401, others: 404); license-gated products answer 403 `license_required` except to the owner. Download URLs carry a short-lived `expires`+`sig` pair when the download endpoint would refuse a bare URL. `format=text` returns tab-separated lines (`product`, `version`, `channel`, `published_at`, `key <key_id> <public_key>`, `artifact <platform> <filename> <size> <sha256> <key_id> <signature> <url>`; errors as `error <status> <message>`).","operationId":"getApiProductsByslugLatest","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"channel","in":"query","required":false,"schema":{"type":"string"},"description":"Default: the product's default channel"},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","enum":["json","text"]}}],"responses":{"200":{"description":"Version, channel, signing_keys[], artifacts[] {platform, filename, size_bytes, sha256, signature, signature_algorithm, key_id, manifest, manifest_signature, download_url}, unsigned_excluded, download_urls_expire_at"},"400":{"description":"Invalid `format` or `channel`"},"401":{"description":"Not a public product and no credential (also for a product that does not exist)"},"403":{"description":"License-gated product (`error.reason: license_required`)"},"404":{"description":"Nothing released on the channel, or a private product the caller does not own"},"429":{"description":"Anonymous rate limit; honour Retry-After"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/products/{slug}/signing-key":{"get":{"tags":["Products"],"summary":"fully public so clients can verify signatures without phoning home.","operationId":"getApiProductsByslugSigningKey","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/provenance-signatures/verify-chain/{recordId}":{"get":{"tags":["Provenance signatures"],"summary":"Get verify chain","operationId":"getApiProvenanceSignaturesVerifyChainByrecordid","security":[],"parameters":[{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/*":{"get":{"tags":["Pub"],"summary":"List/Search records (handles paths like /pub/company/cases/customers)","operationId":"getApiPub","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Pub"],"summary":"Create record","operationId":"postApiPub","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Pub"],"summary":"Update record (path must end with UUID)","operationId":"putApiPub","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Pub"],"summary":"Delete record (path must end with UUID)","operationId":"deleteApiPub","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/_files/{alias}":{"post":{"tags":["Pub"],"summary":"Create  file","operationId":"postApiPubAppByslugFilesByalias","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/_files/{alias}/upload":{"post":{"tags":["Pub"],"summary":"Create upload","operationId":"postApiPubAppByslugFilesByaliasUpload","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/_files/{alias}/{fileId}":{"get":{"tags":["Pub"],"summary":"Get  file","operationId":"getApiPubAppByslugFilesByaliasByfileid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/_files/{alias}/{fileId}/open":{"get":{"tags":["Pub"],"summary":"List open","operationId":"getApiPubAppByslugFilesByaliasByfileidOpen","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/_me":{"get":{"tags":["Pub"],"summary":"List  me","operationId":"getApiPubAppByslugMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/fn/{function}":{"post":{"tags":["Pub"],"summary":"the response carries the function's output. See FunctionService::invokeAsAppCall().","operationId":"postApiPubAppByslugFnByfunction","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"function","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/{endpoint}":{"get":{"tags":["Pub"],"summary":"Get app","operationId":"getApiPubAppByslugByendpoint","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Pub"],"summary":"Create app","operationId":"postApiPubAppByslugByendpoint","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/pub/app/{slug}/{endpoint}/{id}":{"get":{"tags":["Pub"],"summary":"Get app","operationId":"getApiPubAppByslugByendpointByid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Pub"],"summary":"Update app","operationId":"putApiPubAppByslugByendpointByid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Pub"],"summary":"Delete app","operationId":"deleteApiPubAppByslugByendpointByid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/public/marketplace/apps":{"get":{"tags":["Public"],"summary":"Public catalogue listing of published apps.","operationId":"getApiPublicMarketplaceApps","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/public/marketplace/apps/{idOrSlug}":{"get":{"tags":["Public"],"summary":"Public detail for one published app (by slug or UUID).","operationId":"getApiPublicMarketplaceAppsByidorslug","security":[],"parameters":[{"name":"idOrSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers":{"post":{"tags":["Publishers"],"summary":"Publishers","operationId":"postApiPublishers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers/me":{"get":{"tags":["Publishers"],"summary":"List me","operationId":"getApiPublishersMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers/{id}":{"put":{"tags":["Publishers"],"summary":"Update publisher","operationId":"putApiPublishersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers/{publisherId}/email-config":{"post":{"tags":["Publishers"],"summary":"Publisher Email Configuration","operationId":"postApiPublishersBypublisheridEmailConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Publishers"],"summary":"List email config","operationId":"getApiPublishersBypublisheridEmailConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Publishers"],"summary":"Delete email config","operationId":"deleteApiPublishersBypublisheridEmailConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers/{publisherId}/email-config/test":{"post":{"tags":["Publishers"],"summary":"Create test","operationId":"postApiPublishersBypublisheridEmailConfigTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/publishers/{publisherId}/payment-processors":{"post":{"tags":["Publishers"],"summary":"Create payment processors","operationId":"postApiPublishersBypublisheridPaymentProcessors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Publishers"],"summary":"List payment processors","operationId":"getApiPublishersBypublisheridPaymentProcessors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"publisherId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push-subscriptions":{"post":{"tags":["Push subscriptions"],"summary":"--- Push Subscriptions (Reverse API) ---","operationId":"postApiPushSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Push subscriptions"],"summary":"List push subscriptions","operationId":"getApiPushSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push-subscriptions/{id}":{"get":{"tags":["Push subscriptions"],"summary":"Get push subscription","operationId":"getApiPushSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Push subscriptions"],"summary":"Update push subscription","operationId":"putApiPushSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Push subscriptions"],"summary":"Delete push subscription","operationId":"deleteApiPushSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push-subscriptions/{id}/deliveries":{"get":{"tags":["Push subscriptions"],"summary":"List deliveries","operationId":"getApiPushSubscriptionsByidDeliveries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push-subscriptions/{id}/test":{"post":{"tags":["Push subscriptions"],"summary":"Create test","operationId":"postApiPushSubscriptionsByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/badge/reset":{"post":{"tags":["Push"],"summary":"Create reset","operationId":"postApiPushBadgeReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/devices":{"post":{"tags":["Push"],"summary":"Device CRUD","operationId":"postApiPushDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Push"],"summary":"List devices","operationId":"getApiPushDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/devices/unregister":{"post":{"tags":["Push"],"summary":"Create unregister","operationId":"postApiPushDevicesUnregister","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/devices/{id}":{"get":{"tags":["Push"],"summary":"Parameterized routes AFTER static routes","operationId":"getApiPushDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Push"],"summary":"Delete device","operationId":"deleteApiPushDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/logs":{"get":{"tags":["Push"],"summary":"List logs","operationId":"getApiPushLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/send":{"post":{"tags":["Push"],"summary":"back to. Use this one only when the notification IS the message.","operationId":"postApiPushSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/test":{"post":{"tags":["Push"],"summary":"Create test","operationId":"postApiPushTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/push/vapid-public-key":{"get":{"tags":["Push"],"summary":"subscribe before any user context exists.","operationId":"getApiPushVapidPublicKey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/bulk":{"post":{"tags":["Quarantine"],"summary":"Create bulk","operationId":"postApiQuarantineBulk","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/rules/{id}":{"put":{"tags":["Quarantine"],"summary":"Quarantine rule management (parameterized routes)","operationId":"putApiQuarantineRulesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Quarantine"],"summary":"Delete rule","operationId":"deleteApiQuarantineRulesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/rules/{id}/toggle":{"post":{"tags":["Quarantine"],"summary":"Create toggle","operationId":"postApiQuarantineRulesByidToggle","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/stats":{"get":{"tags":["Quarantine"],"summary":"Static routes MUST come before parameterized @id routes","operationId":"getApiQuarantineStats","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/stats-by-endpoint":{"get":{"tags":["Quarantine"],"summary":"Quarantine stats grouped by endpoint, one query (admin global overview).","operationId":"getApiQuarantineStatsByEndpoint","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/{id}":{"get":{"tags":["Quarantine"],"summary":"Quarantine record detail and actions","operationId":"getApiQuarantineByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/{id}/approve":{"post":{"tags":["Quarantine"],"summary":"Create approve","operationId":"postApiQuarantineByidApprove","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/quarantine/{id}/reject":{"post":{"tags":["Quarantine"],"summary":"Create reject","operationId":"postApiQuarantineByidReject","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries":{"get":{"tags":["Queries"],"summary":"List queries","operationId":"getApiQueries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Queries"],"summary":"Create queries","operationId":"postApiQueries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/analyze":{"post":{"tags":["Queries"],"summary":"Create analyze","operationId":"postApiQueriesAnalyze","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/compare":{"post":{"tags":["Queries"],"summary":"Create compare","operationId":"postApiQueriesCompare","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/execute":{"post":{"tags":["Queries"],"summary":"============================================","operationId":"postApiQueriesExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/explain":{"post":{"tags":["Queries"],"summary":"Create explain","operationId":"postApiQueriesExplain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/slow":{"get":{"tags":["Queries"],"summary":"Slow query log","operationId":"getApiQueriesSlow","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/validate":{"post":{"tags":["Queries"],"summary":"Create validate","operationId":"postApiQueriesValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/{id}":{"get":{"tags":["Queries"],"summary":"FUTURE literal under this prefix, not just the one that was reported.","operationId":"getApiQueriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Queries"],"summary":"Update querie","operationId":"putApiQueriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Queries"],"summary":"Delete querie","operationId":"deleteApiQueriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queries/{id}/execute":{"post":{"tags":["Queries"],"summary":"Create execute","operationId":"postApiQueriesByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/query-cost/explain":{"post":{"tags":["Query cost"],"summary":"so query-cost uses /api/query-cost/explain to avoid route conflict.","operationId":"postApiQueryCostExplain","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queues":{"get":{"tags":["Queues"],"summary":"List queues","operationId":"getApiQueues","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Queues"],"summary":"Create queues","operationId":"postApiQueues","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queues/stats":{"get":{"tags":["Queues"],"summary":"Aggregate queue stats - must be before @id route to avoid matching 'stats' as UUID","operationId":"getApiQueuesStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queues/{id}":{"get":{"tags":["Queues"],"summary":"Get queue","operationId":"getApiQueuesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Queues"],"summary":"Update queue","operationId":"putApiQueuesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Queues"],"summary":"Delete queue","operationId":"deleteApiQueuesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queues/{id}/stats":{"get":{"tags":["Queues"],"summary":"List stats","operationId":"getApiQueuesByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/queues/{id}/test":{"post":{"tags":["Queues"],"summary":"Create test","operationId":"postApiQueuesByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/alerts":{"get":{"tags":["Ransomware protection"],"summary":"Alerts","operationId":"getApiRansomwareProtectionAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/alerts/{id}/acknowledge":{"post":{"tags":["Ransomware protection"],"summary":"Create acknowledge","operationId":"postApiRansomwareProtectionAlertsByidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/dashboard":{"get":{"tags":["Ransomware protection"],"summary":"Dashboard","operationId":"getApiRansomwareProtectionDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/holds":{"get":{"tags":["Ransomware protection"],"summary":"Holds \u2014 authenticated routes","operationId":"getApiRansomwareProtectionHolds","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/holds/cancel/{token}":{"get":{"tags":["Ransomware protection"],"summary":"Holds \u2014 cancel by token (no auth, email link) MUST be before /@id routes","operationId":"getApiRansomwareProtectionHoldsCancelBytoken","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/holds/{id}":{"get":{"tags":["Ransomware protection"],"summary":"Get hold","operationId":"getApiRansomwareProtectionHoldsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/holds/{id}/cancel":{"post":{"tags":["Ransomware protection"],"summary":"Create cancel","operationId":"postApiRansomwareProtectionHoldsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/policy":{"get":{"tags":["Ransomware protection"],"summary":"Policy","operationId":"getApiRansomwareProtectionPolicy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Ransomware protection"],"summary":"Update policy","operationId":"putApiRansomwareProtectionPolicy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/resume-deletes":{"post":{"tags":["Ransomware protection"],"summary":"Resume deletes","operationId":"postApiRansomwareProtectionResumeDeletes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/ransomware-protection/velocity":{"get":{"tags":["Ransomware protection"],"summary":"Velocity","operationId":"getApiRansomwareProtectionVelocity","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rate-limits/alerts":{"get":{"tags":["Rate limits"],"summary":"List alerts","operationId":"getApiRateLimitsAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rate-limits/config":{"get":{"tags":["Rate limits"],"summary":"List config","operationId":"getApiRateLimitsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rate-limits/overview":{"get":{"tags":["Rate limits"],"summary":"List overview","operationId":"getApiRateLimitsOverview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rate-limits/quota":{"get":{"tags":["Rate limits"],"summary":"List quota","operationId":"getApiRateLimitsQuota","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rate-limits/timeseries":{"get":{"tags":["Rate limits"],"summary":"List timeseries","operationId":"getApiRateLimitsTimeseries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/cursor":{"post":{"tags":["Realtime"],"summary":"--- Cursor Positions ---","operationId":"postApiRealtimeChannelsBychannelidCursor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/cursors":{"get":{"tags":["Realtime"],"summary":"List cursors","operationId":"getApiRealtimeChannelsBychannelidCursors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/events":{"post":{"tags":["Realtime"],"summary":"--- Custom Ephemeral Events ---","operationId":"postApiRealtimeChannelsBychannelidEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/read-receipt":{"post":{"tags":["Realtime"],"summary":"--- Read Receipts ---","operationId":"postApiRealtimeChannelsBychannelidReadReceipt","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/read-receipts":{"get":{"tags":["Realtime"],"summary":"List read receipts","operationId":"getApiRealtimeChannelsBychannelidReadReceipts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/typing":{"get":{"tags":["Realtime"],"summary":"List typing","operationId":"getApiRealtimeChannelsBychannelidTyping","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/typing/start":{"post":{"tags":["Realtime"],"summary":"--- Typing Indicators ---","operationId":"postApiRealtimeChannelsBychannelidTypingStart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/channels/{channelId}/typing/stop":{"post":{"tags":["Realtime"],"summary":"Create stop","operationId":"postApiRealtimeChannelsBychannelidTypingStop","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"channelId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/realtime/heartbeat":{"post":{"tags":["Realtime"],"summary":"--- Heartbeat ---","operationId":"postApiRealtimeHeartbeat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/reconciliation/dashboard":{"get":{"tags":["Reconciliation"],"summary":"Dashboard must come before parameterized @id","operationId":"getApiReconciliationDashboard","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/reconciliation/schedules":{"post":{"tags":["Reconciliation"],"summary":"Reconciliation Schedules","operationId":"postApiReconciliationSchedules","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Reconciliation"],"summary":"List schedules","operationId":"getApiReconciliationSchedules","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/reconciliation/schedules/{id}":{"put":{"tags":["Reconciliation"],"summary":"Update schedule","operationId":"putApiReconciliationSchedulesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Reconciliation"],"summary":"Delete schedule","operationId":"deleteApiReconciliationSchedulesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-subscriptions":{"get":{"tags":["Record subscriptions"],"summary":"---------------------------------------------------------------------------","operationId":"getApiRecordSubscriptions","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-subscriptions/{id}":{"get":{"tags":["Record subscriptions"],"summary":"Get record subscription","operationId":"getApiRecordSubscriptionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Record subscriptions"],"summary":"Update record subscription","operationId":"putApiRecordSubscriptionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Record subscriptions"],"summary":"Delete record subscription","operationId":"deleteApiRecordSubscriptionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-subscriptions/{id}/events":{"get":{"tags":["Record subscriptions"],"summary":"List events","operationId":"getApiRecordSubscriptionsByidEvents","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-ttl/configs":{"post":{"tags":["Record ttl"],"summary":"Create configs","operationId":"postApiRecordTtlConfigs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Record ttl"],"summary":"List configs","operationId":"getApiRecordTtlConfigs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-ttl/configs/{id}":{"get":{"tags":["Record ttl"],"summary":"Get config","operationId":"getApiRecordTtlConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Record ttl"],"summary":"Update config","operationId":"putApiRecordTtlConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Record ttl"],"summary":"Delete config","operationId":"deleteApiRecordTtlConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-ttl/configs/{id}/log":{"get":{"tags":["Record ttl"],"summary":"List log","operationId":"getApiRecordTtlConfigsByidLog","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-views/{id}":{"get":{"tags":["Record views"],"summary":"Get record view","operationId":"getApiRecordViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Record views"],"summary":"Update record view","operationId":"putApiRecordViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Record views"],"summary":"Delete record view","operationId":"deleteApiRecordViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/record-views/{id}/set-default":{"post":{"tags":["Record views"],"summary":"Resource routes (not endpoint-scoped)","operationId":"postApiRecordViewsByidSetDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/records/bulk-restore":{"post":{"tags":["Records"],"summary":"Create bulk restore","operationId":"postApiRecordsBulkRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/records/duplicate":{"post":{"tags":["Records"],"summary":"Create duplicate","operationId":"postApiRecordsDuplicate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-record-runs/{runId}":{"get":{"tags":["Recurring record runs"],"summary":"Get recurring record run","operationId":"getApiRecurringRecordRunsByrunid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records":{"get":{"tags":["Recurring Records"],"summary":"List ALL the user's schedules across endpoints (one query). Before @id.","operationId":"getApiRecurringRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/stats":{"get":{"tags":["Recurring Records"],"summary":"Stats (must be before @id routes to avoid conflict)","operationId":"getApiRecurringRecordsStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/{id}":{"get":{"tags":["Recurring Records"],"summary":"Schedule CRUD","operationId":"getApiRecurringRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Recurring Records"],"summary":"Update recurring record","operationId":"putApiRecurringRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Recurring Records"],"summary":"Delete recurring record","operationId":"deleteApiRecurringRecordsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/{id}/dry-run":{"post":{"tags":["Recurring Records"],"summary":"Create dry run","operationId":"postApiRecurringRecordsByidDryRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/{id}/runs":{"get":{"tags":["Recurring Records"],"summary":"Run history","operationId":"getApiRecurringRecordsByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/{id}/toggle":{"post":{"tags":["Recurring Records"],"summary":"Schedule actions","operationId":"postApiRecurringRecordsByidToggle","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/recurring-records/{id}/trigger":{"post":{"tags":["Recurring Records"],"summary":"Create trigger","operationId":"postApiRecurringRecordsByidTrigger","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/regions":{"get":{"tags":["Regions"],"summary":"List all regions","operationId":"getApiRegions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Regions"],"summary":"Create a new region (admin only)","operationId":"postApiRegions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/regions/health":{"get":{"tags":["Regions"],"summary":"Get region health matrix","operationId":"getApiRegionsHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/regions/{id}":{"get":{"tags":["Regions"],"summary":"Get a specific region","operationId":"getApiRegionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Regions"],"summary":"Update a region (admin only)","operationId":"patchApiRegionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Regions"],"summary":"Delete a region (admin only)","operationId":"deleteApiRegionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations":{"post":{"tags":["Relations"],"summary":"Attach a child entity to a parent","operationId":"postApiRelations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Relations"],"summary":"Detach a child entity from a parent","operationId":"deleteApiRelations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/bulk":{"post":{"tags":["Relations"],"summary":"Bulk attach multiple children","operationId":"postApiRelationsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/endpoint/{endpointId}":{"get":{"tags":["Relations"],"summary":"List all relation types for an endpoint","operationId":"getApiRelationsEndpointByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/move":{"post":{"tags":["Relations"],"summary":"Move a child from one parent to another","operationId":"postApiRelationsMove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/{endpointId}/{recordId}/children":{"get":{"tags":["Relations"],"summary":"Get children of a record","operationId":"getApiRelationsByendpointidByrecordidChildren","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/{endpointId}/{recordId}/parents":{"get":{"tags":["Relations"],"summary":"Get parents of a record","operationId":"getApiRelationsByendpointidByrecordidParents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Relations"],"summary":"Detach from all parents","operationId":"deleteApiRelationsByendpointidByrecordidParents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/relations/{id}":{"delete":{"tags":["Relations"],"summary":"Detach a relation by ID","operationId":"deleteApiRelationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Relations"],"summary":"Update a relation","operationId":"putApiRelationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/advisories/{id}":{"get":{"tags":["Release manager"],"summary":"Get advisorie","operationId":"getApiReleaseManagerAdvisoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Release manager"],"summary":"Update advisorie","operationId":"putApiReleaseManagerAdvisoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Release manager"],"summary":"Delete advisorie","operationId":"deleteApiReleaseManagerAdvisoriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/advisories/{id}/affected":{"get":{"tags":["Release manager"],"summary":"---- Affected version ranges ----","operationId":"getApiReleaseManagerAdvisoriesByidAffected","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create affected","operationId":"postApiReleaseManagerAdvisoriesByidAffected","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/advisories/{id}/publish":{"post":{"tags":["Release manager"],"summary":"Create publish","operationId":"postApiReleaseManagerAdvisoriesByidPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/advisory-affected/{id}":{"delete":{"tags":["Release manager"],"summary":"Delete advisory affected","operationId":"deleteApiReleaseManagerAdvisoryAffectedByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/artifacts/{id}":{"delete":{"tags":["Release manager"],"summary":"Delete artifact","operationId":"deleteApiReleaseManagerArtifactsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/artifacts/{id}/download":{"get":{"tags":["Release manager"],"summary":"#207 will add signed short-lived URLs for proper access control.","operationId":"getApiReleaseManagerArtifactsByidDownload","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/changelog-entries/{id}":{"put":{"tags":["Release manager"],"summary":"Update changelog entrie","operationId":"putApiReleaseManagerChangelogEntriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Release manager"],"summary":"Delete changelog entrie","operationId":"deleteApiReleaseManagerChangelogEntriesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/channels/{id}":{"delete":{"tags":["Release manager"],"summary":"Delete channel","operationId":"deleteApiReleaseManagerChannelsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/clients/{id}":{"put":{"tags":["Release manager"],"summary":"Update client","operationId":"putApiReleaseManagerClientsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/deployments/{id}/rollback":{"post":{"tags":["Release manager"],"summary":"Create rollback","operationId":"postApiReleaseManagerDeploymentsByidRollback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/environments/{id}":{"put":{"tags":["Release manager"],"summary":"Update environment","operationId":"putApiReleaseManagerEnvironmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Release manager"],"summary":"Delete environment","operationId":"deleteApiReleaseManagerEnvironmentsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/environments/{id}/deploy":{"post":{"tags":["Release manager"],"summary":"---- Deployments ----","operationId":"postApiReleaseManagerEnvironmentsByidDeploy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/environments/{id}/deployments":{"get":{"tags":["Release manager"],"summary":"List deployments","operationId":"getApiReleaseManagerEnvironmentsByidDeployments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products":{"get":{"tags":["Release manager"],"summary":"// ---- Products ----","operationId":"getApiReleaseManagerProducts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create products","operationId":"postApiReleaseManagerProducts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}":{"get":{"tags":["Release manager"],"summary":"Get product","operationId":"getApiReleaseManagerProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Release manager"],"summary":"Update product","operationId":"putApiReleaseManagerProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Release manager"],"summary":"Delete product","operationId":"deleteApiReleaseManagerProductsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/advisories":{"get":{"tags":["Release manager"],"summary":"---- Advisory CRUD (auth required) ----","operationId":"getApiReleaseManagerProductsByidAdvisories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create advisories","operationId":"postApiReleaseManagerProductsByidAdvisories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/changelog":{"get":{"tags":["Release manager"],"summary":"---- Changelog aggregation ----","operationId":"getApiReleaseManagerProductsByidChangelog","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/channels":{"get":{"tags":["Release manager"],"summary":"---- Channels ----","operationId":"getApiReleaseManagerProductsByidChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create channels","operationId":"postApiReleaseManagerProductsByidChannels","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/clients":{"get":{"tags":["Release manager"],"summary":"---- Registered clients ----","operationId":"getApiReleaseManagerProductsByidClients","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/compare":{"get":{"tags":["Release manager"],"summary":"List compare","operationId":"getApiReleaseManagerProductsByidCompare","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/environments":{"get":{"tags":["Release manager"],"summary":"---- Environments ----","operationId":"getApiReleaseManagerProductsByidEnvironments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create environments","operationId":"postApiReleaseManagerProductsByidEnvironments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/releases":{"get":{"tags":["Release manager"],"summary":"---- Releases ----","operationId":"getApiReleaseManagerProductsByidReleases","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create releases","operationId":"postApiReleaseManagerProductsByidReleases","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/rollout-summary":{"get":{"tags":["Release manager"],"summary":"---- Rollout dashboard summary ----","operationId":"getApiReleaseManagerProductsByidRolloutSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/rss":{"get":{"tags":["Release manager"],"summary":"List rss","operationId":"getApiReleaseManagerProductsByidRss","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/signing-keys":{"get":{"tags":["Release manager"],"summary":"---- Signing keys ----","operationId":"getApiReleaseManagerProductsByidSigningKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/signing-keys/retire-rotating":{"post":{"tags":["Release manager"],"summary":"Create retire rotating","operationId":"postApiReleaseManagerProductsByidSigningKeysRetireRotating","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/signing-keys/rotate":{"post":{"tags":["Release manager"],"summary":"Create rotate","operationId":"postApiReleaseManagerProductsByidSigningKeysRotate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{id}/tokens":{"get":{"tags":["Release manager"],"summary":"---- Update tokens ----","operationId":"getApiReleaseManagerProductsByidTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create tokens","operationId":"postApiReleaseManagerProductsByidTokens","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{productId}/rings":{"get":{"tags":["Release manager"],"summary":"All releases' rings for a product, keyed by release id, in one query.","operationId":"getApiReleaseManagerProductsByproductidRings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/products/{slug}/downloads":{"get":{"tags":["Release manager"],"summary":"UIs, e.g. the admin ERP page). Auth required; resolves any visibility.","operationId":"getApiReleaseManagerProductsByslugDownloads","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}":{"get":{"tags":["Release manager"],"summary":"Get release","operationId":"getApiReleaseManagerReleasesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Release manager"],"summary":"Update release","operationId":"putApiReleaseManagerReleasesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Release manager"],"summary":"Delete release","operationId":"deleteApiReleaseManagerReleasesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/artifacts":{"get":{"tags":["Release manager"],"summary":"---- Artifacts ----","operationId":"getApiReleaseManagerReleasesByidArtifacts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create artifacts","operationId":"postApiReleaseManagerReleasesByidArtifacts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/changelog":{"get":{"tags":["Release manager"],"summary":"---- Changelog entries ----","operationId":"getApiReleaseManagerReleasesByidChangelog","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create changelog","operationId":"postApiReleaseManagerReleasesByidChangelog","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/changelog/auto-draft":{"post":{"tags":["Release manager"],"summary":"Create auto draft","operationId":"postApiReleaseManagerReleasesByidChangelogAutoDraft","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/compatibility-check":{"get":{"tags":["Release manager"],"summary":"List compatibility check","operationId":"getApiReleaseManagerReleasesByidCompatibilityCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/deprecate":{"post":{"tags":["Release manager"],"summary":"Create deprecate","operationId":"postApiReleaseManagerReleasesByidDeprecate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/health":{"get":{"tags":["Release manager"],"summary":"List health","operationId":"getApiReleaseManagerReleasesByidHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/publish":{"post":{"tags":["Release manager"],"summary":"Create publish","operationId":"postApiReleaseManagerReleasesByidPublish","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/requirements":{"get":{"tags":["Release manager"],"summary":"---- Cross-product compatibility requirements ----","operationId":"getApiReleaseManagerReleasesByidRequirements","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Release manager"],"summary":"Create requirements","operationId":"postApiReleaseManagerReleasesByidRequirements","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/rings":{"get":{"tags":["Release manager"],"summary":"List rings","operationId":"getApiReleaseManagerReleasesByidRings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Release manager"],"summary":"Update rings","operationId":"putApiReleaseManagerReleasesByidRings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/rings/{order}/advance":{"post":{"tags":["Release manager"],"summary":"Create advance","operationId":"postApiReleaseManagerReleasesByidRingsByorderAdvance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"order","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/releases/{id}/yank":{"post":{"tags":["Release manager"],"summary":"Create yank","operationId":"postApiReleaseManagerReleasesByidYank","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/requirements/{id}":{"delete":{"tags":["Release manager"],"summary":"Delete requirement","operationId":"deleteApiReleaseManagerRequirementsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/release-manager/tokens/{id}":{"delete":{"tags":["Release manager"],"summary":"Delete token","operationId":"deleteApiReleaseManagerTokensByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes":{"post":{"tags":["Replay cassettes"],"summary":"Cassette CRUD","operationId":"postApiReplayCassettes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Replay cassettes"],"summary":"List replay cassettes","operationId":"getApiReplayCassettes","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/results/{resultId}/approve":{"post":{"tags":["Replay cassettes"],"summary":"Result approval","operationId":"postApiReplayCassettesResultsByresultidApprove","security":[],"parameters":[{"name":"resultId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/runs/{runId}":{"get":{"tags":["Replay cassettes"],"summary":"Replay runs \u2014 static paths first","operationId":"getApiReplayCassettesRunsByrunid","security":[],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/runs/{runId}/results":{"get":{"tags":["Replay cassettes"],"summary":"List results","operationId":"getApiReplayCassettesRunsByrunidResults","security":[],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/{id}":{"get":{"tags":["Replay cassettes"],"summary":"Parameterized cassette routes","operationId":"getApiReplayCassettesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Replay cassettes"],"summary":"Delete replay cassette","operationId":"deleteApiReplayCassettesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/{id}/replay":{"post":{"tags":["Replay cassettes"],"summary":"Create replay","operationId":"postApiReplayCassettesByidReplay","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/{id}/requests":{"get":{"tags":["Replay cassettes"],"summary":"List requests","operationId":"getApiReplayCassettesByidRequests","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replay-cassettes/{id}/stop":{"post":{"tags":["Replay cassettes"],"summary":"Create stop","operationId":"postApiReplayCassettesByidStop","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replication/conflicts/{id}":{"get":{"tags":["Replication"],"summary":"Get a specific conflict","operationId":"getApiReplicationConflictsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/replication/conflicts/{id}/resolve":{"post":{"tags":["Replication"],"summary":"Resolve a conflict","operationId":"postApiReplicationConflictsByidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/requests":{"get":{"tags":["Requests"],"summary":"============================================","operationId":"getApiRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/requests/config":{"get":{"tags":["Requests"],"summary":"List config","operationId":"getApiRequestsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Requests"],"summary":"Update config","operationId":"putApiRequestsConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/requests/{id}":{"get":{"tags":["Requests"],"summary":"Get request","operationId":"getApiRequestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/requests/{id}/replay":{"post":{"tags":["Requests"],"summary":"Create replay","operationId":"postApiRequestsByidReplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resonance-rules":{"get":{"tags":["Resonance rules"],"summary":"List ALL the user's resonance rules across endpoints (one query).","operationId":"getApiResonanceRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resonance-rules/{id}":{"get":{"tags":["Resonance rules"],"summary":"Standalone rule CRUD","operationId":"getApiResonanceRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Resonance rules"],"summary":"Update resonance rule","operationId":"putApiResonanceRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Resonance rules"],"summary":"Delete resonance rule","operationId":"deleteApiResonanceRulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resonance-rules/{id}/evaluate":{"post":{"tags":["Resonance rules"],"summary":"Evaluation","operationId":"postApiResonanceRulesByidEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resonance-rules/{id}/events":{"get":{"tags":["Resonance rules"],"summary":"Events","operationId":"getApiResonanceRulesByidEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools":{"post":{"tags":["Resource pools"],"summary":"Pool CRUD","operationId":"postApiResourcePools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Resource pools"],"summary":"List resource pools","operationId":"getApiResourcePools","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}":{"get":{"tags":["Resource pools"],"summary":"Main resource routes AFTER sub-resource routes","operationId":"getApiResourcePoolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Resource pools"],"summary":"Update resource pool","operationId":"putApiResourcePoolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Resource pools"],"summary":"Delete resource pool","operationId":"deleteApiResourcePoolsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/adjust":{"post":{"tags":["Resource pools"],"summary":"Create adjust","operationId":"postApiResourcePoolsByidAdjust","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/balance":{"get":{"tags":["Resource pools"],"summary":"Sub-resource routes BEFORE /@id to prevent FlightPHP matching them as an ID","operationId":"getApiResourcePoolsByidBalance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/ledger":{"get":{"tags":["Resource pools"],"summary":"List ledger","operationId":"getApiResourcePoolsByidLedger","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/links":{"post":{"tags":["Resource pools"],"summary":"Endpoint links","operationId":"postApiResourcePoolsByidLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Resource pools"],"summary":"List links","operationId":"getApiResourcePoolsByidLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/links/{linkId}":{"delete":{"tags":["Resource pools"],"summary":"Delete link","operationId":"deleteApiResourcePoolsByidLinksBylinkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"linkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/renew":{"post":{"tags":["Resource pools"],"summary":"Create renew","operationId":"postApiResourcePoolsByidRenew","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/renewal":{"get":{"tags":["Resource pools"],"summary":"Renewal","operationId":"getApiResourcePoolsByidRenewal","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Resource pools"],"summary":"Update renewal","operationId":"putApiResourcePoolsByidRenewal","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/stats":{"get":{"tags":["Resource pools"],"summary":"List stats","operationId":"getApiResourcePoolsByidStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-pools/{id}/thresholds":{"get":{"tags":["Resource pools"],"summary":"Thresholds","operationId":"getApiResourcePoolsByidThresholds","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Resource pools"],"summary":"Update thresholds","operationId":"putApiResourcePoolsByidThresholds","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-shares":{"post":{"tags":["Resource shares"],"summary":"Create resource shares","operationId":"postApiResourceShares","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-shares/lookup-user":{"get":{"tags":["Resource shares"],"summary":"List lookup user","operationId":"getApiResourceSharesLookupUser","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-shares/shared-with-me":{"get":{"tags":["Resource shares"],"summary":"List shared with me","operationId":"getApiResourceSharesSharedWithMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-shares/{shareId}":{"put":{"tags":["Resource shares"],"summary":"Update resource share","operationId":"putApiResourceSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Resource shares"],"summary":"Delete resource share","operationId":"deleteApiResourceSharesByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/resource-shares/{type}/{id}":{"get":{"tags":["Resource shares"],"summary":"Get resource share","operationId":"getApiResourceSharesBytypeByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/response-pipelines":{"get":{"tags":["Response pipelines"],"summary":"--- Global pipeline routes ---","operationId":"getApiResponsePipelines","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/response-pipelines/{id}":{"get":{"tags":["Response pipelines"],"summary":"Get response pipeline","operationId":"getApiResponsePipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Response pipelines"],"summary":"Update response pipeline","operationId":"putApiResponsePipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Response pipelines"],"summary":"Delete response pipeline","operationId":"deleteApiResponsePipelinesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/response-pipelines/{id}/preview":{"post":{"tags":["Response pipelines"],"summary":"--- Preview ---","operationId":"postApiResponsePipelinesByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/retention-policies":{"post":{"tags":["Retention policies"],"summary":"----- Data Retention Routes -----","operationId":"postApiRetentionPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Retention policies"],"summary":"List retention policies","operationId":"getApiRetentionPolicies","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/retention-policies/{id}":{"get":{"tags":["Retention policies"],"summary":"Get retention policie","operationId":"getApiRetentionPoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Retention policies"],"summary":"Update retention policie","operationId":"putApiRetentionPoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Retention policies"],"summary":"Delete retention policie","operationId":"deleteApiRetentionPoliciesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/retention-policies/{id}/preview":{"get":{"tags":["Retention policies"],"summary":"List preview","operationId":"getApiRetentionPoliciesByidPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/revisions/modes":{"get":{"tags":["Revisions"],"summary":"Get available revision control modes","operationId":"getApiRevisionsModes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/rls-policies/{policyId}":{"get":{"tags":["Rls policies"],"summary":"Get rls policie","operationId":"getApiRlsPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Rls policies"],"summary":"Update rls policie","operationId":"putApiRlsPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Rls policies"],"summary":"Delete rls policie","operationId":"deleteApiRlsPoliciesBypolicyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"policyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/roles":{"post":{"tags":["Roles"],"summary":"--- Role CRUD ---","operationId":"postApiRoles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Roles"],"summary":"List roles","operationId":"getApiRoles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/roles/{id}":{"get":{"tags":["Roles"],"summary":"Get role","operationId":"getApiRolesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Roles"],"summary":"Update role","operationId":"putApiRolesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Roles"],"summary":"Delete role","operationId":"deleteApiRolesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/roles/{id}/assignments":{"post":{"tags":["Roles"],"summary":"--- Role Assignments ---","operationId":"postApiRolesByidAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Roles"],"summary":"List assignments","operationId":"getApiRolesByidAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/roles/{roleId}/assignments/{userId}":{"delete":{"tags":["Roles"],"summary":"Delete assignment","operationId":"deleteApiRolesByroleidAssignmentsByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"roleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sandboxes":{"post":{"tags":["Sandboxes"],"summary":"============================================","operationId":"postApiSandboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sandboxes"],"summary":"List sandboxes","operationId":"getApiSandboxes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sandboxes/{id}":{"get":{"tags":["Sandboxes"],"summary":"Get sandboxe","operationId":"getApiSandboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Sandboxes"],"summary":"Delete sandboxe","operationId":"deleteApiSandboxesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sandboxes/{id}/promote":{"post":{"tags":["Sandboxes"],"summary":"Create promote","operationId":"postApiSandboxesByidPromote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sandboxes/{id}/refresh":{"post":{"tags":["Sandboxes"],"summary":"Create refresh","operationId":"postApiSandboxesByidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sandboxes/{id}/reset":{"post":{"tags":["Sandboxes"],"summary":"Create reset","operationId":"postApiSandboxesByidReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-actions":{"post":{"tags":["Scheduled actions"],"summary":"----- Scheduled Actions Routes -----","operationId":"postApiScheduledActions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Scheduled actions"],"summary":"List scheduled actions","operationId":"getApiScheduledActions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-actions/{id}":{"get":{"tags":["Scheduled actions"],"summary":"Get scheduled action","operationId":"getApiScheduledActionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scheduled actions"],"summary":"Delete scheduled action","operationId":"deleteApiScheduledActionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}":{"get":{"tags":["Scheduled mutations"],"summary":"Mutation CRUD","operationId":"getApiScheduledMutationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Scheduled mutations"],"summary":"Update scheduled mutation","operationId":"putApiScheduledMutationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scheduled mutations"],"summary":"Delete scheduled mutation","operationId":"deleteApiScheduledMutationsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}/cancel":{"post":{"tags":["Scheduled mutations"],"summary":"Mutation actions","operationId":"postApiScheduledMutationsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}/execute-now":{"post":{"tags":["Scheduled mutations"],"summary":"Create execute now","operationId":"postApiScheduledMutationsByidExecuteNow","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}/history":{"get":{"tags":["Scheduled mutations"],"summary":"List history","operationId":"getApiScheduledMutationsByidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}/pause":{"post":{"tags":["Scheduled mutations"],"summary":"Create pause","operationId":"postApiScheduledMutationsByidPause","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-mutations/{id}/resume":{"post":{"tags":["Scheduled mutations"],"summary":"Create resume","operationId":"postApiScheduledMutationsByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-reports":{"get":{"tags":["Scheduled reports"],"summary":"List scheduled reports","operationId":"getApiScheduledReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Scheduled reports"],"summary":"Create scheduled reports","operationId":"postApiScheduledReports","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-reports/runs/{runId}/download":{"get":{"tags":["Scheduled reports"],"summary":"List download","operationId":"getApiScheduledReportsRunsByrunidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-reports/{id}":{"get":{"tags":["Scheduled reports"],"summary":"Get scheduled report","operationId":"getApiScheduledReportsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Scheduled reports"],"summary":"Update scheduled report","operationId":"putApiScheduledReportsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scheduled reports"],"summary":"Delete scheduled report","operationId":"deleteApiScheduledReportsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-reports/{id}/run":{"post":{"tags":["Scheduled reports"],"summary":"Create run","operationId":"postApiScheduledReportsByidRun","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scheduled-reports/{id}/runs":{"get":{"tags":["Scheduled reports"],"summary":"List runs","operationId":"getApiScheduledReportsByidRuns","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detect":{"post":{"tags":["Schema archaeology"],"summary":"============================================","operationId":"postApiSchemaArchaeologyDetect","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detections":{"get":{"tags":["Schema archaeology"],"summary":"============================================","operationId":"getApiSchemaArchaeologyDetections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detections/{id}":{"get":{"tags":["Schema archaeology"],"summary":"Get detection","operationId":"getApiSchemaArchaeologyDetectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Schema archaeology"],"summary":"Delete detection","operationId":"deleteApiSchemaArchaeologyDetectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detections/{id}/accept":{"post":{"tags":["Schema archaeology"],"summary":"Create accept","operationId":"postApiSchemaArchaeologyDetectionsByidAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detections/{id}/reject":{"post":{"tags":["Schema archaeology"],"summary":"Create reject","operationId":"postApiSchemaArchaeologyDetectionsByidReject","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/detections/{id}/suggestions":{"get":{"tags":["Schema archaeology"],"summary":"List suggestions","operationId":"getApiSchemaArchaeologyDetectionsByidSuggestions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/signatures":{"get":{"tags":["Schema archaeology"],"summary":"============================================","operationId":"getApiSchemaArchaeologySignatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Schema archaeology"],"summary":"Create signatures","operationId":"postApiSchemaArchaeologySignatures","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-archaeology/signatures/{id}":{"get":{"tags":["Schema archaeology"],"summary":"Get signature","operationId":"getApiSchemaArchaeologySignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Schema archaeology"],"summary":"Update signature","operationId":"putApiSchemaArchaeologySignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Schema archaeology"],"summary":"Delete signature","operationId":"deleteApiSchemaArchaeologySignaturesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/jobs":{"get":{"tags":["Schema import"],"summary":"Import jobs","operationId":"getApiSchemaImportJobs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/jobs/{id}":{"get":{"tags":["Schema import"],"summary":"Get job","operationId":"getApiSchemaImportJobsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/jobs/{id}/cancel":{"post":{"tags":["Schema import"],"summary":"Create cancel","operationId":"postApiSchemaImportJobsByidCancel","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources":{"post":{"tags":["Schema import"],"summary":"Source CRUD","operationId":"postApiSchemaImportSources","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Schema import"],"summary":"List sources","operationId":"getApiSchemaImportSources","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources/{id}":{"get":{"tags":["Schema import"],"summary":"Get source","operationId":"getApiSchemaImportSourcesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Schema import"],"summary":"Update source","operationId":"putApiSchemaImportSourcesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Schema import"],"summary":"Delete source","operationId":"deleteApiSchemaImportSourcesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources/{id}/discover":{"post":{"tags":["Schema import"],"summary":"Schema discovery","operationId":"postApiSchemaImportSourcesByidDiscover","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources/{id}/import":{"post":{"tags":["Schema import"],"summary":"Import execution","operationId":"postApiSchemaImportSourcesByidImport","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources/{id}/preview":{"post":{"tags":["Schema import"],"summary":"Data preview","operationId":"postApiSchemaImportSourcesByidPreview","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/sources/{id}/schema":{"get":{"tags":["Schema import"],"summary":"List schema","operationId":"getApiSchemaImportSourcesByidSchema","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/suggest-mapping":{"post":{"tags":["Schema import"],"summary":"Mapping suggestions","operationId":"postApiSchemaImportSuggestMapping","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/schema-import/upload":{"post":{"tags":["Schema import"],"summary":"File upload","operationId":"postApiSchemaImportUpload","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks":{"post":{"tags":["Script Hooks"],"summary":"--- CRUD ---","operationId":"postApiScriptHooks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Script Hooks"],"summary":"List script hooks","operationId":"getApiScriptHooks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/examples":{"get":{"tags":["Script Hooks"],"summary":"List examples","operationId":"getApiScriptHooksExamples","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/logs":{"get":{"tags":["Script Hooks"],"summary":"--- Info endpoints (must be before /:id routes) ---","operationId":"getApiScriptHooksLogs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/triggers":{"get":{"tags":["Script Hooks"],"summary":"List triggers","operationId":"getApiScriptHooksTriggers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/{id}":{"get":{"tags":["Script Hooks"],"summary":"Get script hook","operationId":"getApiScriptHooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Script Hooks"],"summary":"Update script hook","operationId":"putApiScriptHooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Script Hooks"],"summary":"Delete script hook","operationId":"deleteApiScriptHooksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/{id}/test":{"post":{"tags":["Script Hooks"],"summary":"Create test","operationId":"postApiScriptHooksByidTest","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/script-hooks/{id}/toggle":{"post":{"tags":["Script Hooks"],"summary":"--- Actions ---","operationId":"postApiScriptHooksByidToggle","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts":{"get":{"tags":["Scripts"],"summary":"============================================","operationId":"getApiScripts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Scripts"],"summary":"Create scripts","operationId":"postApiScripts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/ssh-keys":{"get":{"tags":["Scripts"],"summary":"============================================","operationId":"getApiScriptsSshKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Scripts"],"summary":"Create ssh keys","operationId":"postApiScriptsSshKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/ssh-keys/{keyId}":{"delete":{"tags":["Scripts"],"summary":"Delete ssh key","operationId":"deleteApiScriptsSshKeysBykeyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/ssh-keys/{keyId}/public":{"get":{"tags":["Scripts"],"summary":"List public","operationId":"getApiScriptsSshKeysBykeyidPublic","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/usage":{"get":{"tags":["Scripts"],"summary":"============================================","operationId":"getApiScriptsUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}":{"get":{"tags":["Scripts"],"summary":"Get script","operationId":"getApiScriptsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Scripts"],"summary":"Update script","operationId":"putApiScriptsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scripts"],"summary":"Delete script","operationId":"deleteApiScriptsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/disable":{"post":{"tags":["Scripts"],"summary":"Create disable","operationId":"postApiScriptsByidDisable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/enable":{"post":{"tags":["Scripts"],"summary":"Create enable","operationId":"postApiScriptsByidEnable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/execute":{"post":{"tags":["Scripts"],"summary":"============================================","operationId":"postApiScriptsByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/executions":{"get":{"tags":["Scripts"],"summary":"============================================","operationId":"getApiScriptsByidExecutions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scripts"],"summary":"Delete executions","operationId":"deleteApiScriptsByidExecutions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/executions/{eid}":{"get":{"tags":["Scripts"],"summary":"Get execution","operationId":"getApiScriptsByidExecutionsByeid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"eid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/secrets":{"get":{"tags":["Scripts"],"summary":"============================================","operationId":"getApiScriptsByidSecrets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Scripts"],"summary":"Create secrets","operationId":"postApiScriptsByidSecrets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/secrets/{name}":{"put":{"tags":["Scripts"],"summary":"Update secret","operationId":"putApiScriptsByidSecretsByname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Scripts"],"summary":"Delete secret","operationId":"deleteApiScriptsByidSecretsByname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/scripts/{id}/validate":{"post":{"tags":["Scripts"],"summary":"Create validate","operationId":"postApiScriptsByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/conflicts":{"get":{"tags":["Sdk"],"summary":"List unresolved conflicts","operationId":"getApiSdkConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/conflicts/{id}/resolve":{"post":{"tags":["Sdk"],"summary":"Resolve a conflict","operationId":"postApiSdkConflictsByidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/devices":{"post":{"tags":["Sdk"],"summary":"Register or update a device","operationId":"postApiSdkDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sdk"],"summary":"List user's registered devices","operationId":"getApiSdkDevices","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/devices/{deviceId}/endpoints/{endpointId}/push":{"post":{"tags":["Sdk"],"summary":"Push batch of changes from client to server","operationId":"postApiSdkDevicesBydeviceidEndpointsByendpointidPush","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/devices/{deviceId}/endpoints/{endpointId}/state":{"get":{"tags":["Sdk"],"summary":"Get sync state for a device/endpoint pair","operationId":"getApiSdkDevicesBydeviceidEndpointsByendpointidState","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Sdk"],"summary":"Update sync state after successful sync","operationId":"patchApiSdkDevicesBydeviceidEndpointsByendpointidState","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/devices/{id}":{"delete":{"tags":["Sdk"],"summary":"Unregister a device","operationId":"deleteApiSdkDevicesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/endpoints/{endpointId}/changes":{"get":{"tags":["Sdk"],"summary":"Get changes since a sequence number","operationId":"getApiSdkEndpointsByendpointidChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/endpoints/{endpointId}/full":{"get":{"tags":["Sdk"],"summary":"Get full dataset for initial sync","operationId":"getApiSdkEndpointsByendpointidFull","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/generations/{id}":{"get":{"tags":["Sdk"],"summary":"--- Specific generation record ---","operationId":"getApiSdkGenerationsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sdk/languages":{"get":{"tags":["Sdk"],"summary":"--- Language support (must be before @id routes) ---","operationId":"getApiSdkLanguages","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search":{"post":{"tags":["Search"],"summary":"Search across all accessible endpoints","operationId":"postApiSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/group/{groupId}":{"post":{"tags":["Search"],"summary":"Search within endpoints shared with a specific group","operationId":"postApiSearchGroupBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/multiple":{"post":{"tags":["Search"],"summary":"See vault56-crm search-api-feedback.md (2026-05-08) bug 3.","operationId":"postApiSearchMultiple","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/namespace/*":{"post":{"tags":["Search"],"summary":"Search within a namespace","operationId":"postApiSearchNamespace","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/reindex/{endpoint}":{"post":{"tags":["Search"],"summary":"Reindex an endpoint (owner only)","operationId":"postApiSearchReindexByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/suggest/{endpoint}":{"get":{"tags":["Search"],"summary":"Get search suggestions/autocomplete for an endpoint","operationId":"getApiSearchSuggestByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/search/{endpoint}":{"post":{"tags":["Search"],"summary":"`POST /api/search/<literal>` routes for the reason above).","operationId":"postApiSearchByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/baselines/{subjectType}/{subjectId}":{"get":{"tags":["Security"],"summary":"Get baseline","operationId":"getApiSecurityAnomalyBaselinesBysubjecttypeBysubjectid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subjectType","in":"path","required":true,"schema":{"type":"string"}},{"name":"subjectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/check":{"post":{"tags":["Security"],"summary":"Create check","operationId":"postApiSecurityAnomalyCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/config":{"get":{"tags":["Security"],"summary":"\u2500\u2500 Backward-compatible aliases: /api/security/anomaly/* \u2500\u2500","operationId":"getApiSecurityAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Security"],"summary":"Update config","operationId":"putApiSecurityAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/events":{"get":{"tags":["Security"],"summary":"List events","operationId":"getApiSecurityAnomalyEvents","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/events/{id}":{"get":{"tags":["Security"],"summary":"Get event","operationId":"getApiSecurityAnomalyEventsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/events/{id}/resolve":{"post":{"tags":["Security"],"summary":"Create resolve","operationId":"postApiSecurityAnomalyEventsByidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/anomaly/stats":{"get":{"tags":["Security"],"summary":"List stats","operationId":"getApiSecurityAnomalyStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/dashboard":{"get":{"tags":["Security"],"summary":"List dashboard","operationId":"getApiSecurityDashboard","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/recommendations":{"get":{"tags":["Security"],"summary":"List recommendations","operationId":"getApiSecurityRecommendations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/scan":{"post":{"tags":["Security"],"summary":"Create scan","operationId":"postApiSecurityScan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/scans":{"get":{"tags":["Security"],"summary":"List scans","operationId":"getApiSecurityScans","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/scans/{id}":{"get":{"tags":["Security"],"summary":"Get scan","operationId":"getApiSecurityScansByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/security/vpn-check":{"post":{"tags":["Security"],"summary":"Check if an IP is a VPN/proxy","operationId":"postApiSecurityVpnCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/semantic-links":{"post":{"tags":["Semantic links"],"summary":"CRUD","operationId":"postApiSemanticLinks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Semantic links"],"summary":"List semantic links","operationId":"getApiSemanticLinks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/semantic-links/suggest/{endpointId}":{"get":{"tags":["Semantic links"],"summary":"Suggestions for a given endpoint","operationId":"getApiSemanticLinksSuggestByendpointid","security":[],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/semantic-links/{id}":{"get":{"tags":["Semantic links"],"summary":"Get semantic link","operationId":"getApiSemanticLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Semantic links"],"summary":"Update semantic link","operationId":"putApiSemanticLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Semantic links"],"summary":"Delete semantic link","operationId":"deleteApiSemanticLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/semantic-links/{id}/check-drift":{"post":{"tags":["Semantic links"],"summary":"Drift detection","operationId":"postApiSemanticLinksByidCheckDrift","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/semantic-links/{id}/propagate":{"post":{"tags":["Semantic links"],"summary":"Value propagation","operationId":"postApiSemanticLinksByidPropagate","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sequences":{"get":{"tags":["Sequences"],"summary":"List sequences","operationId":"getApiSequences","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions":{"post":{"tags":["Sessions"],"summary":"--- Game Session CRUD ---","operationId":"postApiSessions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sessions"],"summary":"List sessions","operationId":"getApiSessions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/join":{"post":{"tags":["Sessions"],"summary":"Create join","operationId":"postApiSessionsJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}":{"get":{"tags":["Sessions"],"summary":"Get session","operationId":"getApiSessionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Sessions"],"summary":"Update session","operationId":"putApiSessionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Sessions"],"summary":"Delete session","operationId":"deleteApiSessionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/cancel":{"post":{"tags":["Sessions"],"summary":"Create cancel","operationId":"postApiSessionsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/end":{"post":{"tags":["Sessions"],"summary":"Create end","operationId":"postApiSessionsByidEnd","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/join":{"post":{"tags":["Sessions"],"summary":"--- Join / Leave ---","operationId":"postApiSessionsByidJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/leave":{"post":{"tags":["Sessions"],"summary":"Create leave","operationId":"postApiSessionsByidLeave","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/pause":{"post":{"tags":["Sessions"],"summary":"Create pause","operationId":"postApiSessionsByidPause","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/players":{"get":{"tags":["Sessions"],"summary":"List players","operationId":"getApiSessionsByidPlayers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/players/{playerId}":{"put":{"tags":["Sessions"],"summary":"Update player","operationId":"putApiSessionsByidPlayersByplayerid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"playerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/players/{playerId}/kick":{"post":{"tags":["Sessions"],"summary":"--- Player Management ---","operationId":"postApiSessionsByidPlayersByplayeridKick","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"playerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/ready":{"post":{"tags":["Sessions"],"summary":"Create ready","operationId":"postApiSessionsByidReady","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/resume":{"post":{"tags":["Sessions"],"summary":"Create resume","operationId":"postApiSessionsByidResume","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sessions/{id}/start":{"post":{"tags":["Sessions"],"summary":"--- Session Lifecycle ---","operationId":"postApiSessionsByidStart","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings":{"get":{"tags":["Settings"],"summary":"Get all settings","operationId":"getApiSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Settings"],"summary":"Update multiple settings","operationId":"putApiSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/categories":{"get":{"tags":["Settings"],"summary":"Get available categories","operationId":"getApiSettingsCategories","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/category/{category}":{"get":{"tags":["Settings"],"summary":"Get settings by category","operationId":"getApiSettingsCategoryBycategory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/data-retention":{"put":{"tags":["Settings"],"summary":"Configure data retention settings (must be before @key catch-all)","operationId":"putApiSettingsDataRetention","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/export":{"get":{"tags":["Settings"],"summary":"Export settings","operationId":"getApiSettingsExport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/import":{"post":{"tags":["Settings"],"summary":"Import settings","operationId":"postApiSettingsImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/reset":{"post":{"tags":["Settings"],"summary":"Reset settings to defaults","operationId":"postApiSettingsReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/share-defaults":{"get":{"tags":["Settings"],"summary":"Get default share permissions","operationId":"getApiSettingsShareDefaults","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/settings/{key}":{"put":{"tags":["Settings"],"summary":"Update single setting (catch-all, must be after specific PUT routes)","operationId":"putApiSettingsBykey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data-channel/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareDataChannelByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data-channel/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Data channel transfers","operationId":"postApiShareDataChannelByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data-room/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareDataRoomByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data-room/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Data room transfers","operationId":"postApiShareDataRoomByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data/{endpoint}":{"post":{"tags":["Share"],"summary":"Share data from an endpoint","operationId":"postApiShareDataByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data/{endpoint}/{recordId}/transfer":{"post":{"tags":["Share"],"summary":"Transfer record ownership to user","operationId":"postApiShareDataByendpointByrecordidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data/{endpoint}/{recordId}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Transfer record ownership from organization to user","operationId":"postApiShareDataByendpointByrecordidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data/{endpoint}/{recordId}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Transfer record ownership to organization","operationId":"postApiShareDataByendpointByrecordidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/data/{shareId}":{"delete":{"tags":["Share"],"summary":"Revoke data share","operationId":"deleteApiShareDataByshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"shareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/activity":{"get":{"tags":["Share"],"summary":"Get share activity for an endpoint","operationId":"getApiShareEndpointByendpointidActivity","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/transfer":{"post":{"tags":["Share"],"summary":"Transfer endpoint ownership to user (supports include_sub_endpoints and transfer_data options)","operationId":"postApiShareEndpointByendpointidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Transfer endpoint ownership from organization to user","operationId":"postApiShareEndpointByendpointidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Transfer endpoint ownership to organization","operationId":"postApiShareEndpointByendpointidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/transfer/preview":{"post":{"tags":["Share"],"summary":"Preview endpoint ownership transfer (see what would be affected)","operationId":"postApiShareEndpointByendpointidTransferPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{endpointId}/{userId}":{"delete":{"tags":["Share"],"summary":"Revoke endpoint share","operationId":"deleteApiShareEndpointByendpointidByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/endpoint/{id}":{"post":{"tags":["Share"],"summary":"Share an endpoint with another user","operationId":"postApiShareEndpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Share"],"summary":"List all shares for an endpoint","operationId":"getApiShareEndpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/file-area/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareFileAreaByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/file-area/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"File area transfers","operationId":"postApiShareFileAreaByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/file/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareFileByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/file/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"File attachment transfers","operationId":"postApiShareFileByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/form/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareFormByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/form/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Public form transfers","operationId":"postApiShareFormByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/link/{endpoint}":{"post":{"tags":["Share"],"summary":"Create a share link","operationId":"postApiShareLinkByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/link/{linkId}":{"delete":{"tags":["Share"],"summary":"Deactivate a share link","operationId":"deleteApiShareLinkBylinkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"linkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/links":{"get":{"tags":["Share"],"summary":"List user's share links","operationId":"getApiShareLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/message-channel/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareMessageChannelByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/message-channel/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Message channel transfers","operationId":"postApiShareMessageChannelByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/namespace/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareNamespaceByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/namespace/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Namespace transfers","operationId":"postApiShareNamespaceByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pending":{"get":{"tags":["Share"],"summary":"Get pending shares created by the current user","operationId":"getApiSharePending","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pending-transfer/{id}":{"delete":{"tags":["Share"],"summary":"Cancel a pending transfer","operationId":"deleteApiSharePendingTransferByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pending-transfers":{"get":{"tags":["Share"],"summary":"Get pending transfers created by the current user","operationId":"getApiSharePendingTransfers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pending/{endpointId}":{"post":{"tags":["Share"],"summary":"Create a pending share for an email address","operationId":"postApiSharePendingByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pending/{pendingShareId}":{"delete":{"tags":["Share"],"summary":"Cancel a pending share","operationId":"deleteApiSharePendingBypendingshareid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"pendingShareId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pipeline/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiSharePipelineByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/pipeline/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Pipeline transfers","operationId":"postApiSharePipelineByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/request/{endpointId}":{"post":{"tags":["Share"],"summary":"Request access to an endpoint","operationId":"postApiShareRequestByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/requests/incoming":{"get":{"tags":["Share"],"summary":"Get incoming access requests (as owner)","operationId":"getApiShareRequestsIncoming","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/requests/outgoing":{"get":{"tags":["Share"],"summary":"Get outgoing access requests (as requester)","operationId":"getApiShareRequestsOutgoing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/requests/{requestId}":{"delete":{"tags":["Share"],"summary":"Cancel an access request","operationId":"deleteApiShareRequestsByrequestid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/requests/{requestId}/respond":{"post":{"tags":["Share"],"summary":"Respond to an access request (approve/reject)","operationId":"postApiShareRequestsByrequestidRespond","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/shared-with-me":{"get":{"tags":["Share"],"summary":"Alias route: tests use /api/share/shared-with-me","operationId":"getApiShareSharedWithMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/shared-with-me/records":{"get":{"tags":["Share"],"summary":"Alias route: tests use /api/share/shared-with-me/records","operationId":"getApiShareSharedWithMeRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/template/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareTemplateByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/template/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Template transfers","operationId":"postApiShareTemplateByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/templates":{"post":{"tags":["Share"],"summary":"Create a share template","operationId":"postApiShareTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Share"],"summary":"Get all share templates","operationId":"getApiShareTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/templates/{templateId}":{"get":{"tags":["Share"],"summary":"Get a specific share template","operationId":"getApiShareTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Share"],"summary":"Update a share template","operationId":"putApiShareTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Share"],"summary":"Delete a share template","operationId":"deleteApiShareTemplatesBytemplateid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/templates/{templateId}/apply":{"post":{"tags":["Share"],"summary":"Apply a template to create a share","operationId":"postApiShareTemplatesBytemplateidApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/users/recent":{"get":{"tags":["Share"],"summary":"Get recent share recipients","operationId":"getApiShareUsersRecent","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/users/search":{"get":{"tags":["Share"],"summary":"Search for users to share with","operationId":"getApiShareUsersSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/webhook/{id}/transfer-from-org":{"post":{"tags":["Share"],"summary":"Create transfer from org","operationId":"postApiShareWebhookByidTransferFromOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/webhook/{id}/transfer-to-org":{"post":{"tags":["Share"],"summary":"Webhook transfers","operationId":"postApiShareWebhookByidTransferToOrg","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/with-me":{"get":{"tags":["Share"],"summary":"Get all endpoints shared with me","operationId":"getApiShareWithMe","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/share/with-me/records":{"get":{"tags":["Share"],"summary":"Get all records shared with me","operationId":"getApiShareWithMeRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{ownerId}/{endpoint}":{"get":{"tags":["Shared"],"summary":"Format: /api/shared/{owner_id}/{endpoint} or /api/shared/{owner_id}/{namespace}/{endpoint}","operationId":"getApiSharedByowneridByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Shared"],"summary":"Create shared","operationId":"postApiSharedByowneridByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{ownerId}/{endpoint}/{id}":{"get":{"tags":["Shared"],"summary":"This route MUST stay registered before the namespace-list route.","operationId":"getApiSharedByowneridByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Shared"],"summary":"Update shared","operationId":"putApiSharedByowneridByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Shared"],"summary":"Delete shared","operationId":"deleteApiSharedByowneridByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{ownerId}/{namespace}/{endpoint}":{"get":{"tags":["Shared"],"summary":"Get shared","operationId":"getApiSharedByowneridBynamespaceByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Shared"],"summary":"Create shared","operationId":"postApiSharedByowneridBynamespaceByendpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{ownerId}/{namespace}/{endpoint}/{id}":{"get":{"tags":["Shared"],"summary":"Get shared","operationId":"getApiSharedByowneridBynamespaceByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Shared"],"summary":"Update shared","operationId":"putApiSharedByowneridBynamespaceByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Shared"],"summary":"Delete shared","operationId":"deleteApiSharedByowneridBynamespaceByendpointByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{token}":{"get":{"tags":["Shared"],"summary":"Access data via share link (READ)","operationId":"getApiSharedBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shared/{token}/{recordId}":{"put":{"tags":["Shared"],"summary":"Update data via share link (WRITE)","operationId":"putApiSharedBytokenByrecordid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/assess":{"options":{"tags":["Shield"],"summary":"OPTIONS assess","operationId":"optionsApiShieldAssess","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Shield"],"summary":"Create assess","operationId":"postApiShieldAssess","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/challenge":{"options":{"tags":["Shield"],"summary":"domain.","operationId":"optionsApiShieldChallenge","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Shield"],"summary":"List challenge","operationId":"getApiShieldChallenge","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/site-keys":{"get":{"tags":["Shield"],"summary":"---------- Tenant \u2014 site-key management (authenticated) -------------","operationId":"getApiShieldSiteKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Shield"],"summary":"Create site keys","operationId":"postApiShieldSiteKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/site-keys/{id}":{"get":{"tags":["Shield"],"summary":"Get site key","operationId":"getApiShieldSiteKeysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Shield"],"summary":"Patch site key","operationId":"patchApiShieldSiteKeysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Shield"],"summary":"Delete site key","operationId":"deleteApiShieldSiteKeysByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/site-keys/{id}/log":{"get":{"tags":["Shield"],"summary":"List log","operationId":"getApiShieldSiteKeysByidLog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/shield/site-keys/{id}/rotate":{"post":{"tags":["Shield"],"summary":"Create rotate","operationId":"postApiShieldSiteKeysByidRotate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/signing-keys":{"get":{"tags":["Signing keys"],"summary":"List signing keys","operationId":"getApiSigningKeys","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/signing-keys/register":{"post":{"tags":["Signing keys"],"summary":"--- Signing Key Management ---","operationId":"postApiSigningKeysRegister","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/signing-keys/revoke":{"post":{"tags":["Signing keys"],"summary":"Create revoke","operationId":"postApiSigningKeysRevoke","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/signing-keys/{userId}":{"get":{"tags":["Signing keys"],"summary":"Get signing key","operationId":"getApiSigningKeysByuserid","security":[],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/site-accounts/sites":{"get":{"tags":["Site accounts"],"summary":"Every Studio site the caller can manage accounts for -- the admin panel's list.","operationId":"getApiSiteAccountsSites","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/assignments":{"get":{"tags":["Sla"],"summary":"List assignments","operationId":"getApiSlaAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/breaches":{"get":{"tags":["Sla"],"summary":"--- Breaches ---","operationId":"getApiSlaBreaches","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/breaches/{breachId}/acknowledge":{"post":{"tags":["Sla"],"summary":"Create acknowledge","operationId":"postApiSlaBreachesBybreachidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"breachId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/credits":{"get":{"tags":["Sla"],"summary":"--- Credits ---","operationId":"getApiSlaCredits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/endpoints/{endpointId}":{"delete":{"tags":["Sla"],"summary":"Delete endpoint","operationId":"deleteApiSlaEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/endpoints/{endpointId}/evaluate":{"post":{"tags":["Sla"],"summary":"--- SLA Evaluation ---","operationId":"postApiSlaEndpointsByendpointidEvaluate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/endpoints/{endpointId}/health":{"get":{"tags":["Sla"],"summary":"List health","operationId":"getApiSlaEndpointsByendpointidHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/endpoints/{endpointId}/uptime":{"get":{"tags":["Sla"],"summary":"--- Uptime & Health ---","operationId":"getApiSlaEndpointsByendpointidUptime","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/status-page":{"put":{"tags":["Sla"],"summary":"--- Status Page ---","operationId":"putApiSlaStatusPage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sla"],"summary":"List status page","operationId":"getApiSlaStatusPage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/status-page/{ownerId}/public":{"get":{"tags":["Sla"],"summary":"Public status page \u2014 NO auth required","operationId":"getApiSlaStatusPageByowneridPublic","security":[],"parameters":[{"name":"ownerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/tiers":{"post":{"tags":["Sla"],"summary":"--- SLA Tier CRUD ---","operationId":"postApiSlaTiers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sla"],"summary":"List tiers","operationId":"getApiSlaTiers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/tiers/{tierId}":{"get":{"tags":["Sla"],"summary":"Get tier","operationId":"getApiSlaTiersBytierid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Sla"],"summary":"Update tier","operationId":"putApiSlaTiersBytierid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Sla"],"summary":"Delete tier","operationId":"deleteApiSlaTiersBytierid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sla/tiers/{tierId}/endpoints/{endpointId}":{"post":{"tags":["Sla"],"summary":"--- Endpoint Assignments ---","operationId":"postApiSlaTiersBytieridEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"tierId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/smart-links":{"get":{"tags":["Smart links"],"summary":"List ALL the user's smart-link rules across endpoints (one query).","operationId":"getApiSmartLinks","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/smart-links/suggestions/{id}/accept":{"post":{"tags":["Smart links"],"summary":"Create accept","operationId":"postApiSmartLinksSuggestionsByidAccept","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/smart-links/{id}":{"get":{"tags":["Smart links"],"summary":"Get smart link","operationId":"getApiSmartLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Smart links"],"summary":"Update smart link","operationId":"putApiSmartLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Smart links"],"summary":"Delete smart link","operationId":"deleteApiSmartLinksByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/smart-links/{id}/suggestions":{"get":{"tags":["Smart links"],"summary":"List suggestions","operationId":"getApiSmartLinksByidSuggestions","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots":{"get":{"tags":["Snapshots"],"summary":"Global snapshots (not tied to specific environment)","operationId":"getApiSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Snapshots"],"summary":"Create snapshots","operationId":"postApiSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots/{id}":{"get":{"tags":["Snapshots"],"summary":"Get a single snapshot","operationId":"getApiSnapshotsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Snapshots"],"summary":"Update (rename) a snapshot","operationId":"putApiSnapshotsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Snapshots"],"summary":"Delete a snapshot","operationId":"deleteApiSnapshotsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots/{id}/diff":{"get":{"tags":["Snapshots"],"summary":"Diff a snapshot against the current record state","operationId":"getApiSnapshotsByidDiff","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots/{id}/lock":{"post":{"tags":["Snapshots"],"summary":"Lock a snapshot","operationId":"postApiSnapshotsByidLock","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots/{id}/restore":{"post":{"tags":["Snapshots"],"summary":"Restore a record to a snapshot's state","operationId":"postApiSnapshotsByidRestore","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/snapshots/{id}/unlock":{"post":{"tags":["Snapshots"],"summary":"Unlock a snapshot","operationId":"postApiSnapshotsByidUnlock","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/software/catalog":{"get":{"tags":["Software"],"summary":"--- Public / Authenticated endpoints ---","operationId":"getApiSoftwareCatalog","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/software/check-update":{"get":{"tags":["Software"],"summary":"List check update","operationId":"getApiSoftwareCheckUpdate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/software/latest/{product}/{platform}/download":{"get":{"tags":["Software"],"summary":"List download","operationId":"getApiSoftwareLatestByproductByplatformDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"string"}},{"name":"platform","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/software/releases":{"get":{"tags":["Software"],"summary":"List releases","operationId":"getApiSoftwareReleases","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/software/releases/{releaseId}/download":{"get":{"tags":["Software"],"summary":"List download","operationId":"getApiSoftwareReleasesByreleaseidDownload","security":[],"parameters":[{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/spatial/distance":{"post":{"tags":["Spatial"],"summary":"------------------------------------------------------------------","operationId":"postApiSpatialDistance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/spatial/status":{"get":{"tags":["Spatial"],"summary":"Spatial status for every endpoint with spatial columns, in one query.","operationId":"getApiSpatialStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms":{"post":{"tags":["State sync"],"summary":"--- Room CRUD ---","operationId":"postApiStateSyncRooms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["State sync"],"summary":"List rooms","operationId":"getApiStateSyncRooms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}":{"get":{"tags":["State sync"],"summary":"Get room","operationId":"getApiStateSyncRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["State sync"],"summary":"Update room","operationId":"putApiStateSyncRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["State sync"],"summary":"Delete room","operationId":"deleteApiStateSyncRoomsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/delta":{"get":{"tags":["State sync"],"summary":"List delta","operationId":"getApiStateSyncRoomsByidDelta","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/heartbeat":{"post":{"tags":["State sync"],"summary":"Create heartbeat","operationId":"postApiStateSyncRoomsByidHeartbeat","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/join":{"post":{"tags":["State sync"],"summary":"--- Participants ---","operationId":"postApiStateSyncRoomsByidJoin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/leave":{"post":{"tags":["State sync"],"summary":"Create leave","operationId":"postApiStateSyncRoomsByidLeave","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/operations":{"post":{"tags":["State sync"],"summary":"Create operations","operationId":"postApiStateSyncRoomsByidOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["State sync"],"summary":"List operations","operationId":"getApiStateSyncRoomsByidOperations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/operations/batch":{"post":{"tags":["State sync"],"summary":"Create batch","operationId":"postApiStateSyncRoomsByidOperationsBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/participants":{"get":{"tags":["State sync"],"summary":"List participants","operationId":"getApiStateSyncRoomsByidParticipants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/participants/{userId}":{"delete":{"tags":["State sync"],"summary":"Delete participant","operationId":"deleteApiStateSyncRoomsByidParticipantsByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/participants/{userId}/role":{"put":{"tags":["State sync"],"summary":"Update role","operationId":"putApiStateSyncRoomsByidParticipantsByuseridRole","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/reset":{"post":{"tags":["State sync"],"summary":"Create reset","operationId":"postApiStateSyncRoomsByidReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/snapshots":{"post":{"tags":["State sync"],"summary":"--- Snapshots ---","operationId":"postApiStateSyncRoomsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["State sync"],"summary":"List snapshots","operationId":"getApiStateSyncRoomsByidSnapshots","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/snapshots/{snapshotId}/restore":{"post":{"tags":["State sync"],"summary":"Create restore","operationId":"postApiStateSyncRoomsByidSnapshotsBysnapshotidRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"snapshotId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/state-sync/rooms/{id}/state":{"get":{"tags":["State sync"],"summary":"--- State & Operations ---","operationId":"getApiStateSyncRoomsByidState","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers":{"get":{"tags":["Storage providers"],"summary":"List storage providers","operationId":"getApiStorageProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Storage providers"],"summary":"Create storage providers","operationId":"postApiStorageProviders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/available":{"get":{"tags":["Storage providers"],"summary":"IMPORTANT: /available, /selectable and /default must be registered BEFORE /@id to avoid matching as an ID","operationId":"getApiStorageProvidersAvailable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/default":{"get":{"tags":["Storage providers"],"summary":"List default","operationId":"getApiStorageProvidersDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Storage providers"],"summary":"Update default","operationId":"putApiStorageProvidersDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/selectable":{"get":{"tags":["Storage providers"],"summary":"Credential-free selector with live object-lock capability \u2014 app-token self-service (Custodia #310).","operationId":"getApiStorageProvidersSelectable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/{id}":{"get":{"tags":["Storage providers"],"summary":"Get storage provider","operationId":"getApiStorageProvidersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Storage providers"],"summary":"Update storage provider","operationId":"putApiStorageProvidersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Storage providers"],"summary":"Delete storage provider","operationId":"deleteApiStorageProvidersByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/{id}/browse":{"post":{"tags":["Storage providers"],"summary":"Browse storage provider contents","operationId":"postApiStorageProvidersByidBrowse","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/storage-providers/{id}/test":{"post":{"tags":["Storage providers"],"summary":"Create test","operationId":"postApiStorageProvidersByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/data-sources":{"get":{"tags":["Studio"],"summary":"to the open internet. Creating one requires naming those fields.","operationId":"getApiStudioDataSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/import":{"post":{"tags":["Studio"],"summary":"the zip is what the project will be made of.","operationId":"postApiStudioImport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/import-url":{"post":{"tags":["Studio"],"summary":"internal replication channel.","operationId":"postApiStudioImportUrl","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/organizations/{orgId}/wallet":{"get":{"tags":["Studio"],"summary":"The organisation's AI wallet, for its owners and admins, inside Studio.","operationId":"getApiStudioOrganizationsByorgidWallet","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/organizations/{orgId}/wallet/daily-cap":{"put":{"tags":["Studio"],"summary":"The organisation wallet's daily spending limit, shared by every member (2026-10-08).","operationId":"putApiStudioOrganizationsByorgidWalletDailyCap","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/organizations/{orgId}/wallet/my-allowance":{"post":{"tags":["Studio"],"summary":"Create my allowance","operationId":"postApiStudioOrganizationsByorgidWalletMyAllowance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/organizations/{orgId}/wallet/topup":{"post":{"tags":["Studio"],"summary":"Create topup","operationId":"postApiStudioOrganizationsByorgidWalletTopup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"orgId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/packages":{"get":{"tags":["Studio"],"summary":"List packages","operationId":"getApiStudioPackages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/packages/buy":{"post":{"tags":["Studio"],"summary":"Create buy","operationId":"postApiStudioPackagesBuy","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/packages/card-link":{"post":{"tags":["Studio"],"summary":"Create card link","operationId":"postApiStudioPackagesCardLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/pending-prompt":{"post":{"tags":["Studio"],"summary":"and clears it -- Studio's start screen puts it in its prompt box, never sends it.","operationId":"postApiStudioPendingPrompt","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/pending-prompt/take":{"post":{"tags":["Studio"],"summary":"Create take","operationId":"postApiStudioPendingPromptTake","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects":{"get":{"tags":["Studio"],"summary":"---- Projects ----","operationId":"getApiStudioProjects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create projects","operationId":"postApiStudioProjects","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}":{"get":{"tags":["Studio"],"summary":"Get project","operationId":"getApiStudioProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"Update project","operationId":"putApiStudioProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete project","operationId":"deleteApiStudioProjectsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/access":{"post":{"tags":["Studio"],"summary":"Create access","operationId":"postApiStudioProjectsByidAccess","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-icon":{"get":{"tags":["Studio"],"summary":"---------------------------------------------------------------- the icon (all packages)","operationId":"getApiStudioProjectsByidAppIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"Update app icon","operationId":"putApiStudioProjectsByidAppIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete app icon","operationId":"deleteApiStudioProjectsByidAppIcon","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-icon/ai":{"post":{"tags":["Studio"],"summary":"Create ai","operationId":"postApiStudioProjectsByidAppIconAi","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-manifest":{"put":{"tags":["Studio"],"summary":"Update app manifest","operationId":"putApiStudioProjectsByidAppManifest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-preview":{"get":{"tags":["Studio"],"summary":"List app preview","operationId":"getApiStudioProjectsByidAppPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-preview/call":{"post":{"tags":["Studio"],"summary":"Create call","operationId":"postApiStudioProjectsByidAppPreviewCall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-preview/reset":{"post":{"tags":["Studio"],"summary":"Create reset","operationId":"postApiStudioProjectsByidAppPreviewReset","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-stores":{"get":{"tags":["Studio"],"summary":"---------------------------------------------------------------- the app stores (Pro)","operationId":"getApiStudioProjectsByidAppStores","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-stores/android/keystore":{"post":{"tags":["Studio"],"summary":"The upload key, before the generic /@platform routes so \"android/keystore\" is never read as a platform action.","operationId":"postApiStudioProjectsByidAppStoresAndroidKeystore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete keystore","operationId":"deleteApiStudioProjectsByidAppStoresAndroidKeystore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-stores/android/keystore/download":{"post":{"tags":["Studio"],"summary":"Create download","operationId":"postApiStudioProjectsByidAppStoresAndroidKeystoreDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-stores/{platform}":{"put":{"tags":["Studio"],"summary":"Update app store","operationId":"putApiStudioProjectsByidAppStoresByplatform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"platform","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/app-stores/{platform}/package":{"post":{"tags":["Studio"],"summary":"Create package","operationId":"postApiStudioProjectsByidAppStoresByplatformPackage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"platform","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assets":{"get":{"tags":["Studio"],"summary":"---- Assets (images the project can put on a page) ----","operationId":"getApiStudioProjectsByidAssets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create assets","operationId":"postApiStudioProjectsByidAssets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete assets","operationId":"deleteApiStudioProjectsByidAssets","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assets/move-inline":{"post":{"tags":["Studio"],"summary":"The image library (Migration 830): large inline images to object storage, and upload links.","operationId":"postApiStudioProjectsByidAssetsMoveInline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants":{"get":{"tags":["Studio"],"summary":"List assistants","operationId":"getApiStudioProjectsByidAssistants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}":{"put":{"tags":["Studio"],"summary":"Update assistant","operationId":"putApiStudioProjectsByidAssistantsByalias","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"page files that still call chat(alias), so they can be taken out too.","operationId":"deleteApiStudioProjectsByidAssistantsByalias","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}/questions":{"get":{"tags":["Studio"],"summary":"List questions","operationId":"getApiStudioProjectsByidAssistantsByaliasQuestions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}/sources":{"get":{"tags":["Studio"],"summary":"List sources","operationId":"getApiStudioProjectsByidAssistantsByaliasSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create sources","operationId":"postApiStudioProjectsByidAssistantsByaliasSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}/sources/{sid}":{"put":{"tags":["Studio"],"summary":"Update source","operationId":"putApiStudioProjectsByidAssistantsByaliasSourcesBysid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete source","operationId":"deleteApiStudioProjectsByidAssistantsByaliasSourcesBysid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}/sources/{sid}/refresh":{"post":{"tags":["Studio"],"summary":"Create refresh","operationId":"postApiStudioProjectsByidAssistantsByaliasSourcesBysidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/assistants/{alias}/test":{"post":{"tags":["Studio"],"summary":"the same way (StudioSiteChatService::testChat).","operationId":"postApiStudioProjectsByidAssistantsByaliasTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/bindings":{"get":{"tags":["Studio"],"summary":"List bindings","operationId":"getApiStudioProjectsByidBindings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create bindings","operationId":"postApiStudioProjectsByidBindings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/bindings/{alias}":{"delete":{"tags":["Studio"],"summary":"Delete binding","operationId":"deleteApiStudioProjectsByidBindingsByalias","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/cancel":{"post":{"tags":["Studio"],"summary":"occupying its own worker for the duration.","operationId":"postApiStudioProjectsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/costs":{"get":{"tags":["Studio"],"summary":"project; other people's lines by name only for the owner / an organisation's owners and admins.","operationId":"getApiStudioProjectsByidCosts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/css-trim":{"post":{"tags":["Studio"],"summary":"Trim unused CSS: dry run in batch jobs, report, apply, undo. No AI credit.","operationId":"postApiStudioProjectsByidCssTrim","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Studio"],"summary":"List css trim","operationId":"getApiStudioProjectsByidCssTrim","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/css-trim/{run}/apply":{"post":{"tags":["Studio"],"summary":"Create apply","operationId":"postApiStudioProjectsByidCssTrimByrunApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/css-trim/{run}/undo":{"post":{"tags":["Studio"],"summary":"Create undo","operationId":"postApiStudioProjectsByidCssTrimByrunUndo","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/data-model":{"get":{"tags":["Studio"],"summary":"List data model","operationId":"getApiStudioProjectsByidDataModel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/data-model/collections":{"post":{"tags":["Studio"],"summary":"A new shared collection: { alias, name, fields: [{name, type, required?, unique?, default?, values?, to?}] }","operationId":"postApiStudioProjectsByidDataModelCollections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/data-model/collections/{alias}/fields":{"post":{"tags":["Studio"],"summary":"Fields added to a collection of the site: { fields: [...] }","operationId":"postApiStudioProjectsByidDataModelCollectionsByaliasFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/data/{alias}":{"get":{"tags":["Studio"],"summary":"asks on its behalf.","operationId":"getApiStudioProjectsByidDataByalias","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/delete-plan":{"get":{"tags":["Studio"],"summary":"List delete plan","operationId":"getApiStudioProjectsByidDeletePlan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/domains":{"get":{"tags":["Studio"],"summary":"second implementation.","operationId":"getApiStudioProjectsByidDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create domains","operationId":"postApiStudioProjectsByidDomains","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/domains/{domainId}":{"delete":{"tags":["Studio"],"summary":"Delete domain","operationId":"deleteApiStudioProjectsByidDomainsBydomainid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/domains/{domainId}/provision":{"post":{"tags":["Studio"],"summary":"Create provision","operationId":"postApiStudioProjectsByidDomainsBydomainidProvision","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/domains/{domainId}/verify":{"post":{"tags":["Studio"],"summary":"Create verify","operationId":"postApiStudioProjectsByidDomainsBydomainidVerify","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/erp/{alias}/sync":{"post":{"tags":["Studio"],"summary":"================================================================","operationId":"postApiStudioProjectsByidErpByaliasSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"alias","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/files":{"get":{"tags":["Studio"],"summary":"---- Files ----","operationId":"getApiStudioProjectsByidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"Update files","operationId":"putApiStudioProjectsByidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete files","operationId":"deleteApiStudioProjectsByidFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/files/rename":{"post":{"tags":["Studio"],"summary":"Create rename","operationId":"postApiStudioProjectsByidFilesRename","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/forms":{"get":{"tags":["Studio"],"summary":"List forms","operationId":"getApiStudioProjectsByidForms","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/forms/publish":{"post":{"tags":["Studio"],"summary":"Create publish","operationId":"postApiStudioProjectsByidFormsPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/jobs":{"get":{"tags":["Studio"],"summary":"List jobs","operationId":"getApiStudioProjectsByidJobs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/jobs/{jobId}":{"delete":{"tags":["Studio"],"summary":"Delete job","operationId":"deleteApiStudioProjectsByidJobsByjobid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/jobs/{jobId}/{action}":{"post":{"tags":["Studio"],"summary":"Create job","operationId":"postApiStudioProjectsByidJobsByjobidByaction","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"action","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/localise":{"post":{"tags":["Studio"],"summary":"Localise the site's own files: dry run, apply, undo. No AI credit.","operationId":"postApiStudioProjectsByidLocalise","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Studio"],"summary":"List localise","operationId":"getApiStudioProjectsByidLocalise","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/localise/{run}/apply":{"post":{"tags":["Studio"],"summary":"Create apply","operationId":"postApiStudioProjectsByidLocaliseByrunApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/localise/{run}/undo":{"post":{"tags":["Studio"],"summary":"Create undo","operationId":"postApiStudioProjectsByidLocaliseByrunUndo","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/marketplace":{"get":{"tags":["Studio"],"summary":"List marketplace","operationId":"getApiStudioProjectsByidMarketplace","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/marketplace/pricing":{"post":{"tags":["Studio"],"summary":"The app's monthly price and trial, from Studio's marketplace window (#510).","operationId":"postApiStudioProjectsByidMarketplacePricing","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/marketplace/publish":{"post":{"tags":["Studio"],"summary":"Create publish","operationId":"postApiStudioProjectsByidMarketplacePublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/members":{"get":{"tags":["Studio"],"summary":"client asks, and how it stays correct when the socket is not there.","operationId":"getApiStudioProjectsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create members","operationId":"postApiStudioProjectsByidMembers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/members/{memberUserId}":{"put":{"tags":["Studio"],"summary":"Update member","operationId":"putApiStudioProjectsByidMembersBymemberuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"memberUserId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete member","operationId":"deleteApiStudioProjectsByidMembersBymemberuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"memberUserId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/messages":{"get":{"tags":["Studio"],"summary":"---- AI turns ----","operationId":"getApiStudioProjectsByidMessages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/optimise":{"post":{"tags":["Studio"],"summary":"report, then Apply (one checkpoint in History) and Undo. No AI credit.","operationId":"postApiStudioProjectsByidOptimise","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Studio"],"summary":"List optimise","operationId":"getApiStudioProjectsByidOptimise","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/optimise/{run}/apply":{"post":{"tags":["Studio"],"summary":"Create apply","operationId":"postApiStudioProjectsByidOptimiseByrunApply","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/optimise/{run}/undo":{"post":{"tags":["Studio"],"summary":"Create undo","operationId":"postApiStudioProjectsByidOptimiseByrunUndo","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/orders":{"get":{"tags":["Studio"],"summary":"The merchant's own orders.","operationId":"getApiStudioProjectsByidOrders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/orders/{orderId}":{"get":{"tags":["Studio"],"summary":"tracking, delivered, cancelled, refunded. Refunds need the project's owner.","operationId":"getApiStudioProjectsByidOrdersByorderid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/orders/{orderId}/refund":{"post":{"tags":["Studio"],"summary":"Create refund","operationId":"postApiStudioProjectsByidOrdersByorderidRefund","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/orders/{orderId}/status":{"post":{"tags":["Studio"],"summary":"Create status","operationId":"postApiStudioProjectsByidOrdersByorderidStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/performance":{"get":{"tags":["Studio"],"summary":"The performance console of a project","description":"Loading times measured by the site's real visitors (75th percentile and friends, per page, per device, per day), the latest page check, a 0-100 score and suggestions. Real-visitor timings are collected on a published site unless the owner switched them off (`timings_enabled`; see /performance/settings) -- visitor statistics are not needed: the timings carry no identity and no cookie, and visitors with Do-Not-Track or Global Privacy Control are left out. Anyone who can open the project may read it. Below the package that includes the console (`access.level` = `summary`) only the score and the first three suggestions are filled; the rest is null and `access.upgrade_key` names the package feature (`studio_performance`).","operationId":"getApiStudioProjectsByidPerformance","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The Studio project"},{"name":"days","in":"query","required":false,"schema":{"type":"string"},"description":"The period, in days. At most 30 (90 on Pro and Enterprise), which is how long timings are kept."}],"responses":{"200":{"description":"The console: access, published, timings_enabled, can_change_timings, score, samples, days, vitals, by_page, by_device, trend, latest_check, checks_today, checks_limit, findings"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No such project, or not yours to open"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/performance-mode":{"get":{"tags":["Studio"],"summary":"project, changed with canEdit, like the timings switch above.","operationId":"getApiStudioProjectsByidPerformanceMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"project, changed with canEdit, like the timings switch above.","operationId":"putApiStudioProjectsByidPerformanceMode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/performance/check":{"post":{"tags":["Studio"],"summary":"Check a page now","description":"Loads the live page (or, before the first publish, the newest draft) in a browser of ours and records every request it makes, which files hold up the first paint, and the page's timings. Runs in the background: poll the check by its id. One check at a time per project, and a daily number of checks per project that depends on the package. Needs edit access.","operationId":"postApiStudioProjectsByidPerformanceCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The Studio project"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"path":{"type":"string","description":"The page, e.g. /about. A query string is ignored.","default":"/"}}}}}},"responses":{"202":{"description":"Queued: {check_id, status: \"queued\"}"},"400":{"description":"The site is neither published nor drafted yet"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Not in the package: error.class = upgrade_required, error.upgrade.key = studio_performance"},"404":{"description":"No such project, or not yours to edit"},"409":{"description":"A check of this project is already queued or running"},"429":{"description":"The project has used its page checks for today"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/performance/checks/{checkId}":{"get":{"tags":["Studio"],"summary":"One page check, with its waterfall","description":"Status (queued, running, done, failed), and when done the waterfall -- every request with its type, status, bytes transferred and decoded, start and end in ms from the start of the page, whether it held up the first paint, its Cache-Control and Content-Encoding -- the totals and the lab timings (ttfb, fcp, lcp, cls, tbt). Files of the site itself are given as paths; files from other websites as origin and path, without their query string.","operationId":"getApiStudioProjectsByidPerformanceChecksBycheckid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The Studio project"},{"name":"checkId","in":"path","required":true,"schema":{"type":"string"},"description":"A page check of that project"}],"responses":{"200":{"description":"{id, status, path, created_at, finished_at, error, result: {waterfall, totals, vitals} | null}"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No such project or check"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/performance/settings":{"get":{"tags":["Studio"],"summary":"Whether real-visitor timings are collected","description":"Real-visitor timings for the performance console are on by default for every published site and need no visitor statistics: nothing personal is collected, no cookie is set, and visitors with Do-Not-Track or Global Privacy Control are left out. The owner can switch them off here; while off, no new timings are stored. Needs edit access.","operationId":"getApiStudioProjectsByidPerformanceSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The Studio project"}],"responses":{"200":{"description":"{timings: \"on\" | \"off\"}"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No such project, or not yours to edit"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"Switch real-visitor timings on or off","description":"Real-visitor timings for the performance console are on by default for every published site and need no visitor statistics: nothing personal is collected, no cookie is set, and visitors with Do-Not-Track or Global Privacy Control are left out. The owner can switch them off here; while off, no new timings are stored. Needs edit access.","operationId":"putApiStudioProjectsByidPerformanceSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"The Studio project"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timings":{"type":"string","description":"on (the default) or off","enum":["on","off"]}},"required":["timings"]}}}},"responses":{"200":{"description":"{timings: \"on\" | \"off\"}"},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No such project, or not yours to edit"},"422":{"description":"timings is neither on nor off"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/presence":{"post":{"tags":["Studio"],"summary":"Create presence","operationId":"postApiStudioProjectsByidPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Studio"],"summary":"List presence","operationId":"getApiStudioProjectsByidPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete presence","operationId":"deleteApiStudioProjectsByidPresence","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/preview-asset-base":{"get":{"tags":["Studio"],"summary":"same token for a whole window, so asking again does not rebuild the page).","operationId":"getApiStudioProjectsByidPreviewAssetBase","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/preview-call":{"post":{"tags":["Studio"],"summary":"the same internal routes the published site uses.","operationId":"postApiStudioProjectsByidPreviewCall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/preview-report":{"post":{"tags":["Studio"],"summary":"next one tells us which of runtime, React or the app's own code did not run.","operationId":"postApiStudioProjectsByidPreviewReport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/project-files":{"get":{"tags":["Studio"],"summary":"Get a project's own file storage","operationId":"getApiStudioProjectsByidProjectFiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/publish":{"post":{"tags":["Studio"],"summary":"Create publish","operationId":"postApiStudioProjectsByidPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/publish-static":{"post":{"tags":["Studio"],"summary":"the site, and they are assembled server-side.","operationId":"postApiStudioProjectsByidPublishStatic","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/push":{"get":{"tags":["Studio"],"summary":"somebody's behalf, which is a spam button with extra steps.","operationId":"getApiStudioProjectsByidPush","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create push","operationId":"postApiStudioProjectsByidPush","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/queue":{"get":{"tags":["Studio"],"summary":"Where a queued turn stands while it waits for a free builder: position, ahead, running, reason, eta_seconds.","operationId":"getApiStudioProjectsByidQueue","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"turn_id","in":"query","required":false,"description":"The turn to ask about; defaults to the project's current turn.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Project not found, or no turn of this project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/releases":{"get":{"tags":["Studio"],"summary":"{notes} = change a release's notes. Publishing stays separate.","operationId":"getApiStudioProjectsByidReleases","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"{notes} = change a release's notes. Publishing stays separate.","operationId":"postApiStudioProjectsByidReleases","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/releases/{version}":{"put":{"tags":["Studio"],"summary":"Update release","operationId":"putApiStudioProjectsByidReleasesByversion","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/remix":{"post":{"tags":["Studio"],"summary":"Create remix","operationId":"postApiStudioProjectsByidRemix","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/reviews":{"get":{"tags":["Studio"],"summary":"with the review's own link.","operationId":"getApiStudioProjectsByidReviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create reviews","operationId":"postApiStudioProjectsByidReviews","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/rollback/{versionNo}":{"post":{"tags":["Studio"],"summary":"Create rollback","operationId":"postApiStudioProjectsByidRollbackByversionno","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionNo","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/send":{"post":{"tags":["Studio"],"summary":"Create send","operationId":"postApiStudioProjectsByidSend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/send-stream":{"post":{"tags":["Studio"],"summary":"that no longer exists and the request 500s under PHP 8.4.","operationId":"postApiStudioProjectsByidSendStream","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site":{"get":{"tags":["Studio"],"summary":"---- Publishing ----","operationId":"getApiStudioProjectsByidSite","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site-accounts":{"get":{"tags":["Studio"],"summary":"Everything at once, for Studio's Accounts window: accounts, invitations, groups, access, roles.","operationId":"getApiStudioProjectsByidSiteAccounts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"site admin has, so the two cannot drift.","operationId":"postApiStudioProjectsByidSiteAccounts","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site-accounts/open-as-admin":{"post":{"tags":["Studio"],"summary":"A one-click link that signs the owner in to the published site as an admin.","operationId":"postApiStudioProjectsByidSiteAccountsOpenAsAdmin","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site-ai-images":{"get":{"tags":["Studio"],"summary":"owner's (or an editor's) way to change or stop it without the builder.","operationId":"getApiStudioProjectsByidSiteAiImages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"owner's (or an editor's) way to change or stop it without the builder.","operationId":"putApiStudioProjectsByidSiteAiImages","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site-versions":{"get":{"tags":["Studio"],"summary":"so there is one code path for \"make this version the live one\".","operationId":"getApiStudioProjectsByidSiteVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/site/subdomain":{"post":{"tags":["Studio"],"summary":"Give a live site a new address; the old one redirects for a while.","operationId":"postApiStudioProjectsByidSiteSubdomain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/steps":{"get":{"tags":["Studio"],"summary":"List steps","operationId":"getApiStudioProjectsByidSteps","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/steps/{step}/check":{"post":{"tags":["Studio"],"summary":"The preview's self-test after a step (#497).","operationId":"postApiStudioProjectsByidStepsBystepCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/steps/{step}/diff":{"get":{"tags":["Studio"],"summary":"List diff","operationId":"getApiStudioProjectsByidStepsBystepDiff","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/steps/{step}/revert":{"post":{"tags":["Studio"],"summary":"Create revert","operationId":"postApiStudioProjectsByidStepsBystepRevert","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/steps/{step}/revert-preview":{"get":{"tags":["Studio"],"summary":"What going back would leave behind, before anyone confirms.","operationId":"getApiStudioProjectsByidStepsBystepRevertPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store":{"get":{"tags":["Studio"],"summary":"The shop itself: what it sells through, and whether it can charge a real card.","operationId":"getApiStudioProjectsByidStore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store/live":{"put":{"tags":["Studio"],"summary":"a tool that could do it would eventually do it because a page asked it to.","operationId":"putApiStudioProjectsByidStoreLive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store/payouts":{"post":{"tags":["Studio"],"summary":"never see a document and the merchant never sees a key.","operationId":"postApiStudioProjectsByidStorePayouts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store/payouts/refresh":{"post":{"tags":["Studio"],"summary":"Where payout setup has got to, asked of Stripe rather than of our cache.","operationId":"postApiStudioProjectsByidStorePayoutsRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store/settings":{"put":{"tags":["Studio"],"summary":"The shop's owner-only settings: VAT, delivery countries, site admins refunding.","operationId":"putApiStudioProjectsByidStoreSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/store/webhook":{"put":{"tags":["Studio"],"summary":"The signing secret for a shop on the merchant's own payment account.","operationId":"putApiStudioProjectsByidStoreWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/subdomain":{"get":{"tags":["Studio"],"summary":"so the suggestion cannot recommend something publish would then refuse.","operationId":"getApiStudioProjectsByidSubdomain","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/tier-advice":{"post":{"tags":["Studio"],"summary":"Switching the model itself is the ordinary PUT of managed_tier.","operationId":"postApiStudioProjectsByidTierAdvice","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/touch-support":{"post":{"tags":["Studio"],"summary":"Saved so the question is asked once per project; the builder reads it every turn.","operationId":"postApiStudioProjectsByidTouchSupport","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/transfer":{"post":{"tags":["Studio"],"summary":"Body: {to, confirm_name, keep_access?, message?}","operationId":"postApiStudioProjectsByidTransfer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/transfer-options":{"get":{"tags":["Studio"],"summary":"Where the project could go, and whether that needs the receiver's yes.","operationId":"getApiStudioProjectsByidTransferOptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/transfer-plan":{"get":{"tags":["Studio"],"summary":"?to=personal | org:<id> | user:<id> | email:<address>","operationId":"getApiStudioProjectsByidTransferPlan","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/turn-estimate":{"get":{"tags":["Studio"],"summary":"List turn estimate","operationId":"getApiStudioProjectsByidTurnEstimate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/unpublish":{"post":{"tags":["Studio"],"summary":"Create unpublish","operationId":"postApiStudioProjectsByidUnpublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upgrade":{"post":{"tags":["Studio"],"summary":"Create upgrade","operationId":"postApiStudioProjectsByidUpgrade","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upgrade-offer":{"get":{"tags":["Studio"],"summary":"List upgrade offer","operationId":"getApiStudioProjectsByidUpgradeOffer","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upgrade-request":{"post":{"tags":["Studio"],"summary":"Create upgrade request","operationId":"postApiStudioProjectsByidUpgradeRequest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upgrade/card-link":{"post":{"tags":["Studio"],"summary":"Create card link","operationId":"postApiStudioProjectsByidUpgradeCardLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upload-links":{"get":{"tags":["Studio"],"summary":"List upload links","operationId":"getApiStudioProjectsByidUploadLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create upload links","operationId":"postApiStudioProjectsByidUploadLinks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/upload-links/{linkId}":{"delete":{"tags":["Studio"],"summary":"Delete upload link","operationId":"deleteApiStudioProjectsByidUploadLinksBylinkid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"linkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/usage":{"get":{"tags":["Studio"],"summary":"Get a project's usage compared with its package (?month=YYYY-MM)","operationId":"getApiStudioProjectsByidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/versions":{"get":{"tags":["Studio"],"summary":"---- Versions / checkpoints ----","operationId":"getApiStudioProjectsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"Create versions","operationId":"postApiStudioProjectsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/versions/{versionNo}/restore":{"post":{"tags":["Studio"],"summary":"Create restore","operationId":"postApiStudioProjectsByidVersionsByversionnoRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionNo","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/watch":{"get":{"tags":["Studio"],"summary":"PHP's output buffers 500s under PHP 8.4 without it.","operationId":"getApiStudioProjectsByidWatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/projects/{id}/window-closed":{"post":{"tags":["Studio"],"summary":"with the next message.","operationId":"postApiStudioProjectsByidWindowClosed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/referrals":{"get":{"tags":["Studio"],"summary":"The start page's card: my invitations, what I earned, my limits.","operationId":"getApiStudioReferrals","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"invitation e-mail is written in.","operationId":"postApiStudioReferrals","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/request-cost":{"get":{"tags":["Studio"],"summary":"reads as \"about N requests\" (StudioTurnEstimateService::typicalByTier).","operationId":"getApiStudioRequestCost","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/reviews/{reviewId}":{"get":{"tags":["Studio"],"summary":"Get review","operationId":"getApiStudioReviewsByreviewid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Studio"],"summary":"Update review","operationId":"putApiStudioReviewsByreviewid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Studio"],"summary":"Delete review","operationId":"deleteApiStudioReviewsByreviewid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/templates":{"get":{"tags":["Studio"],"summary":"---- Templates (no project context; still authenticated) ----","operationId":"getApiStudioTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/templates/{slug}/check":{"get":{"tags":["Studio"],"summary":"List check","operationId":"getApiStudioTemplatesByslugCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests":{"get":{"tags":["Studio"],"summary":"Requests: both directions for the signed-in person.","operationId":"getApiStudioTransferRequests","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests/{id}":{"delete":{"tags":["Studio"],"summary":"Delete transfer request","operationId":"deleteApiStudioTransferRequestsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests/{id}/cancel":{"post":{"tags":["Studio"],"summary":"Create cancel","operationId":"postApiStudioTransferRequestsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests/{ref}":{"get":{"tags":["Studio"],"summary":"One request, by id or by the e-mailed token, with the plan the receiver gets.","operationId":"getApiStudioTransferRequestsByref","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests/{ref}/accept":{"post":{"tags":["Studio"],"summary":"Create accept","operationId":"postApiStudioTransferRequestsByrefAccept","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/transfer-requests/{ref}/decline":{"post":{"tags":["Studio"],"summary":"Create decline","operationId":"postApiStudioTransferRequestsByrefDecline","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/usage-summary":{"get":{"tags":["Studio"],"summary":"Get usage of the workspace's published projects (?organization_id=&month=YYYY-MM)","operationId":"getApiStudioUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/studio/workspaces":{"get":{"tags":["Studio"],"summary":"let them use Studio (#514), with whether each organisation's wallet pays.","operationId":"getApiStudioWorkspaces","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions":{"post":{"tags":["Billing"],"summary":"----- SSE Subscriptions Routes -----","operationId":"postApiSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Billing"],"summary":"List subscriptions","operationId":"getApiSubscriptions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{id}":{"delete":{"tags":["Billing"],"summary":"Delete subscription","operationId":"deleteApiSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Billing"],"summary":"Get subscription","operationId":"getApiSubscriptionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{id}/cancel":{"post":{"tags":["Billing"],"summary":"Create cancel","operationId":"postApiSubscriptionsByidCancel","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{id}/change-tier":{"post":{"tags":["Billing"],"summary":"billing period. See ApplicationService::changeSubscriptionTier.","operationId":"postApiSubscriptionsByidChangeTier","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{id}/skip-trial":{"post":{"tags":["Billing"],"summary":"End a trial early and start the paid period immediately","operationId":"postApiSubscriptionsByidSkipTrial","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{id}/stream":{"get":{"tags":["Billing"],"summary":"to buffer the response and it 500s under PHP 8.4.","operationId":"getApiSubscriptionsByidStream","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subId}/addons":{"get":{"tags":["Billing"],"summary":"List addons","operationId":"getApiSubscriptionsBysubidAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Billing"],"summary":"Create addons","operationId":"postApiSubscriptionsBysubidAddons","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subId}/addons/{addonId}":{"delete":{"tags":["Billing"],"summary":"Delete addon","operationId":"deleteApiSubscriptionsBysubidAddonsByaddonid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"addonId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subId}/usage":{"get":{"tags":["Billing"],"summary":"Subscriber: see usage + manage their active add-ons","operationId":"getApiSubscriptionsBysubidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/invitations":{"get":{"tags":["Billing"],"summary":"{invitationId}; until this existed, nothing returned one.","operationId":"getApiSubscriptionsBysubscriptionidInvitations","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/invitations/{invitationId}":{"delete":{"tags":["Billing"],"summary":"Delete invitation","operationId":"deleteApiSubscriptionsBysubscriptionidInvitationsByinvitationid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Billing"],"summary":"Set/clear an owner-facing per-workspace label (alias) for an invited collaborator","operationId":"putApiSubscriptionsBysubscriptionidInvitationsByinvitationid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/invitations/{invitationId}/permission-group":{"put":{"tags":["Billing"],"summary":"Assign permission group to invitation","operationId":"putApiSubscriptionsBysubscriptionidInvitationsByinvitationidPermissionGroup","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/invitations/{invitationId}/permissions":{"put":{"tags":["Billing"],"summary":"so the literal `permissions` segment cannot be swallowed as an id.","operationId":"putApiSubscriptionsBysubscriptionidInvitationsByinvitationidPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/invite":{"post":{"tags":["Billing"],"summary":"Invitations","operationId":"postApiSubscriptionsBysubscriptionidInvite","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/permission-groups":{"get":{"tags":["Billing"],"summary":"Permission Groups","operationId":"getApiSubscriptionsBysubscriptionidPermissionGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Billing"],"summary":"Create permission groups","operationId":"postApiSubscriptionsBysubscriptionidPermissionGroups","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/permission-groups/{groupId}":{"get":{"tags":["Billing"],"summary":"Get permission group","operationId":"getApiSubscriptionsBysubscriptionidPermissionGroupsBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Billing"],"summary":"Update permission group","operationId":"putApiSubscriptionsBysubscriptionidPermissionGroupsBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Billing"],"summary":"Delete permission group","operationId":"deleteApiSubscriptionsBysubscriptionidPermissionGroupsBygroupid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/permission-groups/{groupId}/endpoints-bulk":{"put":{"tags":["Billing"],"summary":"unambiguous).","operationId":"putApiSubscriptionsBysubscriptionidPermissionGroupsBygroupidEndpointsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/permission-groups/{groupId}/endpoints/{endpointId}":{"put":{"tags":["Billing"],"summary":"Update endpoint","operationId":"putApiSubscriptionsBysubscriptionidPermissionGroupsBygroupidEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Billing"],"summary":"Delete endpoint","operationId":"deleteApiSubscriptionsBysubscriptionidPermissionGroupsBygroupidEndpointsByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/subscriptions/{subscriptionId}/permission-groups/{groupId}/endpoints/{endpointId}/fields":{"get":{"tags":["Billing"],"summary":"so without this the field whitelist was enforceable but unbuildable.","operationId":"getApiSubscriptionsBysubscriptionidPermissionGroupsBygroupidEndpointsByendpointidFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections":{"post":{"tags":["Sync"],"summary":"Connection CRUD","operationId":"postApiSyncConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Sync"],"summary":"List connections","operationId":"getApiSyncConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}":{"get":{"tags":["Sync"],"summary":"Get connection","operationId":"getApiSyncConnectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Sync"],"summary":"Update connection","operationId":"putApiSyncConnectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Sync"],"summary":"Delete connection","operationId":"deleteApiSyncConnectionsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/conflicts":{"get":{"tags":["Sync"],"summary":"Conflict management","operationId":"getApiSyncConnectionsByidConflicts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/conflicts/{conflictId}/resolve":{"post":{"tags":["Sync"],"summary":"Create resolve","operationId":"postApiSyncConnectionsByidConflictsByconflictidResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"conflictId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/discover-fields":{"get":{"tags":["Sync"],"summary":"Field discovery and mapping","operationId":"getApiSyncConnectionsByidDiscoverFields","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/freshness":{"get":{"tags":["Sync"],"summary":"Check freshness status of a sync connection (without triggering sync)","operationId":"getApiSyncConnectionsByidFreshness","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/history":{"get":{"tags":["Sync"],"summary":"History","operationId":"getApiSyncConnectionsByidHistory","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/mappings":{"get":{"tags":["Sync"],"summary":"List mappings","operationId":"getApiSyncConnectionsByidMappings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Sync"],"summary":"Update mappings","operationId":"putApiSyncConnectionsByidMappings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/refresh":{"post":{"tags":["Sync"],"summary":"Force immediate refresh of a sync connection (regardless of staleness)","operationId":"postApiSyncConnectionsByidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/status":{"get":{"tags":["Sync"],"summary":"List status","operationId":"getApiSyncConnectionsByidStatus","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/sync":{"post":{"tags":["Sync"],"summary":"Sync operations","operationId":"postApiSyncConnectionsByidSync","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connections/{id}/webhook":{"post":{"tags":["Sync"],"summary":"Webhook registration","operationId":"postApiSyncConnectionsByidWebhook","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/connectors":{"get":{"tags":["Sync"],"summary":"List available connectors","operationId":"getApiSyncConnectors","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/changes":{"get":{"tags":["Sync"],"summary":"--- File Area Sync ---","operationId":"getApiSyncFileAreasByareaidChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/cursor":{"post":{"tags":["Sync"],"summary":"Create cursor","operationId":"postApiSyncFileAreasByareaidCursor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/files/{fileId}":{"delete":{"tags":["Sync"],"summary":"--- Delete & Create: File Area Sync Operations ---","operationId":"deleteApiSyncFileAreasByareaidFilesByfileid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/files/{fileId}/presigned-download":{"get":{"tags":["Sync"],"summary":"--- Presigned Downloads: File Areas ---","operationId":"getApiSyncFileAreasByareaidFilesByfileidPresignedDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/folders":{"post":{"tags":["Sync"],"summary":"Create folders","operationId":"postApiSyncFileAreasByareaidFolders","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-areas/{areaId}/tree":{"get":{"tags":["Sync"],"summary":"List tree","operationId":"getApiSyncFileAreasByareaidTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"areaId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-library/changes":{"get":{"tags":["Sync"],"summary":"--- File Library Sync ---","operationId":"getApiSyncFileLibraryChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-library/cursor":{"post":{"tags":["Sync"],"summary":"Create cursor","operationId":"postApiSyncFileLibraryCursor","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/file-library/tree":{"get":{"tags":["Sync"],"summary":"List tree","operationId":"getApiSyncFileLibraryTree","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources":{"get":{"tags":["Sync"],"summary":"Source CRUD","operationId":"getApiSyncSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Sync"],"summary":"Create sources","operationId":"postApiSyncSources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}":{"get":{"tags":["Sync"],"summary":"Get source","operationId":"getApiSyncSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Sync"],"summary":"Update source","operationId":"putApiSyncSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Sync"],"summary":"Delete source","operationId":"deleteApiSyncSourcesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/create-all-endpoints":{"post":{"tags":["Sync"],"summary":"Create create all endpoints","operationId":"postApiSyncSourcesByidCreateAllEndpoints","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/detect-relationships":{"post":{"tags":["Sync"],"summary":"Create detect relationships","operationId":"postApiSyncSourcesByidDetectRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/discover":{"post":{"tags":["Sync"],"summary":"Discovery","operationId":"postApiSyncSourcesByidDiscover","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/graph":{"get":{"tags":["Sync"],"summary":"List graph","operationId":"getApiSyncSourcesByidGraph","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/relationships":{"get":{"tags":["Sync"],"summary":"Relationships","operationId":"getApiSyncSourcesByidRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Sync"],"summary":"Create relationships","operationId":"postApiSyncSourcesByidRelationships","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/relationships/{relationshipId}":{"delete":{"tags":["Sync"],"summary":"Delete relationship","operationId":"deleteApiSyncSourcesByidRelationshipsByrelationshipid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"relationshipId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources":{"get":{"tags":["Sync"],"summary":"List resources","operationId":"getApiSyncSourcesByidResources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources/{resourceId}/apply-changes":{"post":{"tags":["Sync"],"summary":"Create apply changes","operationId":"postApiSyncSourcesByidResourcesByresourceidApplyChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources/{resourceId}/create-endpoint":{"post":{"tags":["Sync"],"summary":"Endpoint creation","operationId":"postApiSyncSourcesByidResourcesByresourceidCreateEndpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources/{resourceId}/field-changes":{"get":{"tags":["Sync"],"summary":"Schema evolution","operationId":"getApiSyncSourcesByidResourcesByresourceidFieldChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources/{resourceId}/ignore-changes":{"post":{"tags":["Sync"],"summary":"Create ignore changes","operationId":"postApiSyncSourcesByidResourcesByresourceidIgnoreChanges","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/sources/{id}/resources/{resourceId}/refresh":{"post":{"tags":["Sync"],"summary":"Create refresh","operationId":"postApiSyncSourcesByidResourcesByresourceidRefresh","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/sync/webhook/{connectionId}":{"post":{"tags":["Sync"],"summary":"Webhook receiver endpoint (called by external services)","operationId":"postApiSyncWebhookByconnectionid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags":{"get":{"tags":["Tags"],"summary":"============================================","operationId":"getApiTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Tags"],"summary":"Create tags","operationId":"postApiTags","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags/bulk":{"post":{"tags":["Tags"],"summary":"Create bulk","operationId":"postApiTagsBulk","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags/search":{"get":{"tags":["Tags"],"summary":"List search","operationId":"getApiTagsSearch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags/stats":{"get":{"tags":["Tags"],"summary":"List stats","operationId":"getApiTagsStats","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags/{id}":{"put":{"tags":["Tags"],"summary":"Update tag","operationId":"putApiTagsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Tags"],"summary":"Delete tag","operationId":"deleteApiTagsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tags/{id}/records":{"get":{"tags":["Tags"],"summary":"List records","operationId":"getApiTagsByidRecords","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates":{"get":{"tags":["Templates"],"summary":"----- Endpoint Templates Routes -----","operationId":"getApiTemplates","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates/create-endpoint":{"post":{"tags":["Templates"],"summary":"Create create endpoint","operationId":"postApiTemplatesCreateEndpoint","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates/save":{"post":{"tags":["Templates"],"summary":"Create save","operationId":"postApiTemplatesSave","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates/{name}":{"get":{"tags":["Templates"],"summary":"Get template","operationId":"getApiTemplatesByname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Templates"],"summary":"Delete template","operationId":"deleteApiTemplatesByname","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates/{name}/preflight":{"get":{"tags":["Templates"],"summary":"\"upgrade required\" warning before the user clicks \"Create from template\".","operationId":"getApiTemplatesBynamePreflight","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/templates/{name}/visibility":{"put":{"tags":["Templates"],"summary":"Update visibility","operationId":"putApiTemplatesBynameVisibility","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/temporal-triggers":{"get":{"tags":["Temporal triggers"],"summary":"--- Global list ---","operationId":"getApiTemporalTriggers","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/temporal-triggers/{triggerId}":{"get":{"tags":["Temporal triggers"],"summary":"--- Single trigger operations ---","operationId":"getApiTemporalTriggersBytriggerid","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Temporal triggers"],"summary":"Update temporal trigger","operationId":"putApiTemporalTriggersBytriggerid","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Temporal triggers"],"summary":"Delete temporal trigger","operationId":"deleteApiTemporalTriggersBytriggerid","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/temporal-triggers/{triggerId}/history":{"get":{"tags":["Temporal triggers"],"summary":"List history","operationId":"getApiTemporalTriggersBytriggeridHistory","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/temporal-triggers/{triggerId}/test":{"post":{"tags":["Temporal triggers"],"summary":"Create test","operationId":"postApiTemporalTriggersBytriggeridTest","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/temporal-triggers/{triggerId}/toggle":{"post":{"tags":["Temporal triggers"],"summary":"Create toggle","operationId":"postApiTemporalTriggersBytriggeridToggle","security":[],"parameters":[{"name":"triggerId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants":{"post":{"tags":["Tenants"],"summary":"--- Tenant CRUD ---","operationId":"postApiTenants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Tenants"],"summary":"List tenants","operationId":"getApiTenants","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}":{"get":{"tags":["Tenants"],"summary":"Get tenant","operationId":"getApiTenantsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Tenants"],"summary":"Update tenant","operationId":"putApiTenantsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Tenants"],"summary":"Delete tenant","operationId":"deleteApiTenantsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/activate":{"post":{"tags":["Tenants"],"summary":"Create activate","operationId":"postApiTenantsByidActivate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/quotas":{"put":{"tags":["Tenants"],"summary":"--- Quotas & Usage ---","operationId":"putApiTenantsByidQuotas","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/suspend":{"post":{"tags":["Tenants"],"summary":"--- Lifecycle Management ---","operationId":"postApiTenantsByidSuspend","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/usage":{"get":{"tags":["Tenants"],"summary":"List usage","operationId":"getApiTenantsByidUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/users":{"post":{"tags":["Tenants"],"summary":"--- User Management ---","operationId":"postApiTenantsByidUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Tenants"],"summary":"List users","operationId":"getApiTenantsByidUsers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tenants/{id}/users/{userId}":{"delete":{"tags":["Tenants"],"summary":"Delete user","operationId":"deleteApiTenantsByidUsersByuserid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites":{"post":{"tags":["Test suites"],"summary":"Suite CRUD","operationId":"postApiTestSuites","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Test suites"],"summary":"List test suites","operationId":"getApiTestSuites","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/import":{"post":{"tags":["Test suites"],"summary":"Create import","operationId":"postApiTestSuitesImport","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{id}":{"get":{"tags":["Test suites"],"summary":"Get test suite","operationId":"getApiTestSuitesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Test suites"],"summary":"Update test suite","operationId":"putApiTestSuitesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Test suites"],"summary":"Delete test suite","operationId":"deleteApiTestSuitesByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/cases":{"post":{"tags":["Test suites"],"summary":"Test Case CRUD","operationId":"postApiTestSuitesBysuiteidCases","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Test suites"],"summary":"List cases","operationId":"getApiTestSuitesBysuiteidCases","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/cases/{caseId}":{"get":{"tags":["Test suites"],"summary":"Get case","operationId":"getApiTestSuitesBysuiteidCasesBycaseid","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Test suites"],"summary":"Update case","operationId":"putApiTestSuitesBysuiteidCasesBycaseid","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Test suites"],"summary":"Delete case","operationId":"deleteApiTestSuitesBysuiteidCasesBycaseid","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"caseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/export":{"get":{"tags":["Test suites"],"summary":"Import / Export","operationId":"getApiTestSuitesBysuiteidExport","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/run":{"post":{"tags":["Test suites"],"summary":"Test Execution","operationId":"postApiTestSuitesBysuiteidRun","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/runs":{"get":{"tags":["Test suites"],"summary":"List runs","operationId":"getApiTestSuitesBysuiteidRuns","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/test-suites/{suiteId}/runs/{runId}":{"get":{"tags":["Test suites"],"summary":"Get run","operationId":"getApiTestSuitesBysuiteidRunsByrunid","security":[],"parameters":[{"name":"suiteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/time-series/configs":{"post":{"tags":["Time series"],"summary":"Create configs","operationId":"postApiTimeSeriesConfigs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Time series"],"summary":"List configs","operationId":"getApiTimeSeriesConfigs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/time-series/configs/{id}":{"get":{"tags":["Time series"],"summary":"Get config","operationId":"getApiTimeSeriesConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Time series"],"summary":"Update config","operationId":"putApiTimeSeriesConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Time series"],"summary":"Delete config","operationId":"deleteApiTimeSeriesConfigsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/time-series/configs/{id}/log":{"get":{"tags":["Time series"],"summary":"List log","operationId":"getApiTimeSeriesConfigsByidLog","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/time-travel/snapshots/{id}":{"delete":{"tags":["Time travel"],"summary":"Delete snapshot","operationId":"deleteApiTimeTravelSnapshotsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/transactions":{"post":{"tags":["Transactions"],"summary":"Create transactions","operationId":"postApiTransactions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views":{"post":{"tags":["Union views"],"summary":"Union Views CRUD","operationId":"postApiUnionViews","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Union views"],"summary":"List union views","operationId":"getApiUnionViews","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views/{id}":{"get":{"tags":["Union views"],"summary":"Get union view","operationId":"getApiUnionViewsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Union views"],"summary":"Update union view","operationId":"putApiUnionViewsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Union views"],"summary":"Delete union view","operationId":"deleteApiUnionViewsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views/{id}/query":{"get":{"tags":["Union views"],"summary":"Query and Schema","operationId":"getApiUnionViewsByidQuery","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views/{id}/schema":{"get":{"tags":["Union views"],"summary":"List schema","operationId":"getApiUnionViewsByidSchema","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views/{id}/sources":{"post":{"tags":["Union views"],"summary":"Union View Sources","operationId":"postApiUnionViewsByidSources","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/union-views/{id}/sources/{sourceId}":{"put":{"tags":["Union views"],"summary":"Update source","operationId":"putApiUnionViewsByidSourcesBysourceid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Union views"],"summary":"Delete source","operationId":"deleteApiUnionViewsByidSourcesBysourceid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/updates/{slug}/check":{"get":{"tags":["Updates"],"summary":"Check for an update (optionally license-gated)","description":"Authenticated with `X-Update-Token` (not a JWT); tokenless only for public products that allow anonymous checks. When the release product has a `license_policy` other than `none`, send `X-License-Key` plus `X-License-Fingerprint` (node-locked) or `X-License-Lease` (floating). Under `required_maintenance`, newer releases than the license's `updates_until` are withheld: that is HTTP 200 \"no update\" with `reason: \"maintenance_expired\"` and `license.maintenance_expired: true`, not a refusal. Download URLs for a gated product are short-lived signed URLs.","operationId":"getApiUpdatesByslugCheck","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Release product slug"},{"name":"current","in":"query","required":true,"schema":{"type":"string"},"description":"Installed version"},{"name":"client","in":"query","required":true,"schema":{"type":"string"},"description":"Stable per-install id: 8-64 lowercase hex/hyphen, starting with hex"},{"name":"platform","in":"query","required":false,"schema":{"type":"string"}},{"name":"channel","in":"query","required":false,"schema":{"type":"string"},"description":"Restrict to one channel (e.g. stable, beta)"},{"name":"X-Update-Token","in":"header","required":false,"schema":{"type":"string"},"description":"Release update token (`rut_\u2026`)"},{"name":"X-License-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-License-Fingerprint","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-License-Lease","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Update decision","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"up_to_date":{"type":"boolean"},"update_available":{"type":"boolean"},"mandatory":{"type":"boolean"},"is_rollback":{"type":"boolean"},"policy":{"type":"string"},"reason":{"type":"string","description":"e.g. `maintenance_expired`, `no released versions`"},"release":{"type":"object"},"artifacts":{"type":"array","items":{"type":"object"}},"active_advisories":{"type":"array","items":{"type":"object"}},"license":{"type":"object","description":"Gated products only","properties":{"status":{"type":"string"},"updates_until":{"type":"string","nullable":true},"maintenance_expired":{"type":"boolean"}}}}}}}}}},"400":{"description":"`current` and `client` are required, or invalid parameters"},"401":{"description":"X-Update-Token required, or invalid/revoked"},"403":{"description":"Token not scoped to this product, or a license refusal: top-level `reason` and `error.reason` = `license_required`, `license_invalid` or `license_expired`"},"404":{"description":"Product not found"},"429":{"description":"Rate limited; honour Retry-After"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/updates/{slug}/report":{"post":{"tags":["Updates"],"summary":"---- Public client health-report endpoint (X-Update-Token auth) ----","operationId":"postApiUpdatesByslugReport","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage":{"get":{"tags":["Usage"],"summary":"Get current user's usage summary","operationId":"getApiUsage","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/anomaly-alerts":{"get":{"tags":["Usage"],"summary":"--- Alerts ---","operationId":"getApiUsageAnomalyAlerts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/anomaly-alerts/acknowledge-all":{"post":{"tags":["Usage"],"summary":"Create acknowledge all","operationId":"postApiUsageAnomalyAlertsAcknowledgeAll","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/anomaly-alerts/{id}":{"get":{"tags":["Usage"],"summary":"Get anomaly alert","operationId":"getApiUsageAnomalyAlertsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/anomaly-alerts/{id}/acknowledge":{"post":{"tags":["Usage"],"summary":"Create acknowledge","operationId":"postApiUsageAnomalyAlertsByidAcknowledge","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/anomaly-config":{"get":{"tags":["Usage"],"summary":"--- Configuration ---","operationId":"getApiUsageAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Usage"],"summary":"Update anomaly config","operationId":"putApiUsageAnomalyConfig","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/billing":{"get":{"tags":["Usage"],"summary":"Get current user's billing summary","operationId":"getApiUsageBilling","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/rate-limits":{"get":{"tags":["Usage"],"summary":"Get current user's rate limit status","operationId":"getApiUsageRateLimits","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/usage/summary":{"get":{"tags":["Usage"],"summary":"--- Usage Summary ---","operationId":"getApiUsageSummary","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/user-attributes":{"get":{"tags":["User attributes"],"summary":"============================================","operationId":"getApiUserAttributes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["User attributes"],"summary":"Update user attributes","operationId":"putApiUserAttributes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/user-attributes/{key}":{"delete":{"tags":["User attributes"],"summary":"Delete user attribute","operationId":"deleteApiUserAttributesBykey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/users/{identifier}/attributes":{"get":{"tags":["Users"],"summary":"============================================","operationId":"getApiUsersByidentifierAttributes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Users"],"summary":"Update attributes","operationId":"putApiUsersByidentifierAttributes","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/users/{identifier}/attributes/{key}":{"delete":{"tags":["Users"],"summary":"Delete attribute","operationId":"deleteApiUsersByidentifierAttributesBykey","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/users/{userId}/permissions":{"get":{"tags":["Users"],"summary":"List permissions","operationId":"getApiUsersByuseridPermissions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/users/{userId}/permissions/check":{"post":{"tags":["Users"],"summary":"Create check","operationId":"postApiUsersByuseridPermissionsCheck","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/users/{userId}/roles":{"get":{"tags":["Users"],"summary":"--- User Roles & Permissions ---","operationId":"getApiUsersByuseridRoles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/cap/pdf/{documentId}":{"get":{"tags":["V1"],"summary":"/pdf/{uuid} has to win the race.","operationId":"getApiV1CapPdfBydocumentid","security":[],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/cap/{endpoint}":{"get":{"tags":["V1"],"summary":"Get cap","operationId":"getApiV1CapByendpoint","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["V1"],"summary":"Create cap","operationId":"postApiV1CapByendpoint","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/cap/{endpoint}/{id}":{"get":{"tags":["V1"],"summary":"DELETE went in alongside #258 but GET-by-id was an oversight.)","operationId":"getApiV1CapByendpointByid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["V1"],"summary":"both the existing row AND the merged post-write state.","operationId":"patchApiV1CapByendpointByid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["V1"],"summary":"doesn't match).","operationId":"deleteApiV1CapByendpointByid","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/cap/{endpoint}/{id}/pdf":{"post":{"tags":["V1"],"summary":"collides with the 2-segment wildcards.","operationId":"postApiV1CapByendpointByidPdf","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/eat/{endpoint}":{"get":{"tags":["V1"],"summary":"============================================","operationId":"getApiV1EatByendpoint","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["V1"],"summary":"Create eat","operationId":"postApiV1EatByendpoint","security":[],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/trap/{name}":{"get":{"tags":["V1"],"summary":"============================================","operationId":"getApiV1TrapByname","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["V1"],"summary":"Create trap","operationId":"postApiV1TrapByname","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/trap/{name}/{id}":{"get":{"tags":["V1"],"summary":"Get trap","operationId":"getApiV1TrapBynameByid","security":[],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles":{"post":{"tags":["Validation profiles"],"summary":"Create","operationId":"postApiValidationProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Validation profiles"],"summary":"List","operationId":"getApiValidationProfiles","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/assignment-counts":{"get":{"tags":["Validation profiles"],"summary":"Assignment counts keyed by profile id, one query (admin overview).","operationId":"getApiValidationProfilesAssignmentCounts","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}":{"get":{"tags":["Validation profiles"],"summary":"Main resource routes AFTER sub-resource routes","operationId":"getApiValidationProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Validation profiles"],"summary":"Update validation profile","operationId":"putApiValidationProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Validation profiles"],"summary":"Delete validation profile","operationId":"deleteApiValidationProfilesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}/assign":{"post":{"tags":["Validation profiles"],"summary":"Assign profile to endpoint","operationId":"postApiValidationProfilesByidAssign","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}/assign/{endpointId}":{"delete":{"tags":["Validation profiles"],"summary":"Unassign profile from endpoint","operationId":"deleteApiValidationProfilesByidAssignByendpointid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}/assignments":{"get":{"tags":["Validation profiles"],"summary":"List assignments","operationId":"getApiValidationProfilesByidAssignments","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}/validate":{"post":{"tags":["Validation profiles"],"summary":"Validate single record","operationId":"postApiValidationProfilesByidValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-profiles/{id}/validate-batch":{"post":{"tags":["Validation profiles"],"summary":"Validate batch of records","operationId":"postApiValidationProfilesByidValidateBatch","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-rules":{"post":{"tags":["Validation rules"],"summary":"----- Validation Rules Routes -----","operationId":"postApiValidationRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Validation rules"],"summary":"Delete validation rules","operationId":"deleteApiValidationRules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-rules/available":{"get":{"tags":["Validation rules"],"summary":"List available","operationId":"getApiValidationRulesAvailable","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/validation-rules/validate":{"post":{"tags":["Validation rules"],"summary":"Create validate","operationId":"postApiValidationRulesValidate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/views/shared/{code}":{"get":{"tags":["Views"],"summary":"Public share link access (no auth required)","operationId":"getApiViewsSharedBycode","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/views/{id}":{"get":{"tags":["Views"],"summary":"Get view","operationId":"getApiViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Views"],"summary":"Update view","operationId":"putApiViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Views"],"summary":"Delete view","operationId":"deleteApiViewsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/views/{id}/default":{"post":{"tags":["Views"],"summary":"Create default","operationId":"postApiViewsByidDefault","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/views/{id}/execute":{"get":{"tags":["Views"],"summary":"List execute","operationId":"getApiViewsByidExecute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/views/{id}/share-link":{"post":{"tags":["Views"],"summary":"Create share link","operationId":"postApiViewsByidShareLink","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints":{"post":{"tags":["Virtual endpoints"],"summary":"Virtual Endpoints CRUD (authenticated)","operationId":"postApiVirtualEndpoints","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Virtual endpoints"],"summary":"List virtual endpoints","operationId":"getApiVirtualEndpoints","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}":{"get":{"tags":["Virtual endpoints"],"summary":"Get virtual endpoint","operationId":"getApiVirtualEndpointsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Virtual endpoints"],"summary":"Update virtual endpoint","operationId":"putApiVirtualEndpointsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Virtual endpoints"],"summary":"Delete virtual endpoint","operationId":"deleteApiVirtualEndpointsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}/data":{"get":{"tags":["Virtual endpoints"],"summary":"Query data from virtual endpoint","operationId":"getApiVirtualEndpointsByidData","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}/export":{"get":{"tags":["Virtual endpoints"],"summary":"Export","operationId":"getApiVirtualEndpointsByidExport","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}/materialize":{"post":{"tags":["Virtual endpoints"],"summary":"Materialization","operationId":"postApiVirtualEndpointsByidMaterialize","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}/refresh":{"post":{"tags":["Virtual endpoints"],"summary":"Refresh materialized data","operationId":"postApiVirtualEndpointsByidRefresh","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/virtual-endpoints/{id}/schema":{"get":{"tags":["Virtual endpoints"],"summary":"Schema output","operationId":"getApiVirtualEndpointsByidSchema","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/hooks":{"post":{"tags":["Wasm"],"summary":"WASM Hooks","operationId":"postApiWasmHooks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Wasm"],"summary":"List hooks","operationId":"getApiWasmHooks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/hooks/{id}":{"put":{"tags":["Wasm"],"summary":"Update hook","operationId":"putApiWasmHooksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Wasm"],"summary":"Delete hook","operationId":"deleteApiWasmHooksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/logs":{"get":{"tags":["Wasm"],"summary":"WASM Execution Logs","operationId":"getApiWasmLogs","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/modules":{"post":{"tags":["Wasm"],"summary":"WASM Modules","operationId":"postApiWasmModules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Wasm"],"summary":"List modules","operationId":"getApiWasmModules","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/modules/{id}":{"get":{"tags":["Wasm"],"summary":"Get module","operationId":"getApiWasmModulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Wasm"],"summary":"Update module","operationId":"putApiWasmModulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Wasm"],"summary":"Delete module","operationId":"deleteApiWasmModulesByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/modules/{id}/download":{"get":{"tags":["Wasm"],"summary":"List download","operationId":"getApiWasmModulesByidDownload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/modules/{id}/test":{"post":{"tags":["Wasm"],"summary":"Create test","operationId":"postApiWasmModulesByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/modules/{id}/transform":{"post":{"tags":["Wasm"],"summary":"{data,context} -> {success,data,error} contract, real sandboxed runtime.","operationId":"postApiWasmModulesByidTransform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/template":{"get":{"tags":["Wasm"],"summary":"List template","operationId":"getApiWasmTemplate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/triggers":{"get":{"tags":["Wasm"],"summary":"WASM Utility Endpoints","operationId":"getApiWasmTriggers","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/{moduleId}/versions":{"get":{"tags":["Wasm"],"summary":"WASM module versions","operationId":"getApiWasmBymoduleidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/{moduleId}/versions/publish":{"post":{"tags":["Wasm"],"summary":"Create publish","operationId":"postApiWasmBymoduleidVersionsPublish","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/{moduleId}/versions/rollback":{"post":{"tags":["Wasm"],"summary":"Create rollback","operationId":"postApiWasmBymoduleidVersionsRollback","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/wasm/{moduleId}/versions/{versionNumber}":{"delete":{"tags":["Wasm"],"summary":"Delete version","operationId":"deleteApiWasmBymoduleidVersionsByversionnumber","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps":{"get":{"tags":["Web apps"],"summary":"List web apps in marketplace","operationId":"getApiWebApps","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/auth/exchange":{"post":{"tags":["Web apps"],"summary":"Exchange auth code for token + config","operationId":"postApiWebAppsAuthExchange","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed":{"get":{"tags":["Web apps"],"summary":"List user's installed web apps","operationId":"getApiWebAppsInstalled","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}":{"get":{"tags":["Web apps"],"summary":"Get a single installation","operationId":"getApiWebAppsInstalledByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Web apps"],"summary":"Uninstall a web app","operationId":"deleteApiWebAppsInstalledByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/display":{"put":{"tags":["Web apps"],"summary":"Update display mode","operationId":"putApiWebAppsInstalledByidDisplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/frame-origins":{"get":{"tags":["Web apps"],"summary":"Origins this installation is allowed to frame (subscriber-declared).","operationId":"getApiWebAppsInstalledByidFrameOrigins","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Web apps"],"summary":"Create frame origins","operationId":"postApiWebAppsInstalledByidFrameOrigins","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/frame-origins/{originId}":{"delete":{"tags":["Web apps"],"summary":"overlap, this sits here to keep the three together.","operationId":"deleteApiWebAppsInstalledByidFrameOriginsByoriginid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"originId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/menu":{"put":{"tags":["Web apps"],"summary":"Update menu position / section / pin status","operationId":"putApiWebAppsInstalledByidMenu","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/resources":{"get":{"tags":["Web apps"],"summary":"Get resources created by an installed app","operationId":"getApiWebAppsInstalledByidResources","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/settings":{"put":{"tags":["Web apps"],"summary":"Update installation settings","operationId":"putApiWebAppsInstalledByidSettings","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/installed/{id}/slug":{"put":{"tags":["Web apps"],"summary":"Update the friendly slug","operationId":"putApiWebAppsInstalledByidSlug","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/upload":{"post":{"tags":["Web apps"],"summary":"Upload a new web app (ZIP)","operationId":"postApiWebAppsUpload","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}":{"get":{"tags":["Web apps"],"summary":"Get web app details","operationId":"getApiWebAppsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/approve":{"post":{"tags":["Web apps"],"summary":"Subscriber-initiated: approve a pending pair by user_code","operationId":"postApiWebAppsByidDevicePairApprove","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/poll":{"post":{"tags":["Web apps"],"summary":"itself is the credential \u2014 intentionally no authentication middleware.","operationId":"postApiWebAppsByidDevicePairPoll","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/request":{"post":{"tags":["Web apps"],"summary":"anonymous path with fewer rights than the caller asked for.","operationId":"postApiWebAppsByidDevicePairRequest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/sessions":{"get":{"tags":["Web apps"],"summary":"Subscriber-initiated: list active paired devices for my installation","operationId":"getApiWebAppsByidDevicePairSessions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/sessions/{sid}":{"delete":{"tags":["Web apps"],"summary":"Subscriber-initiated: revoke a paired device","operationId":"deleteApiWebAppsByidDevicePairSessionsBysid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/sessions/{sid}/scope":{"put":{"tags":["Web apps"],"summary":"mean physically visiting every screen in a fleet.","operationId":"putApiWebAppsByidDevicePairSessionsBysidScope","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/device-pair/whoami":{"post":{"tags":["Web apps"],"summary":"carries its customer's frame origins. poll() now returns both at pairing.","operationId":"postApiWebAppsByidDevicePairWhoami","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/guest-passes":{"post":{"tags":["Web apps"],"summary":"Host issues a guest pass granting bounded access to a specific resource","operationId":"postApiWebAppsByidGuestPasses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Web apps"],"summary":"Host lists all passes they've issued for this app","operationId":"getApiWebAppsByidGuestPasses","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/guest-passes/{pid}":{"get":{"tags":["Web apps"],"summary":"Host inspects a specific pass","operationId":"getApiWebAppsByidGuestPassesBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Web apps"],"summary":"Host updates (extend TTL, change scope, relabel)","operationId":"putApiWebAppsByidGuestPassesBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Web apps"],"summary":"Host revokes a pass (kicks the guest out immediately)","operationId":"deleteApiWebAppsByidGuestPassesBypid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"pid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/install":{"post":{"tags":["Web apps"],"summary":"Install a web app","operationId":"postApiWebAppsByidInstall","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/install-manifest":{"put":{"tags":["Web apps"],"summary":"Update install manifest","operationId":"putApiWebAppsByidInstallManifest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/preview-url":{"post":{"tags":["Web apps"],"summary":"Generate a short-lived preview URL for any version (publish key or author JWT)","operationId":"postApiWebAppsByidPreviewUrl","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/redundant-hosting":{"post":{"tags":["Web apps"],"summary":"Bills \u20ac20/app-month on the next platform invoice while enabled.","operationId":"postApiWebAppsByidRedundantHosting","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/versions":{"get":{"tags":["Web apps"],"summary":"List published versions (publish key or author JWT)","operationId":"getApiWebAppsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Web apps"],"summary":"Upload a new version","operationId":"postApiWebAppsByidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/web-apps/{id}/versions/{version}/promote":{"post":{"tags":["Web apps"],"summary":"Promote a beta version to live (publish key or author JWT)","operationId":"postApiWebAppsByidVersionsByversionPromote","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks":{"get":{"tags":["Webhooks"],"summary":"List webhooks","operationId":"getApiWebhooks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Webhooks"],"summary":"Create webhooks","operationId":"postApiWebhooks","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/dead-letter":{"get":{"tags":["Webhooks"],"summary":"Global dead letter queue (all webhooks)","operationId":"getApiWebhooksDeadLetter","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/dead-letter/{deadLetterId}/replay":{"post":{"tags":["Webhooks"],"summary":"Create replay","operationId":"postApiWebhooksDeadLetterBydeadletteridReplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deadLetterId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/dead-letter/{deadLetterId}/resolve":{"post":{"tags":["Webhooks"],"summary":"Create resolve","operationId":"postApiWebhooksDeadLetterBydeadletteridResolve","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deadLetterId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/deliveries/{deliveryId}":{"get":{"tags":["Webhooks"],"summary":"Get deliverie","operationId":"getApiWebhooksDeliveriesBydeliveryid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/deliveries/{deliveryId}/retry":{"post":{"tags":["Webhooks"],"summary":"Create retry","operationId":"postApiWebhooksDeliveriesBydeliveryidRetry","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/deliveries/{id}/replay":{"post":{"tags":["Webhooks"],"summary":"WebhookReliabilityController::getDeliveryLog().","operationId":"postApiWebhooksDeliveriesByidReplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/payment":{"post":{"tags":["Webhooks"],"summary":"Payment webhook handler (no auth required - uses webhook signatures)","operationId":"postApiWebhooksPayment","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/replays":{"get":{"tags":["Webhooks"],"summary":"List replays","operationId":"getApiWebhooksReplays","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/replays/{replayId}":{"get":{"tags":["Webhooks"],"summary":"Get replay","operationId":"getApiWebhooksReplaysByreplayid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"replayId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/signing-keys/{keyId}":{"delete":{"tags":["Webhooks"],"summary":"Delete signing key","operationId":"deleteApiWebhooksSigningKeysBykeyid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/signing-keys/{keyId}/rotate":{"post":{"tags":["Webhooks"],"summary":"Create rotate","operationId":"postApiWebhooksSigningKeysBykeyidRotate","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{id}":{"get":{"tags":["Webhooks"],"summary":"Get webhook","operationId":"getApiWebhooksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Webhooks"],"summary":"Update webhook","operationId":"putApiWebhooksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Webhooks"],"summary":"Delete webhook","operationId":"deleteApiWebhooksByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{id}/test":{"post":{"tags":["Webhooks"],"summary":"Create test","operationId":"postApiWebhooksByidTest","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/analytics":{"get":{"tags":["Webhooks"],"summary":"--- Analytics ---","operationId":"getApiWebhooksBywebhookidAnalytics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/analytics/compute":{"post":{"tags":["Webhooks"],"summary":"Create compute","operationId":"postApiWebhooksBywebhookidAnalyticsCompute","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/dead-letter":{"get":{"tags":["Webhooks"],"summary":"Per-webhook dead letter queue","operationId":"getApiWebhooksBywebhookidDeadLetter","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/deliveries":{"get":{"tags":["Webhooks"],"summary":"--- Delivery Log ---","operationId":"getApiWebhooksBywebhookidDeliveries","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/replay":{"post":{"tags":["Webhooks"],"summary":"--- Replay Requests ---","operationId":"postApiWebhooksBywebhookidReplay","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/signing-keys":{"post":{"tags":["Webhooks"],"summary":"--- Signing Keys ---","operationId":"postApiWebhooksBywebhookidSigningKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Webhooks"],"summary":"List signing keys","operationId":"getApiWebhooksBywebhookidSigningKeys","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/transform":{"get":{"tags":["Webhooks"],"summary":"List transform","operationId":"getApiWebhooksBywebhookidTransform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Webhooks"],"summary":"Create transform","operationId":"postApiWebhooksBywebhookidTransform","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/transform/preview":{"post":{"tags":["Webhooks"],"summary":"Create preview","operationId":"postApiWebhooksBywebhookidTransformPreview","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webhooks/{webhookId}/transform/{transformId}":{"get":{"tags":["Webhooks"],"summary":"Get transform","operationId":"getApiWebhooksBywebhookidTransformBytransformid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transformId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Webhooks"],"summary":"Update transform","operationId":"putApiWebhooksBywebhookidTransformBytransformid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transformId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Webhooks"],"summary":"Delete transform","operationId":"deleteApiWebhooksBywebhookidTransformBytransformid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"transformId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/webrtc/turn-credentials":{"post":{"tags":["Webrtc"],"summary":"across asymmetric NATs. See src/Services/Webrtc/TurnCredentialService.php.","operationId":"postApiWebrtcTurnCredentials","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/channels":{"get":{"tags":["WebSocket"],"summary":"Channel management","operationId":"getApiWebsocketChannels","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["WebSocket"],"summary":"Create channels","operationId":"postApiWebsocketChannels","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/channels/{id}":{"put":{"tags":["WebSocket"],"summary":"Update channel","operationId":"putApiWebsocketChannelsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["WebSocket"],"summary":"Delete channel","operationId":"deleteApiWebsocketChannelsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/channels/{id}/messages":{"get":{"tags":["WebSocket"],"summary":"Message history","operationId":"getApiWebsocketChannelsByidMessages","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/channels/{id}/publish":{"post":{"tags":["WebSocket"],"summary":"REST-to-WebSocket publish bridge","operationId":"postApiWebsocketChannelsByidPublish","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/connections":{"get":{"tags":["WebSocket"],"summary":"Connection management","operationId":"getApiWebsocketConnections","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/connections/{id}":{"delete":{"tags":["WebSocket"],"summary":"Delete connection","operationId":"deleteApiWebsocketConnectionsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/info":{"get":{"tags":["WebSocket"],"summary":"Public endpoint - server info (no auth required)","operationId":"getApiWebsocketInfo","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/websocket/stats":{"get":{"tags":["WebSocket"],"summary":"Admin endpoint - server stats","operationId":"getApiWebsocketStats","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows":{"post":{"tags":["Workflows"],"summary":"----- Workflow/State Machine Routes -----","operationId":"postApiWorkflows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Workflows"],"summary":"List workflows","operationId":"getApiWorkflows","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{id}":{"get":{"tags":["Workflows"],"summary":"Get workflow","operationId":"getApiWorkflowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Workflows"],"summary":"Update workflow","operationId":"putApiWorkflowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Workflows"],"summary":"Delete workflow","operationId":"deleteApiWorkflowsByid","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{id}/transition":{"post":{"tags":["Workflows"],"summary":"Create transition","operationId":"postApiWorkflowsByidTransition","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{workflowId}/versions":{"post":{"tags":["Workflows"],"summary":"Workflow definition versions","operationId":"postApiWorkflowsByworkflowidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Workflows"],"summary":"List versions","operationId":"getApiWorkflowsByworkflowidVersions","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{workflowId}/versions/compare":{"post":{"tags":["Workflows"],"summary":"Create compare","operationId":"postApiWorkflowsByworkflowidVersionsCompare","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{workflowId}/versions/restore":{"post":{"tags":["Workflows"],"summary":"Create restore","operationId":"postApiWorkflowsByworkflowidVersionsRestore","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/workflows/{workflowId}/versions/{versionNumber}":{"get":{"tags":["Workflows"],"summary":"Get version","operationId":"getApiWorkflowsByworkflowidVersionsByversionnumber","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"versionNumber","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/_capacity":{"get":{"tags":["Apps"],"summary":"looking at, so a null is never mistaken for a zero.","operationId":"getAppsCapacity","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/_health":{"get":{"tags":["Apps"],"summary":"List  health","operationId":"getAppsHealth","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}":{"get":{"tags":["Apps"],"summary":"==================================================================","operationId":"getAppsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/*":{"post":{"tags":["Apps"],"summary":"Create *","operationId":"postAppsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Apps"],"summary":"List *","operationId":"getAppsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/auth":{"get":{"tags":["Apps"],"summary":"==================================================================","operationId":"getAppsByslugAuth","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/d/{deviceId}":{"get":{"tags":["Apps"],"summary":"Get d","operationId":"getAppsByslugDBydeviceid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/d/{deviceId}/*":{"get":{"tags":["Apps"],"summary":"List *","operationId":"getAppsByslugDBydeviceid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"deviceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/g/{passId}":{"get":{"tags":["Apps"],"summary":"==================================================================","operationId":"getAppsByslugGBypassid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"passId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/g/{passId}/*":{"get":{"tags":["Apps"],"summary":"==================================================================","operationId":"getAppsByslugGBypassid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"passId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/guest/{token}":{"get":{"tags":["Apps"],"summary":"is the credential.","operationId":"getAppsByslugGuestBytoken","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/icon-{size}.png":{"get":{"tags":["Apps"],"summary":"==================================================================","operationId":"getAppsByslugIconBysizePng","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"size","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/icon.svg":{"get":{"tags":["Apps"],"summary":"skip this entry and fall back to the PNG URL below.","operationId":"getAppsByslugIconSvg","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/login":{"post":{"tags":["Apps"],"summary":"==================================================================","operationId":"postAppsByslugLogin","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/logout":{"post":{"tags":["Apps"],"summary":"==================================================================","operationId":"postAppsByslugLogout","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Apps"],"summary":"+ post-logout redirect.","operationId":"getAppsByslugLogout","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/manifest.webmanifest":{"get":{"tags":["Apps"],"summary":"List manifest.webmanifest","operationId":"getAppsByslugManifestWebmanifest","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/open":{"get":{"tags":["Apps"],"summary":"/admin/login?return=..., coming back to this route after login.","operationId":"getAppsByslugOpen","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/pub":{"get":{"tags":["Apps"],"summary":"List pub","operationId":"getAppsByslugPub","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/pub/*":{"get":{"tags":["Apps"],"summary":"List *","operationId":"getAppsByslugPub","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/select-owner":{"get":{"tags":["Apps"],"summary":"(used by an \"in-app switch user\" link).","operationId":"getAppsByslugSelectOwner","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Apps"],"summary":"Create select owner","operationId":"postAppsByslugSelectOwner","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/session/refresh":{"post":{"tags":["Apps"],"summary":"==================================================================","operationId":"postAppsByslugSessionRefresh","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/sw.js":{"get":{"tags":["Apps"],"summary":"to keep the status, body, and content-type consistent.","operationId":"getAppsByslugSwJs","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/apps/{slug}/version":{"get":{"tags":["Apps"],"summary":"defeating the whole point.","operationId":"getAppsByslugVersion","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/change-password":{"post":{"tags":["Authentication"],"summary":"Create change password","operationId":"postAuthByslugChangePassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/forgot-password":{"post":{"tags":["Authentication"],"summary":"Create forgot password","operationId":"postAuthByslugForgotPassword","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/login":{"post":{"tags":["Authentication"],"summary":"Create login","operationId":"postAuthByslugLogin","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/logout":{"post":{"tags":["Authentication"],"summary":"Create logout","operationId":"postAuthByslugLogout","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/magic-link/request":{"post":{"tags":["Authentication"],"summary":"Create request","operationId":"postAuthByslugMagicLinkRequest","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/magic-link/verify":{"post":{"tags":["Authentication"],"summary":"Create verify","operationId":"postAuthByslugMagicLinkVerify","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/oauth/callback":{"post":{"tags":["Authentication"],"summary":"Create callback","operationId":"postAuthByslugOauthCallback","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/oauth/connections":{"get":{"tags":["Authentication"],"summary":"List connections","operationId":"getAuthByslugOauthConnections","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/oauth/providers":{"get":{"tags":["Authentication"],"summary":"List providers","operationId":"getAuthByslugOauthProviders","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/oauth/{provider}":{"delete":{"tags":["Authentication"],"summary":"Delete oauth","operationId":"deleteAuthByslugOauthByprovider","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/oauth/{provider}/authorize":{"get":{"tags":["Authentication"],"summary":"List authorize","operationId":"getAuthByslugOauthByproviderAuthorize","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/profile":{"get":{"tags":["Authentication"],"summary":"Protected consumer endpoints (consumer JWT required)","operationId":"getAuthByslugProfile","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Authentication"],"summary":"Update profile","operationId":"putAuthByslugProfile","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/refresh":{"post":{"tags":["Authentication"],"summary":"Create refresh","operationId":"postAuthByslugRefresh","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/register":{"post":{"tags":["Authentication"],"summary":"Public consumer auth endpoints (no authentication required)","operationId":"postAuthByslugRegister","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/reset-password":{"post":{"tags":["Authentication"],"summary":"Create reset password","operationId":"postAuthByslugResetPassword","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/verify-2fa":{"post":{"tags":["Authentication"],"summary":"Create verify 2fa","operationId":"postAuthByslugVerify2fa","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/auth/{slug}/verify-email":{"get":{"tags":["Authentication"],"summary":"List verify email","operationId":"getAuthByslugVerifyEmail","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/autodiscover/autodiscover.xml":{"post":{"tags":["Autodiscover"],"summary":"Create autodiscover.xml","operationId":"postAutodiscoverAutodiscoverXml","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/d/{slug}":{"get":{"tags":["D"],"summary":"Public dashboard routes (no auth)","operationId":"getDByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["D"],"summary":"Create d","operationId":"postDByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/d/{slug}/widget/{widgetId}/data":{"get":{"tags":["D"],"summary":"List data","operationId":"getDByslugWidgetBywidgetidData","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}":{"get":{"tags":["Data room"],"summary":"--- Public Access (no auth required) ---","operationId":"getDataRoomBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/access":{"post":{"tags":["Data room"],"summary":"Create access","operationId":"postDataRoomBytokenAccess","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/delta":{"get":{"tags":["Data room"],"summary":"List delta","operationId":"getDataRoomBytokenCollaborateDelta","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/edit":{"post":{"tags":["Data room"],"summary":"--- Live Collaboration (public, no auth \u2014 uses participant_id) ---","operationId":"postDataRoomBytokenCollaborateEdit","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/heartbeat":{"post":{"tags":["Data room"],"summary":"Create heartbeat","operationId":"postDataRoomBytokenCollaborateHeartbeat","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/leave":{"post":{"tags":["Data room"],"summary":"Create leave","operationId":"postDataRoomBytokenCollaborateLeave","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/operation":{"post":{"tags":["Data room"],"summary":"Create operation","operationId":"postDataRoomBytokenCollaborateOperation","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/presence":{"get":{"tags":["Data room"],"summary":"List presence","operationId":"getDataRoomBytokenCollaboratePresence","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/collaborate/state":{"get":{"tags":["Data room"],"summary":"List state","operationId":"getDataRoomBytokenCollaborateState","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/content":{"get":{"tags":["Data room"],"summary":"List content","operationId":"getDataRoomBytokenContent","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/event":{"post":{"tags":["Data room"],"summary":"Create event","operationId":"postDataRoomBytokenEvent","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/message":{"post":{"tags":["Data room"],"summary":"Create message","operationId":"postDataRoomBytokenMessage","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/messages":{"get":{"tags":["Data room"],"summary":"List messages","operationId":"getDataRoomBytokenMessages","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/data-room/{token}/verify-email":{"post":{"tags":["Data room"],"summary":"Create verify email","operationId":"postDataRoomBytokenVerifyEmail","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/desk":{"get":{"tags":["Desk"],"summary":"List desk","operationId":"getDesk","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/desk/d/{deskId}":{"get":{"tags":["Desk"],"summary":"Get d","operationId":"getDeskDBydeskid","security":[],"parameters":[{"name":"deskId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs":{"get":{"tags":["Docs"],"summary":"Swagger UI (interactive docs)","operationId":"getDocs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs/getting-started":{"get":{"tags":["Docs"],"summary":"Getting started","operationId":"getDocsGettingStarted","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs/openapi.json":{"get":{"tags":["Docs"],"summary":"OpenAPI specification","operationId":"getDocsOpenapiJson","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs/openapi.yaml":{"get":{"tags":["Docs"],"summary":"List openapi.yaml","operationId":"getDocsOpenapiYaml","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs/redoc":{"get":{"tags":["Docs"],"summary":"Redoc (alternative docs style)","operationId":"getDocsRedoc","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/docs/sandbox":{"get":{"tags":["Docs"],"summary":"Interactive sandbox","operationId":"getDocsSandbox","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/editor/{endpointName}":{"get":{"tags":["Editor"],"summary":"============================================","operationId":"getEditorByendpointname","security":[],"parameters":[{"name":"endpointName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/email/unsubscribe/{token}":{"post":{"tags":["Email"],"summary":"The one-click endpoint. Must succeed without asking anything.","operationId":"postEmailUnsubscribeBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Email"],"summary":"message and would otherwise unsubscribe people who never clicked.","operationId":"getEmailUnsubscribeBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}":{"get":{"tags":["F"],"summary":"--- Public Access (no auth) ---","operationId":"getFByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/access":{"post":{"tags":["F"],"summary":"Create access","operationId":"postFByslugAccess","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/chunked-upload/init":{"post":{"tags":["F"],"summary":"--- Public Chunked Uploads ---","operationId":"postFByslugChunkedUploadInit","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/chunked-upload/{token}/chunk/{index}":{"post":{"tags":["F"],"summary":"Create chunk","operationId":"postFByslugChunkedUploadBytokenChunkByindex","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"index","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/chunked-upload/{token}/complete":{"post":{"tags":["F"],"summary":"Create complete","operationId":"postFByslugChunkedUploadBytokenComplete","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/dl/{fileId}":{"get":{"tags":["F"],"summary":"Get dl","operationId":"getFByslugDlByfileid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/files":{"get":{"tags":["F"],"summary":"List files","operationId":"getFByslugFiles","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/f/{slug}/upload":{"post":{"tags":["F"],"summary":"Create upload","operationId":"postFByslugUpload","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}":{"get":{"tags":["Forms"],"summary":"------------------------------------------","operationId":"getFormsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/analytics":{"post":{"tags":["Forms"],"summary":"Form analytics tracking (public, JSON)","operationId":"postFormsByslugAnalytics","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/definition":{"get":{"tags":["Forms"],"summary":"List definition","operationId":"getFormsByslugDefinition","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/draft":{"post":{"tags":["Forms"],"summary":"Draft save/load (public, JSON)","operationId":"postFormsByslugDraft","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Forms"],"summary":"List draft","operationId":"getFormsByslugDraft","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/hook/{fieldName}":{"post":{"tags":["Forms"],"summary":"Field change hook (AJAX, session-authenticated via CSRF)","operationId":"postFormsByslugHookByfieldname","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/lookup/{fieldName}":{"get":{"tags":["Forms"],"summary":"Data source lookup (public, JSON)","operationId":"getFormsByslugLookupByfieldname","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldName","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/results":{"get":{"tags":["Forms"],"summary":"Poll/Survey results (public)","operationId":"getFormsByslugResults","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/submit":{"post":{"tags":["Forms"],"summary":"Create submit","operationId":"postFormsByslugSubmit","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/forms/{slug}/track-abandonment":{"post":{"tags":["Forms"],"summary":"Form abandonment tracking (public, JSON)","operationId":"postFormsByslugTrackAbandonment","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/gw/{path}":{"get":{"tags":["Gw"],"summary":"============================================","operationId":"getGwBypath","security":[],"parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Gw"],"summary":"Create gw","operationId":"postGwBypath","security":[],"parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Gw"],"summary":"Update gw","operationId":"putGwBypath","security":[],"parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Gw"],"summary":"Patch gw","operationId":"patchGwBypath","security":[],"parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Gw"],"summary":"Delete gw","operationId":"deleteGwBypath","security":[],"parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Health check endpoints","operationId":"getHealth","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health/detailed":{"get":{"tags":["Health"],"summary":"List detailed","operationId":"getHealthDetailed","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health/live":{"get":{"tags":["Health"],"summary":"List live","operationId":"getHealthLive","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health/ready":{"get":{"tags":["Health"],"summary":"List ready","operationId":"getHealthReady","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/lc/{key}/avatar/{agentId}":{"get":{"tags":["Lc"],"summary":"The picture as the visitor's chat shows it (same origin as the widget).","operationId":"getLcBykeyAvatarByagentid","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/lc/{key}/loader.js":{"get":{"tags":["Lc"],"summary":"an external site includes: <script src=\"https://<api>/lc/<key>/loader.js\" async></script>","operationId":"getLcBykeyLoaderJs","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/lc/{key}/widget":{"get":{"tags":["Lc"],"summary":"List widget","operationId":"getLcBykeyWidget","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/mail/config-v1.1.xml":{"get":{"tags":["Mail"],"summary":"Email autoconfig/autodiscover XML endpoints (no auth - used by email clients)","operationId":"getMailConfigV11Xml","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/mcp":{"post":{"tags":["Mcp"],"summary":"Create mcp","operationId":"postMcp","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Mcp"],"summary":"Server-initiated SSE (GET /mcp) is not implemented yet \u2014 request/response only.","operationId":"getMcp","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/metrics":{"get":{"tags":["Health"],"summary":"Metrics endpoint (Prometheus format)","operationId":"getMetrics","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/metrics/json":{"get":{"tags":["Health"],"summary":"Metrics endpoint (JSON format)","operationId":"getMetricsJson","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/authorize":{"get":{"tags":["Oauth"],"summary":"Authorization endpoint: login + consent","operationId":"getOauthAuthorize","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Oauth"],"summary":"Create authorize","operationId":"postOauthAuthorize","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/device":{"get":{"tags":["Oauth"],"summary":"Device approval page (HTML)","description":"Browser page where the user signs in (email, password, 2FA; with a link to create an account), enters or confirms the code, sees the app name and scopes, and approves or denies. Optional query `user_code` pre-fills the code (`verification_uri_complete`).","operationId":"getOauthDevice","security":[],"parameters":[{"name":"user_code","in":"query","required":false,"schema":{"type":"string"},"description":"Pre-fills the code; case and dash do not matter"}],"responses":{"200":{"description":"HTML page"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Oauth"],"summary":"Device approval page form submissions (HTML)","description":"The approval page's own form posts (sign in, look up code, approve, deny). Not an API for clients.","operationId":"postOauthDevice","security":[],"responses":{"200":{"description":"HTML page"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/device_authorization":{"post":{"tags":["Oauth"],"summary":"Start a device sign-in (RFC 8628)","description":"Form-encoded or JSON. Available to clients allowed the device grant (Vault56 Code: `client_id=vault56-code`). `scope` is space-separated; omitted = all of the client's scopes (`openid email ai:invoke wallets:read`). Show `user_code` and `verification_uri` to the user, then poll `POST /oauth/token` every `interval` seconds.","operationId":"postOauthDeviceAuthorization","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_id":{"type":"string"},"scope":{"type":"string","description":"Space-separated"}},"required":["client_id"]}}}},"responses":{"200":{"description":"Device and user codes","content":{"application/json":{"schema":{"type":"object","properties":{"device_code":{"type":"string","description":"Secret; single use"},"user_code":{"type":"string","example":"BKTW-MZQR"},"verification_uri":{"type":"string"},"verification_uri_complete":{"type":"string"},"expires_in":{"type":"integer","example":600},"interval":{"type":"integer","example":5}}}}}},"400":{"description":"`unauthorized_client` (client may not use the device grant) or `invalid_scope`","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"}}}}}},"401":{"description":"`invalid_client`: unknown or blocked client","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/register":{"post":{"tags":["Oauth"],"summary":"Dynamic Client Registration (RFC 7591)","operationId":"postOauthRegister","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/revoke":{"post":{"tags":["Oauth"],"summary":"Revoke a token (RFC 7009)","description":"Form-encoded or JSON. Revokes the whole sign-in the token belongs to: every refresh token in its rotation chain and every access token it issued. Always 200 `{}` for a well-formed request, whether or not the token existed. If `client_id` is sent it must match the token's client, or nothing is revoked.","operationId":"postOauthRevoke","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"A refresh token or an access token"},"token_type_hint":{"type":"string","enum":["refresh_token","access_token"]},"client_id":{"type":"string"}},"required":["token"]}}}},"responses":{"200":{"description":"Revoked (or nothing to revoke)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"`invalid_request`: `token` missing","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/token":{"post":{"tags":["Oauth"],"summary":"Token endpoint (authorization_code, refresh_token, device_code)","description":"Form-encoded (`application/x-www-form-urlencoded`) or JSON. Grants: `authorization_code` (`code`, `client_id`, `code_verifier`, `redirect_uri` identical to the one used at authorize, port included); `refresh_token` (`refresh_token`, optional `client_id`; rotates, same scopes, reuse = `invalid_grant`); `urn:ietf:params:oauth:grant-type:device_code` (`device_code`, `client_id`). Device-code polling answers 400 `authorization_pending`, `slow_down` (with the new `interval`), `access_denied`, `expired_token` or `invalid_grant` until approved. Unknown grant: 400 `unsupported_grant_type`. Responses carry `Cache-Control: no-store`.","operationId":"postOauthToken","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"grant_type":{"type":"string","enum":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:device_code"]},"client_id":{"type":"string","description":"Required for authorization_code and device_code"},"code":{"type":"string"},"code_verifier":{"type":"string"},"redirect_uri":{"type":"string"},"refresh_token":{"type":"string"},"device_code":{"type":"string"}},"required":["grant_type"]}}}},"responses":{"200":{"description":"Tokens","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string","example":"Bearer"},"expires_in":{"type":"integer","example":3600},"refresh_token":{"type":"string","description":"60 days, single use (rotates)"},"scope":{"type":"string"},"id_token":{"type":"string","description":"When `openid` was granted"}}}}}},"400":{"description":"`invalid_request`, `invalid_client`, `invalid_grant`, `unsupported_grant_type`, `authorization_pending`, `slow_down` (+ `interval`), `access_denied`, `expired_token`","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/oauth/userinfo":{"get":{"tags":["Oauth"],"summary":"OIDC Core permits it.","operationId":"getOauthUserinfo","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Oauth"],"summary":"Create userinfo","operationId":"postOauthUserinfo","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pay-invoice/{token}":{"get":{"tags":["Pay invoice"],"summary":"Show invoice payment page (public, uses token for auth)","operationId":"getPayInvoiceBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/pay-invoice/{token}/charge":{"post":{"tags":["Pay invoice"],"summary":"Charge invoice (public, uses token for auth)","operationId":"postPayInvoiceBytokenCharge","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/payment/package/{token}":{"get":{"tags":["Payment"],"summary":"hashed, single-purpose, and gone once the purchase settles.","operationId":"getPaymentPackageBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/payment/package/{token}/complete":{"post":{"tags":["Payment"],"summary":"Create complete","operationId":"postPaymentPackageBytokenComplete","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/payment/{token}":{"get":{"tags":["Payment"],"summary":"Show payment page (public, uses token for auth)","operationId":"getPaymentBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/payment/{token}/confirm":{"post":{"tags":["Payment"],"summary":"Confirm payment method (public, uses token for auth)","operationId":"postPaymentBytokenConfirm","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}":{"get":{"tags":["Portals"],"summary":"============================================","operationId":"getPortalsByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/auth":{"post":{"tags":["Portals"],"summary":"Create auth","operationId":"postPortalsByslugAuth","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/chart/adhoc":{"post":{"tags":["Portals"],"summary":"Create adhoc","operationId":"postPortalsByslugChartAdhoc","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/chart/{index}":{"get":{"tags":["Portals"],"summary":"Get chart","operationId":"getPortalsByslugChartByindex","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"index","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/data":{"get":{"tags":["Portals"],"summary":"List data","operationId":"getPortalsByslugData","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/export/{format}":{"get":{"tags":["Portals"],"summary":"Get export","operationId":"getPortalsByslugExportByformat","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/portals/{slug}/record/{id}":{"get":{"tags":["Portals"],"summary":"Get record","operationId":"getPortalsByslugRecordByid","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/releases/{slug}":{"get":{"tags":["Releases"],"summary":"---- Public release pages (no auth; only serves is_public=true products) ----","operationId":"getReleasesByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/releases/{slug}/feed.rss":{"get":{"tags":["Releases"],"summary":"List feed.rss","operationId":"getReleasesByslugFeedRss","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/releases/{slug}/{version}":{"get":{"tags":["Releases"],"summary":"Get release","operationId":"getReleasesByslugByversion","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/review/{token}":{"get":{"tags":["Review"],"summary":"Get review","operationId":"getReviewBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Review"],"summary":"Create review","operationId":"postReviewBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{code}":{"get":{"tags":["S"],"summary":"enumeration signature for anyone scanning.","operationId":"getSBycode","security":[],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{token}":{"get":{"tags":["S"],"summary":"--- External Share Public Routes (no auth) ---","operationId":"getSBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{token}/dl/{fileId}":{"get":{"tags":["S"],"summary":"Get dl","operationId":"getSBytokenDlByfileid","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{token}/download":{"get":{"tags":["S"],"summary":"List download","operationId":"getSBytokenDownload","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{token}/files":{"get":{"tags":["S"],"summary":"List files","operationId":"getSBytokenFiles","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/s/{token}/verify":{"post":{"tags":["S"],"summary":"Create verify","operationId":"postSBytokenVerify","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/shield/v1.js":{"options":{"tags":["Shield"],"summary":"time at the static layer, because the URL changes every deploy.","operationId":"optionsShieldV1Js","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Shield"],"summary":"List v1.js","operationId":"getShieldV1Js","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/.well-known/jwks.json":{"get":{"tags":["Sso"],"summary":"List jwks.json","operationId":"getSsoByslugWellKnownJwksJson","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/.well-known/openid-configuration":{"get":{"tags":["Sso"],"summary":"--- Public SSO endpoints (no authentication required) ---","operationId":"getSsoByslugWellKnownOpenidConfiguration","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/authorize":{"get":{"tags":["Sso"],"summary":"List authorize","operationId":"getSsoByslugAuthorize","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/callback/{provider}":{"get":{"tags":["Sso"],"summary":"Get callback","operationId":"getSsoByslugCallbackByprovider","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Sso"],"summary":"code+state to the callback instead of using a GET query. Same handler.","operationId":"postSsoByslugCallbackByprovider","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/login":{"post":{"tags":["Sso"],"summary":"Create login","operationId":"postSsoByslugLogin","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/token":{"post":{"tags":["Sso"],"summary":"Create token","operationId":"postSsoByslugToken","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/sso/{slug}/userinfo":{"get":{"tags":["Sso"],"summary":"List userinfo","operationId":"getSsoByslugUserinfo","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/storage/agent-maps/{filename}":{"get":{"tags":["Storage"],"summary":"Serve map images from storage","operationId":"getStorageAgentMapsByfilename","security":[],"parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio":{"get":{"tags":["Studio"],"summary":"List studio","operationId":"getStudio","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/p/{projectId}":{"get":{"tags":["Studio"],"summary":"Get p","operationId":"getStudioPByprojectid","security":[],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/preview-assets/{projectId}/{token}/*":{"get":{"tags":["Studio"],"summary":"List *","operationId":"getStudioPreviewAssetsByprojectidBytoken","security":[],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/preview-frame":{"get":{"tags":["Studio"],"summary":"List preview frame","operationId":"getStudioPreviewFrame","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/project-assets/{projectId}/*":{"get":{"tags":["Studio"],"summary":"List *","operationId":"getStudioProjectAssetsByprojectid","security":[],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/push-worker.js":{"get":{"tags":["Studio"],"summary":"List push worker.js","operationId":"getStudioPushWorkerJs","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/template-assets/{slug}/assets/{name}":{"get":{"tags":["Studio"],"summary":"Get asset","operationId":"getStudioTemplateAssetsByslugAssetsByname","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/template-preview/{slug}":{"get":{"tags":["Studio"],"summary":"Get template preview","operationId":"getStudioTemplatePreviewByslug","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/upload/{token}":{"get":{"tags":["Studio"],"summary":"Get upload","operationId":"getStudioUploadBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["Studio"],"summary":"The same page without script: a plain form with several files.","operationId":"postStudioUploadBytoken","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/studio/upload/{token}/file":{"post":{"tags":["Studio"],"summary":"One image, the request body itself (the page's script sends them one by one, three at a time).","operationId":"postStudioUploadBytokenFile","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/t/{siteId}/collect":{"post":{"tags":["T"],"summary":"Create collect","operationId":"postTBysiteidCollect","security":[],"parameters":[{"name":"siteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"options":{"tags":["T"],"summary":"OPTIONS collect","operationId":"optionsTBysiteidCollect","security":[],"parameters":[{"name":"siteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/t/{siteId}/pixel.gif":{"get":{"tags":["T"],"summary":"List pixel.gif","operationId":"getTBysiteidPixelGif","security":[{"BearerAuth":[]},{"AppTokenAuth":[]}],"parameters":[{"name":"siteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/t/{siteId}/script.js":{"get":{"tags":["T"],"summary":"------------------------------------------","operationId":"getTBysiteidScriptJs","security":[],"parameters":[{"name":"siteId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/webhook/payments/{id}":{"post":{"tags":["Webhook"],"summary":"Stripe dashboard.","operationId":"postWebhookPaymentsByid","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/wh/{appSlug}/{webhookSlug}":{"post":{"tags":["Wh"],"summary":"============================================","operationId":"postWhByappslugBywebhookslug","security":[],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"webhookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"tags":["Wh"],"summary":"Update wh","operationId":"putWhByappslugBywebhookslug","security":[],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"webhookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["Wh"],"summary":"Patch wh","operationId":"patchWhByappslugBywebhookslug","security":[],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"webhookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["Wh"],"summary":"Delete wh","operationId":"deleteWhByappslugBywebhookslug","security":[],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"webhookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"tags":["Wh"],"summary":"Get wh","operationId":"getWhByappslugBywebhookslug","security":[],"parameters":[{"name":"appSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"webhookSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT access token obtained from /api/auth/login"},"AppTokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Long-lived app token with Bearer prefix"}},"schemas":{"SuccessResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","description":"Response payload"}}},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"string","description":"Error message"}}},"PaginatedResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object"}},"pagination":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total_pages":{"type":"integer"}}}}},"CursorPaginatedResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"type":"object"}},"pagination":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true},"prev_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean"}}}}}}},"tags":[{"name":" union"},{"name":".well known"},{"name":"Access policies"},{"name":"Account"},{"name":"Activity"},{"name":"Admin"},{"name":"Advisories"},{"name":"Agent groups"},{"name":"Agent telemetry"},{"name":"Agent tokens"},{"name":"Agents"},{"name":"Ai"},{"name":"Ai assistants"},{"name":"Ai builder"},{"name":"Ai instructions"},{"name":"Alert rules"},{"name":"Analytics"},{"name":"Annotations"},{"name":"Anomaly"},{"name":"Anonymization"},{"name":"App events"},{"name":"App hooks"},{"name":"App webhooks"},{"name":"App workers"},{"name":"Applications"},{"name":"Approval Workflows"},{"name":"Approval requests"},{"name":"Apps"},{"name":"Attachments"},{"name":"Auth gateways"},{"name":"Authentication"},{"name":"Autodiscover"},{"name":"Automation actions"},{"name":"Automation flows"},{"name":"Automation logs"},{"name":"Automations"},{"name":"Backup"},{"name":"Backups"},{"name":"Batch operations"},{"name":"Beta"},{"name":"Bidirectional sync"},{"name":"Billing"},{"name":"Boards"},{"name":"Bookmarks"},{"name":"Bundles"},{"name":"Cache"},{"name":"Calculated fields"},{"name":"Canary deployments"},{"name":"Capability tokens"},{"name":"Cdc streams"},{"name":"Change requests"},{"name":"Channels"},{"name":"Cloud usage"},{"name":"Cnc"},{"name":"Collaboration"},{"name":"Comments"},{"name":"Compliance"},{"name":"Compliance autopilot"},{"name":"Compliance engine"},{"name":"Compositions"},{"name":"Connectors"},{"name":"Consents"},{"name":"Creone integrations"},{"name":"Currency"},{"name":"Custodia Backup"},{"name":"Custom domains"},{"name":"D"},{"name":"Dashboard"},{"name":"Dashboards"},{"name":"Data alerts"},{"name":"Data branches"},{"name":"Data flows"},{"name":"Data gen profiles"},{"name":"Data membranes"},{"name":"Data pipelines"},{"name":"Data portals"},{"name":"Data quality"},{"name":"Data residency"},{"name":"Data room"},{"name":"Data rooms"},{"name":"Data sandboxes"},{"name":"Debug"},{"name":"Dedup"},{"name":"Dedup rules"},{"name":"Deprecations"},{"name":"Desk"},{"name":"Diffs"},{"name":"Dns"},{"name":"Docs"},{"name":"Docs assistant"},{"name":"Dynamic Data"},{"name":"Editor"},{"name":"Email"},{"name":"Embargoes"},{"name":"Embed"},{"name":"Embeddable tables"},{"name":"Encryption"},{"name":"Endpoint access tokens"},{"name":"Endpoint fields"},{"name":"Endpoint mesh"},{"name":"Endpoint relationships"},{"name":"Endpoints"},{"name":"Entity relationships"},{"name":"Environment snapshots"},{"name":"Environments"},{"name":"Ephemeral"},{"name":"Erp"},{"name":"Escrow"},{"name":"Export"},{"name":"Export profiles"},{"name":"Export runs"},{"name":"F"},{"name":"Feature costs"},{"name":"Feature flags"},{"name":"Federation"},{"name":"Field permission policies"},{"name":"Field permissions"},{"name":"File Library"},{"name":"File area import jobs"},{"name":"File areas"},{"name":"File areas \u2014 chunked upload"},{"name":"File preview"},{"name":"Firewall policies"},{"name":"Firewall rules"},{"name":"Fission fusion"},{"name":"Flow collectors"},{"name":"Following"},{"name":"Forecasts"},{"name":"Forks"},{"name":"Formats"},{"name":"Forms"},{"name":"Free tier"},{"name":"Functions"},{"name":"Gateway"},{"name":"Geofences"},{"name":"GraphQL"},{"name":"Gravity wells"},{"name":"Groups"},{"name":"Gw"},{"name":"Health"},{"name":"Honeypots"},{"name":"Hooks"},{"name":"Import templates"},{"name":"Inbound webhooks"},{"name":"Internal"},{"name":"Job Queue"},{"name":"Key vault"},{"name":"Key vault \u2014 sealed secrets"},{"name":"Lc"},{"name":"Leaderboards"},{"name":"Licensing"},{"name":"Live chat"},{"name":"Locks"},{"name":"Machine bridges"},{"name":"Mail"},{"name":"Maintenance"},{"name":"Marketplace"},{"name":"Masking profiles"},{"name":"Masking rules"},{"name":"Matchmaking"},{"name":"Mcp"},{"name":"Messaging"},{"name":"Ml"},{"name":"Mock"},{"name":"Monetization"},{"name":"My"},{"name":"Namespaces"},{"name":"Network devices"},{"name":"Network notes"},{"name":"Network snmp"},{"name":"Network traffic"},{"name":"Networks"},{"name":"Nl"},{"name":"Notarizations"},{"name":"Notifications"},{"name":"Oauth"},{"name":"Organizations"},{"name":"Package purchases"},{"name":"Packages"},{"name":"Pay invoice"},{"name":"Payment"},{"name":"Payment processors"},{"name":"Payments"},{"name":"Pdf"},{"name":"Performance"},{"name":"Permissions"},{"name":"Pipeline observability"},{"name":"Pipelines"},{"name":"Plugin marketplace"},{"name":"Portable bundles"},{"name":"Portals"},{"name":"Presence"},{"name":"Pricing"},{"name":"Processing"},{"name":"Processing jobs"},{"name":"Processing rules"},{"name":"Products"},{"name":"Provenance signatures"},{"name":"Pub"},{"name":"Public"},{"name":"Publishers"},{"name":"Push"},{"name":"Push subscriptions"},{"name":"Quarantine"},{"name":"Queries"},{"name":"Query cost"},{"name":"Queues"},{"name":"Ransomware protection"},{"name":"Rate limits"},{"name":"Realtime"},{"name":"Reconciliation"},{"name":"Record subscriptions"},{"name":"Record ttl"},{"name":"Record views"},{"name":"Records"},{"name":"Recurring Records"},{"name":"Recurring record runs"},{"name":"Regions"},{"name":"Relations"},{"name":"Release manager"},{"name":"Releases"},{"name":"Replay cassettes"},{"name":"Replication"},{"name":"Requests"},{"name":"Resonance rules"},{"name":"Resource pools"},{"name":"Resource shares"},{"name":"Response pipelines"},{"name":"Retention policies"},{"name":"Review"},{"name":"Revisions"},{"name":"Rls policies"},{"name":"Roles"},{"name":"S"},{"name":"Sandboxes"},{"name":"Scheduled actions"},{"name":"Scheduled mutations"},{"name":"Scheduled reports"},{"name":"Schema archaeology"},{"name":"Schema import"},{"name":"Script Hooks"},{"name":"Scripts"},{"name":"Sdk"},{"name":"Search"},{"name":"Security"},{"name":"Semantic links"},{"name":"Sequences"},{"name":"Sessions"},{"name":"Settings"},{"name":"Share"},{"name":"Shared"},{"name":"Shield"},{"name":"Signing keys"},{"name":"Site accounts"},{"name":"Sla"},{"name":"Smart links"},{"name":"Snapshots"},{"name":"Software"},{"name":"Spatial"},{"name":"Sso"},{"name":"State sync"},{"name":"Storage"},{"name":"Storage providers"},{"name":"Studio"},{"name":"Sync"},{"name":"T"},{"name":"Tags"},{"name":"Templates"},{"name":"Temporal triggers"},{"name":"Tenants"},{"name":"Test suites"},{"name":"Time series"},{"name":"Time travel"},{"name":"Transactions"},{"name":"Union views"},{"name":"Updates"},{"name":"Usage"},{"name":"User attributes"},{"name":"Users"},{"name":"V1"},{"name":"Validation profiles"},{"name":"Validation rules"},{"name":"Views"},{"name":"Virtual endpoints"},{"name":"Wasm"},{"name":"Web apps"},{"name":"WebSocket"},{"name":"Webhook"},{"name":"Webhooks"},{"name":"Webrtc"},{"name":"Wh"},{"name":"Workflows"},{"name":"vault56 AI Messages API"}]}