{"openapi":"3.0.0","info":{"title":"CleverCare Backend API","description":"The official API for the CleverCare platform, handling user, session, and data management.","version":"0.0.1","termsOfService":"https://clever-care.cz/terms","contact":{"name":"Support Team","url":"https://clever-care.cz/support","email":"support@clever-care.cz"}},"externalDocs":{"description":"Full API docs","url":"https://docs.clever-care.cz"},"paths":{"/.well-known/jwks.json":{"get":{"x-controller-name":"OidcController","x-operation-name":"jwks","tags":["OIDC"],"summary":"JSON Web Key Set Endpoint","description":"Returns the JSON Web Key Set (JWKS) containing public keys used to verify tokens signed by the authorization server.","operationId":"jwks","responses":{"200":{"description":"JSON Web Key Set","content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"kty":{"type":"string"},"use":{"type":"string"},"kid":{"type":"string"},"alg":{"type":"string"},"n":{"type":"string"},"e":{"type":"string"}}}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/.well-known/openid-configuration":{"get":{"x-controller-name":"OidcController","x-operation-name":"openidConfiguration","tags":["OIDC"],"summary":"OpenID Connect Discovery Endpoint","description":"Returns OpenID Provider configuration metadata following the OpenID Connect Discovery 1.0 specification.","operationId":"openidConfiguration","responses":{"200":{"description":"OpenID Connect Discovery Metadata","content":{"application/json":{"schema":{"type":"object","properties":{"issuer":{"type":"string"},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"jwks_uri":{"type":"string"},"revocation_endpoint":{"type":"string"},"introspection_endpoint":{"type":"string"},"end_session_endpoint":{"type":"string"},"scopes_supported":{"type":"array","items":{"type":"string"}},"response_types_supported":{"type":"array","items":{"type":"string"}},"subject_types_supported":{"type":"array","items":{"type":"string"}},"id_token_signing_alg_values_supported":{"type":"array","items":{"type":"string"}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string"},"description":"PKCE methods supported, e.g. [\"S256\"] (required by Cloudflare Access)."},"claims_supported":{"type":"array","items":{"type":"string"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/permissions/{permissionId}":{"delete":{"x-controller-name":"AbacController","x-operation-name":"deletePermission","tags":["Permissions Management"],"summary":"Delete Permission","description":"Deletes a permission. Fails with 409 while the permission is still granted to any role.","operationId":"deletePermission","responses":{"204":{"description":"Permission deleted.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Permission not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Permission is still granted to a role.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"permissionId","in":"path","required":true,"description":"The unique numeric ID of the permission","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/permissions":{"post":{"x-controller-name":"AbacController","x-operation-name":"createPermission","tags":["Permissions Management"],"summary":"Create Permission","description":"Creates a new permission. The name doubles as the ABAC scope used in @authorize metadata.","operationId":"createPermission","responses":{"200":{"description":"Created permission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PermissionExcluding_id-createdAt_"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"A permission with this name already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":100},"description":{"type":"string"}}}}},"required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"AbacController","x-operation-name":"listPermissions","tags":["Permissions Management"],"summary":"List Permissions","description":"Lists every permission. Permission names are ABAC scopes.","operationId":"listPermissions","responses":{"200":{"description":"Array of permissions.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Permission"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/policies/{policyId}":{"delete":{"x-controller-name":"AbacController","x-operation-name":"deletePolicy","tags":["ABAC Policies"],"summary":"Delete Policy Condition","description":"Deletes a policy condition by id.","operationId":"deletePolicy","responses":{"204":{"description":"Policy condition deleted.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Policy condition not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"policyId","in":"path","required":true,"description":"The unique numeric ID of the policy","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/policies":{"post":{"x-controller-name":"AbacController","x-operation-name":"createPolicy","tags":["ABAC Policies"],"summary":"Create Policy Condition","description":"Creates a policy condition binding a condition type to a role+permission (optionally company-scoped). Condition types: allow_always, deny, time_window[:HH:MM-HH:MM] (UTC interval).","operationId":"createPolicy","responses":{"200":{"description":"Created policy condition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthPolicyConditionExcluding_id_"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Unknown or malformed condition type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Role, permission or company not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"An identical condition already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["roleId","permissionId","conditionType"],"properties":{"roleId":{"type":"number"},"permissionId":{"type":"number"},"applicableCompanyId":{"type":"number","nullable":true,"description":"Omit for a condition that applies globally."},"conditionType":{"type":"string","maxLength":50,"example":"time_window:09:00-17:00"}}}}},"required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"AbacController","x-operation-name":"listPolicies","tags":["ABAC Policies"],"summary":"List Policy Conditions","description":"Lists auth_policy_condition entries, optionally filtered by role, permission or company.","operationId":"listPolicies","responses":{"200":{"description":"Array of policy conditions.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuthPolicyCondition"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"roleId","in":"path","required":true,"description":"The unique numeric ID of the role","schema":{"type":"number"}},{"name":"permissionId","in":"path","required":true,"description":"The unique numeric ID of the permission","schema":{"type":"number"}},{"name":"companyId","in":"path","required":true,"description":"The unique numeric ID of the company","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/roles/{roleId}/permissions":{"put":{"x-controller-name":"AbacController","x-operation-name":"setRolePermissions","tags":["Roles Management"],"summary":"Set Role Permissions","description":"Replaces the complete permission set of a role. Any permission not in the payload is revoked.","operationId":"setRolePermissions","responses":{"200":{"description":"Role with the new permission ids.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"permissionIds":{"type":"array","items":{"type":"number"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"One or more permission ids do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Role not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"roleId","in":"path","required":true,"description":"The unique numeric ID of the role","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["permissionIds"],"properties":{"permissionIds":{"type":"array","items":{"type":"number"},"description":"Complete set of permission ids for the role."}}}}},"required":true,"x-parameter-index":1}},"get":{"x-controller-name":"AbacController","x-operation-name":"getRolePermissions","tags":["Roles Management"],"summary":"Get Role Permissions","description":"Returns the permission ids granted to a role.","operationId":"getRolePermissions","responses":{"200":{"description":"Role with permission ids.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"permissionIds":{"type":"array","items":{"type":"number"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Role not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"roleId","in":"path","required":true,"description":"The unique numeric ID of the role","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/roles/{roleId}":{"patch":{"x-controller-name":"AbacController","x-operation-name":"updateRole","tags":["Roles Management"],"summary":"Update Role","description":"Renames or re-describes a role.","operationId":"updateRole","responses":{"204":{"description":"Role updated.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Role not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Another role with this name already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"roleId","in":"path","required":true,"description":"The unique numeric ID of the role","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":50},"description":{"type":"string"}}}}},"required":true,"x-parameter-index":1}},"delete":{"x-controller-name":"AbacController","x-operation-name":"deleteRole","tags":["Roles Management"],"summary":"Delete Role","description":"Deletes a role. Fails with 409 while the role is still assigned to users or referenced by company affinities.","operationId":"deleteRole","responses":{"204":{"description":"Role deleted.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Role not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Role is still in use.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"roleId","in":"path","required":true,"description":"The unique numeric ID of the role","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/roles":{"post":{"x-controller-name":"AbacController","x-operation-name":"createRole","tags":["Roles Management"],"summary":"Create Role","description":"Creates a new role. Role names must be unique.","operationId":"createRole","responses":{"200":{"description":"Created role.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleExcluding_id-createdAt_"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"A role with this name already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":50},"description":{"type":"string"}}}}},"required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"AbacController","x-operation-name":"listRoles","tags":["Roles Management"],"summary":"List Roles","description":"Lists every role with the ids of its granted permissions.","operationId":"listRoles","responses":{"200":{"description":"Array of roles with permission ids.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"permissionIds":{"type":"array","items":{"type":"number"}}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/users/{userId}/companies/{companyId}/role":{"put":{"x-controller-name":"AbacController","x-operation-name":"setUserCompanyRole","tags":["User Role Assignments"],"summary":"Set User Company Role","description":"Sets the company-scoped role of a user via user_company_affinity. Pass roleId: null to clear the assignment.","operationId":"setUserCompanyRole","responses":{"200":{"description":"The updated affinity record, or null when cleared.","content":{"application/json":{"schema":{"type":"object","nullable":true}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Role not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"userId","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"companyId","in":"path","required":true,"description":"The unique numeric ID of the company","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["roleId"],"properties":{"roleId":{"type":"number","nullable":true,"description":"Role id within the company, or null to clear."}}}}},"required":true,"x-parameter-index":2}},"get":{"x-controller-name":"AbacController","x-operation-name":"getUserCompanyRole","tags":["User Role Assignments"],"summary":"Get User Company Role","description":"Returns the company-scoped role of a user (user_company_affinity), or null when the user has no affinity with the company.","operationId":"getUserCompanyRole","responses":{"200":{"description":"The affinity record or null.","content":{"application/json":{"schema":{"type":"object","nullable":true}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"userId","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"companyId","in":"path","required":true,"description":"The unique numeric ID of the company","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/abac/users/{userId}/roles":{"put":{"x-controller-name":"AbacController","x-operation-name":"setUserRoles","tags":["User Role Assignments"],"summary":"Set User Roles","description":"Replaces the complete set of global roles of a user. Any role not in the payload is revoked. Audit `changedByUserId` is set to the calling admin.","operationId":"setUserRoles","responses":{"200":{"description":"The updated assignments.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"userId":{"type":"number","nullable":true},"roleId":{"type":"number","nullable":true},"changedByUserId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"One or more role ids do not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"userId","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["roleIds"],"properties":{"roleIds":{"type":"array","items":{"type":"number"},"description":"Complete set of global role ids for the user."}}}}},"required":true,"x-parameter-index":1}},"get":{"x-controller-name":"AbacController","x-operation-name":"getUserRoles","tags":["User Role Assignments"],"summary":"Get User Roles","description":"Lists a user's global role assignments.","operationId":"getUserRoles","responses":{"200":{"description":"Array of user-role assignments.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"userId":{"type":"number","nullable":true},"roleId":{"type":"number","nullable":true},"changedByUserId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"userId","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/authenticate":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"authenticate","tags":["MFA Verification & Challenges"],"summary":"Verify Two-Factor Code","description":"Validates a 2FA challenge code during login step 2 to complete authentication.","operationId":"authenticateTwoFactor","responses":{"200":{"description":"2FA authentication successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorVerifyResponsePayload"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Invalid 2FA authentication code or unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorAuthenticateRequestBody"}}},"description":"2FA authentication challenge payload.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/backup-codes/verify":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"verifyBackupCode","tags":["MFA Verification & Challenges"],"summary":"Verify Backup Code","description":"Validates and consumes a single-use emergency backup code to bypass normal 2FA challenge.","operationId":"verifyBackupCode","responses":{"200":{"description":"Backup code verified successfully and marked as used.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorVerifyResponsePayload1"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Invalid, already used, or expired backup code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyBackupCodeRequestBody"}}},"description":"Single-use backup recovery code payload.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/backup-codes":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"generateBackupCodes","tags":["MFA Management & Enrollment"],"summary":"Generate Backup Codes","description":"Generates a new set of single-use emergency backup recovery codes for account access.","operationId":"generateBackupCodes","responses":{"200":{"description":"Backup codes generated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupCodesResponsePayload"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"2FA must be active to generate backup codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/methods/{id}/verify":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"verifyMethodSetup","tags":["MFA Management & Enrollment"],"summary":"Verify Two-Factor Enrollment","description":"Verifies and activates a pending 2FA method using a verification code generated by the method device. Backup codes must be generated before a TOTP method can be activated.","operationId":"verifyMethodSetup","responses":{"200":{"description":"2FA method successfully verified and activated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorVerifyResponsePayload2"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid verification code provided, or backup codes have not been generated yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Pending 2FA method ID not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyMethodSetupRequestBody"}}},"description":"Verification code generated during setup.","required":true,"x-parameter-index":1}}},"/auth/2fa/methods/{id}":{"patch":{"x-controller-name":"TwoFactorController","x-operation-name":"updateMethod","tags":["MFA Management & Enrollment"],"summary":"Update Two-Factor Method","description":"Updates configuration settings for a specific 2FA method (e.g. setting as primary).","operationId":"updateTwoFactorMethod","responses":{"200":{"description":"2FA method settings updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorMethodItem"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"2FA method ID not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTwoFactorMethodRequestBody"}}},"description":"Update fields for the 2FA method.","required":true,"x-parameter-index":1}},"delete":{"x-controller-name":"TwoFactorController","x-operation-name":"removeMethod","tags":["MFA Management & Enrollment"],"summary":"Disable Two-Factor Method","description":"Deletes / disables a registered 2FA method from the account.","operationId":"removeTwoFactorMethod","responses":{"204":{"description":"2FA method successfully removed. No content returned.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"2FA method ID not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/methods":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"enrollMethod","tags":["MFA Management & Enrollment"],"summary":"Start Two-Factor Enrollment","description":"Initiates setup for a new 2FA method (e.g., TOTP, SMS) and returns provisioning data like a secret key or QR code URI.","operationId":"enrollTwoFactorMethod","responses":{"200":{"description":"2FA method enrollment initiated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorSetupResponsePayload"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid enrollment request payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Method type is already enrolled for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollTwoFactorRequestBody"}}},"description":"Payload specifying the 2FA method type to enroll.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"TwoFactorController","x-operation-name":"findMethods","tags":["MFA Management & Enrollment"],"summary":"List Two-Factor Methods","description":"Retrieves all configured two-factor authentication methods for the authenticated user.","operationId":"findTwoFactorMethods","responses":{"200":{"description":"List of configured two-factor authentication methods.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TwoFactorMethodItem1"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access - missing or invalid Bearer token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/2fa/verify":{"post":{"x-controller-name":"TwoFactorController","x-operation-name":"verify","tags":["MFA Verification & Challenges"],"summary":"Verify Two-Factor Code (Action Step-Up)","description":"Verifies a 2FA code for high-security actions or session elevation (e.g., sudo mode, account deletion, password change).","operationId":"verifyTwoFactor","responses":{"200":{"description":"2FA code verified successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorVerifyResponsePayload3"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid or expired 2FA verification code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyTwoFactorRequestBody"}}},"description":"2FA verification code payload for action confirmation.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/firebase":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"firebaseLogin","tags":["Federated Identity & OAuth"],"summary":"Exchange Firebase Token for Session","description":"Verifies the Firebase ID token and authenticates the corresponding internal account. A normal session is issued only when the account is active and email verification requirements are satisfied. If MFA is enabled, the response is an MFA challenge and does not contain session tokens.","operationId":"firebaseLogin","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirebaseLoginRequestBody"}}},"description":"Firebase Authentication payload and optional registration preferences.","required":true},"responses":{"200":{"description":"Authentication result: session established or an additional step is required.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/LoginComplete"},{"$ref":"#/components/schemas/AdditionalAuthenticationRequired"},{"$ref":"#/components/schemas/EmailVerificationRequired"},{"$ref":"#/components/schemas/PasswordResetRequired"}]}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid request payload.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Firebase token is invalid, expired, or could not be verified.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"The account is suspended or otherwise unable to authenticate.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/login/2fa":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"verifyLoginTwoFactor","tags":["Authentication - Login Challenges"],"summary":"Complete Two-Factor Login","description":"Completes a pending login challenge. On success, returns the same authenticated-session payload as a successful password login.","operationId":"verifyLoginTwoFactor","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CodeBasedMfaRequest"},{"$ref":"#/components/schemas/PasskeyMfaRequest"}]}}},"description":"Complete a pending two-factor login challenge.","required":true},"responses":{"200":{"description":"Second factor verified; authenticated session issued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginComplete1"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing, malformed, or unsupported challenge fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Challenge token is invalid, expired, or already used, or the second-factor proof is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Account is not permitted to log in or email verification is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too many challenge attempts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/login/challenge/passkey":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"loginChallengePasskey","tags":["Authentication - Login Challenges"],"summary":"Create passkey registration challenge","description":"Creates WebAuthn registration options for the authenticated user to register a passkey. The client submits the resulting credential to a separate verification endpoint.","operationId":"loginChallengePasskey","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Passkey registration challenge created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasskeyRegistrationOptions"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication is required or the access token is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"The account is not permitted to configure MFA.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/login/challenge/totp":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"loginChallengeTotp","tags":["Authentication - Login Challenges"],"summary":"Create TOTP setup challenge","description":"Creates a TOTP enrollment challenge for the authenticated user. The secret is sensitive and should be shown only during setup. The user must verify a code before the TOTP method is enabled.","operationId":"loginChallengeTotp","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"TOTP enrollment challenge created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpSetupChallenge"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication is required or the access token is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"The account is not permitted to configure MFA.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"A TOTP setup challenge is already pending or TOTP is enabled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/login":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"login","tags":["Authentication"],"summary":"Log in","description":"Authenticates a username or email and password. Depending on account state, the response may require email verification, 2FA, or a password reset before issuing a normal access token.","operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequestBody"}}},"description":"User login credentials.","required":true},"responses":{"200":{"description":"Credentials accepted. The response indicates whether the client can proceed or must complete another authentication step.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/LoginComplete2"},{"$ref":"#/components/schemas/AdditionalAuthenticationRequired"},{"$ref":"#/components/schemas/EmailVerificationRequired"},{"$ref":"#/components/schemas/PasswordResetRequired"}]}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request: Missing or malformed login parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Invalid credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Forbidden: Account is suspended, deleted, or otherwise not permitted to log in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too Many Requests: Login rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/logout":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"logout","tags":["Auth Session"],"summary":"Log out of the current session","description":"Revokes the refresh token for the current session. The client should also discard its access token.","operationId":"logout","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["refreshToken"],"properties":{"refreshToken":{"type":"string","description":"Refresh token for the current session."}}}}}},"responses":{"200":{"description":"Successfully logged out.","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","example":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication or refresh token is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/logout-all":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"logoutAll","tags":["Auth Session"],"summary":"Log out of all sessions","description":"Revokes all active refresh tokens for the authenticated user. The client should also discard its access token.","operationId":"logoutAll","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Successfully logged out of all sessions.","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","example":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication token is invalid or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/oauth/{provider}":{"delete":{"x-controller-name":"UserSessionController","x-operation-name":"unlinkOAuthProvider","tags":["Federated Identity & OAuth"],"summary":"Unlink OAuth Provider Account","description":"Removes a linked third-party OAuth account, provided the user retains another valid login method.","operationId":"unlinkOAuthProvider","security":[{"BearerAuth":[]}],"parameters":[{"name":"provider","in":"path","required":true,"description":"The authentication provider.","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"responses":{"204":{"description":"Successfully unlinked the OAuth provider account.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Cannot unlink the provider because no alternative login method remains.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"User is not authenticated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"No linked account was found for the specified provider.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}}}},"/auth/password/change":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"changePassword","tags":["Password Management"],"summary":"Change Password (Authenticated)","description":"Allows an authenticated user to change their password by confirming their current password. This is also the only way to clear a forced password reset. The temporary password provided by an administrator serves as the current password on first login. Passwords and password hashes are never included in responses.","operationId":"changePassword","security":[{"BearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordRequestBody"}}},"description":"Current and new password payload. Confirm-password validation is handled by the client.","required":true},"responses":{"200":{"description":"Password successfully updated.","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","example":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthenticated request or invalid current password.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Password change is not permitted for the current account state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/password/forgot":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"forgotPassword","tags":["Password Management"],"summary":"Request password reset","description":"Requests a password-reset email. The response is the same whether or not an account exists, to avoid revealing registered email addresses.","operationId":"forgotPassword","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequestBody"}}},"description":"Email address associated with the account.","required":true},"responses":{"200":{"description":"Request received.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"If an account matches that email, password-reset instructions will be sent."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing or malformed email address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too many password-reset requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/password/reset":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"resetPassword","tags":["Password Management"],"summary":"Reset password","description":"Sets a new password using a valid, single-use password-reset token. Existing sessions should be revoked according to the application’s session policy.","operationId":"resetPassword","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequestBody"}}},"description":"Password-reset token and new password.","required":true},"responses":{"200":{"description":"Password reset successfully.","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","example":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing or malformed fields, or password does not meet policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"422":{"description":"Reset token is invalid, expired, or already used.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too many password-reset attempts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/refresh-token":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"refreshToken","tags":["Auth Session"],"summary":"Refresh access token","description":"Exchanges a valid refresh token for a new access token and refresh token. The previous refresh token is revoked when rotation succeeds.","operationId":"refreshToken","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenRequestBody"}}},"description":"Refresh token payload.","required":true},"responses":{"200":{"description":"New access and refresh tokens issued successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenResponsePayload"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing or malformed refresh token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Invalid, revoked, expired, or reused refresh token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"User account is not permitted to refresh tokens.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too many refresh attempts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/register":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"register","tags":["Authentication"],"summary":"Register New User Account","description":"Registers a new user in the system using username, email, and password. Returns the created user object and triggers a verification email.","operationId":"register","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequestBody"}}},"description":"Account registration credentials and profile data.","required":true},"responses":{"201":{"description":"Registration successful. User account created and verification email dispatched.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponsePayload"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request: Validation failed for one or more fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Conflict: Username or Email address is already registered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"422":{"description":"Unprocessable Entity: Password policy violation or invalid email format.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server/database error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/verify-email":{"post":{"x-controller-name":"UserSessionController","x-operation-name":"verifyEmail","tags":["Authentication"],"summary":"Verify email address","description":"Verifies the user’s email address using the token sent in the verification email.","operationId":"verifyEmail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailRequestBody"}}},"description":"The email verification token payload.","required":true},"responses":{"200":{"description":"Email successfully verified.","content":{"application/json":{"schema":{"type":"object","required":["success","emailVerified"],"properties":{"success":{"type":"boolean","example":true},"emailVerified":{"type":"boolean","example":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing or malformed verification token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"422":{"description":"Verification token is invalid, expired, or already used.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/webauthn/credentials/{id}":{"patch":{"x-controller-name":"WebauthnController","x-operation-name":"updateCredential","tags":["WebAuthn & Passkeys"],"summary":"Rename Passkey","responses":{},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique string identifier of the WebAuthn credential","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebauthnUpdateCredentialRequestBody"}}},"description":"The updated passkey fields payload.","required":true,"x-parameter-index":1},"operationId":"WebauthnController.updateCredential"},"delete":{"x-controller-name":"WebauthnController","x-operation-name":"revokeCredential","tags":["WebAuthn & Passkeys"],"summary":"Revoke Passkey","responses":{},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique string identifier of the WebAuthn credential","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"WebauthnController.revokeCredential"}},"/auth/webauthn/credentials":{"get":{"x-controller-name":"WebauthnController","x-operation-name":"findCredentials","tags":["WebAuthn & Passkeys"],"summary":"List Passkeys","responses":{},"operationId":"WebauthnController.findCredentials","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/webauthn/login/options":{"post":{"x-controller-name":"WebauthnController","x-operation-name":"generateLoginOptions","tags":["WebAuthn & Passkeys"],"summary":"Generate Passkey Login Options","responses":{},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebauthnLoginOptionsRequestBody"}}},"description":"Optional hints used to scope passkey login options to a discoverable account.","required":false},"operationId":"WebauthnController.generateLoginOptions","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/webauthn/login":{"post":{"x-controller-name":"WebauthnController","x-operation-name":"verifyLogin","tags":["WebAuthn & Passkeys"],"summary":"Verify Passkey Login","responses":{},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebauthnLoginVerifyRequestBody"}}},"description":"Authenticator assertion payload returned by the client during passkey login.","required":true},"operationId":"WebauthnController.verifyLogin","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/webauthn/register/options":{"post":{"x-controller-name":"WebauthnController","x-operation-name":"generateRegisterOptions","tags":["WebAuthn & Passkeys"],"summary":"Generate Passkey Registration Options","responses":{},"operationId":"WebauthnController.generateRegisterOptions","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/auth/webauthn/register":{"post":{"x-controller-name":"WebauthnController","x-operation-name":"verifyRegistration","tags":["WebAuthn & Passkeys"],"summary":"Verify Passkey Registration","responses":{},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebauthnRegisterVerifyRequestBody"}}},"description":"Authenticator attestation payload returned by the client during passkey registration.","required":true},"operationId":"WebauthnController.verifyRegistration","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/csv-seed/seed":{"post":{"x-controller-name":"CsvSeedController","x-operation-name":"seedFromCsv","tags":["CSV Seeding"],"summary":"Seed database from CSV file","description":"Uploads a CSV file and seeds the database with event records. The CSV file should have headers starting at line 3. Expected columns: číslo PU, Pojišťovna, Druh pojistky, Typ události / Druh události, Datum PU, Vzniklé poškození, RZ, Pojištěno přes Clever, Kontrola spisu a další řešení, Poznámky, Stav, Cleversolute, pojišťovny, klienta","operationId":"seedFromCsv","responses":{"200":{"description":"CSV seeding completed","content":{"application/json":{"schema":{"type":"object","properties":{"totalRecords":{"type":"number"},"successfulSeeds":{"type":"number"},"failedSeeds":{"type":"number"},"failedEvents":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid file or CSV format","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"multipart/form-data":{"x-parser":"stream","schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}},"description":"Request body for multipart/form-data based file upload","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/event-types/{id}":{"get":{"x-controller-name":"EventTypeController","x-operation-name":"findById","tags":["Event Types"],"summary":"Get event type by ID","description":"Retrieves details of a specific event type by its unique ID.","responses":{"200":{"description":"Event type instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventType"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found: Event type does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventType.Filter"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"EventTypeController.findById"}},"/event-types":{"get":{"x-controller-name":"EventTypeController","x-operation-name":"find","tags":["Event Types"],"summary":"List all event types","description":"Retrieves a list of event types, supporting optional filter queries.","responses":{"200":{"description":"Array of event type instances","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EventType"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventType.Filter1"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"EventTypeController.find"}},"/events/count":{"get":{"x-controller-name":"EventController","x-operation-name":"count","tags":["Event Management"],"summary":"Count Events","description":"Returns the total count of non-deleted event records matching optional filters.","operationId":"countEvents","responses":{"200":{"description":"Event model count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/loopback.Count"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"where","in":"query","content":{"application/json":{"schema":{"type":"object","title":"Event.WhereFilter","additionalProperties":true,"x-typescript-type":"@loopback/repository#Where<Event>"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/events/permissions":{"get":{"x-controller-name":"SseController","x-operation-name":"subscribePermissionUpdates","tags":["Real-time Events"],"summary":"Subscribe to Permission Updates via SSE","operationId":"subscribePermissionUpdates","responses":{"200":{"description":"SSE stream established.","content":{"text/event-stream":{"schema":{"type":"string"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/events/{identifier}":{"put":{"x-controller-name":"EventController","x-operation-name":"replaceById","tags":["Event Management"],"summary":"Replace Event by ID","description":"Replaces an entire event record by ID.","operationId":"replaceEventById","responses":{"204":{"description":"Event PUT success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing required event fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Event not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"identifier","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_"}}},"description":"Full event payload for replacement.","required":true,"x-parameter-index":1}},"patch":{"x-controller-name":"EventController","x-operation-name":"updateById","tags":["Event Management"],"summary":"Update Event by ID","description":"Partially updates specific fields on an existing event record.","operationId":"updateEventById","responses":{"204":{"description":"Event PATCH success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Event not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"identifier","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventPartialExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_"}}},"description":"Partial event fields to update.","required":true,"x-parameter-index":1}},"get":{"x-controller-name":"EventController","x-operation-name":"findByIdOrUuid","tags":["Event Management"],"summary":"Find Event by ID or UUID","description":"Retrieves details for a specific event by unique identifier.","operationId":"findEventByIdOrUuid","responses":{"200":{"description":"Event model instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Event not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"identifier","in":"path","schema":{"type":"string"},"required":true},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event.Filter"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"EventController","x-operation-name":"deleteById","tags":["Event Management"],"summary":"Delete Event by ID","description":"Soft-deletes an event record by unique identifier.","operationId":"deleteEventById","responses":{"204":{"description":"Event DELETE success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Event not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"identifier","in":"path","schema":{"type":"string"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/events":{"post":{"x-controller-name":"EventController","x-operation-name":"create","tags":["Event Management"],"summary":"Create a new event","description":"Registers a new event in the system. Requires the manage_events permission. A unique event number is generated automatically when one is not supplied.","operationId":"createEvent","responses":{"200":{"description":"Event model instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventExcluding_id-eventUuid-eventStatus-eventPriority-insuredViaUs-fileCheckAndOtherSolutions-closedAt-insuranceCompanyId-typeOfPolicyId-reportedByUserId-assignedToUserId-createdAt-updatedAt-updatedByUserId-deletedAt-deletedByUserId-isDeleted_"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Missing required event fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"eventNumber":{"type":"string","nullable":true},"description":{"type":"string","nullable":false},"eventDate":{"type":"string","format":"date-time","nullable":false},"eventTypeId":{"type":"number","nullable":false},"cause":{"type":"string","nullable":true},"additionalDetails":{"type":"string","nullable":true},"registrationBrand":{"type":"string","nullable":true},"insuredViaUs":{"type":"boolean","nullable":true},"fileCheckAndOtherSolutions":{"type":"string","nullable":true},"locationId":{"type":"number","nullable":true},"insuranceCompanyId":{"type":"number","nullable":true},"typeOfPolicyId":{"type":"number","nullable":true},"reportedByUserId":{"type":"number","nullable":true},"emails":{"type":"array","items":{"type":"string","format":"email"},"description":"Optional list of email addresses to notify regarding this event.","example":["user1@example.com","user2@example.com"]}}}}},"description":"Payload for creating a new event, including optional notification emails.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"patch":{"x-controller-name":"EventController","x-operation-name":"updateAll","tags":["Event Management"],"summary":"Bulk Update Events","description":"Updates multiple event records matching an optional where condition.","operationId":"updateAllEvents","responses":{"200":{"description":"Event PATCH success count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/loopback.Count"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"where","in":"query","content":{"application/json":{"schema":{"type":"object","title":"Event.WhereFilter","additionalProperties":true,"x-typescript-type":"@loopback/repository#Where<Event>"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventPartialExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_"}}},"description":"Partial event fields to update across target records.","required":true}},"get":{"x-controller-name":"EventController","x-operation-name":"find","tags":["Event Management"],"summary":"List Events","description":"Retrieves a list of non-deleted events matching optional filter criteria. Callers without broad event access only receive the events they reported themselves.","operationId":"findEvents","responses":{"200":{"description":"Array of role-scoped event summaries.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"eventUuid":{"type":"string","example":"9f2c7c1e-5b3a-4f7d-8c1b-2a6e5d4f3b21"},"eventNumber":{"type":"string","example":"EVT-M1XQZ0-4K7D2A"},"eventStatus":{"type":"string","example":"open"},"createdAt":{"type":"string","format":"date-time"},"category":{"type":"string","nullable":true,"example":"Vehicle damage"},"firstImageUrl":{"type":"string","nullable":true},"eventPriority":{"type":"string","nullable":true,"example":"medium"},"reportedByName":{"type":"string","nullable":true,"example":"john.doe"},"assignedToName":{"type":"string","nullable":true,"example":"jane.roe"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event.Filter1"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/bulk/{bulkId}/status":{"get":{"x-controller-name":"FileUploadController","x-operation-name":"getBulkStatus","tags":["File Management"],"summary":"Get Bulk Upload Status","description":"Retrieves the status and results of a previously initiated bulk upload by its identifier.","operationId":"getBulkStatus","responses":{"200":{"description":"Bulk upload result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUploadResult"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"bulkId","in":"path","required":true,"description":"The unique string identifier of the bulk upload task","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/bulk-upload":{"post":{"x-controller-name":"FileUploadController","x-operation-name":"bulkUpload","tags":["File Management"],"summary":"Bulk Upload Files","description":"Uploads multiple files in a single request via multipart form data.","operationId":"bulkUpload","responses":{"202":{"description":"Bulk upload result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUploadResult"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"No files uploaded.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/presign":{"post":{"x-controller-name":"FileUploadController","x-operation-name":"presignUpload","tags":["File Management"],"summary":"Create Presigned Upload URL","description":"Creates a presigned URL for direct-to-storage file uploads, optionally associating the upload with an authenticated user.","operationId":"presignUpload","responses":{"201":{"description":"Presigned upload URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignedUploadResult"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid presign request payload.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignedUploadRequest"}}},"description":"Presigned upload request parameters.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/profile-picture":{"post":{"x-controller-name":"FileUploadController","x-operation-name":"uploadProfilePicture","tags":["File Management"],"summary":"Upload Profile Picture","description":"Uploads a new profile picture for the authenticated user.","operationId":"uploadProfilePicture","responses":{"200":{"description":"Profile picture uploaded successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilePictureResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"No file uploaded or invalid file type/size.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"413":{"description":"File too large (max 5 MB).","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"FileUploadController","x-operation-name":"getProfilePicture","tags":["File Management"],"summary":"Get Profile Picture","description":"Retrieves the profile picture metadata for the authenticated user.","operationId":"getProfilePicture","responses":{"200":{"description":"Profile picture metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilePictureResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"FileUploadController","x-operation-name":"removeProfilePicture","tags":["File Management"],"summary":"Remove Profile Picture","description":"Removes the profile picture for the authenticated user.","operationId":"removeProfilePicture","responses":{"204":{"description":"Profile picture removed.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"No profile picture found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/upload":{"post":{"x-controller-name":"FileUploadController","x-operation-name":"uploadFile","tags":["File Management"],"summary":"Upload File (Direct)","description":"Uploads a single file directly via multipart form data.","operationId":"uploadFile","responses":{"200":{"description":"File metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileMetadata"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"No file uploaded or invalid request.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/{uploadId}/complete":{"post":{"x-controller-name":"FileUploadController","x-operation-name":"completeUpload","tags":["File Management"],"summary":"Complete Presigned Upload","description":"Completes a presigned upload session and creates the file record.","operationId":"completeUpload","responses":{"201":{"description":"Upload completed","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Upload session not found or expired.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"422":{"description":"Upload verification failed.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"uploadId","in":"path","required":true,"description":"The unique string identifier of the presigned upload session","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/{id}/url":{"get":{"x-controller-name":"FileUploadController","x-operation-name":"getFileUrl","tags":["File Management"],"summary":"Get File URL","description":"Returns a direct URL for accessing a file by its identifier.","operationId":"getFileUrl","responses":{"200":{"description":"File URL","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"File not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique string identifier of the file","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/files/{id}":{"get":{"x-controller-name":"FileUploadController","x-operation-name":"downloadFile","tags":["File Management"],"summary":"Download File","description":"Downloads a file by its identifier as binary content.","operationId":"downloadFile","responses":{"200":{"description":"File binary content","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"File not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique string identifier of the file","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"FileUploadController","x-operation-name":"deleteFile","tags":["File Management"],"summary":"Delete File","description":"Deletes a file by its identifier.","operationId":"deleteFile","responses":{"204":{"description":"File deleted successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"File not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique string identifier of the file","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/insurance-companies/{id}":{"get":{"x-controller-name":"InsuranceCompanyController","x-operation-name":"findById","tags":["Insurance Companies"],"summary":"Get insurance company by ID","description":"Retrieves details of a specific insurance company by its unique ID.","responses":{"200":{"description":"Insurance company instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsuranceCompany"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found: Insurance company does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsuranceCompany.Filter"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"InsuranceCompanyController.findById"}},"/insurance-companies":{"get":{"x-controller-name":"InsuranceCompanyController","x-operation-name":"find","tags":["Insurance Companies"],"summary":"List all insurance companies","description":"Retrieves a list of insurance companies, supporting optional filter queries.","responses":{"200":{"description":"Array of insurance company instances","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InsuranceCompany"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsuranceCompany.Filter1"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"InsuranceCompanyController.find"}},"/locations/{id}":{"patch":{"x-controller-name":"LocationController","x-operation-name":"updateLocation","tags":["Locations"],"summary":"Update an existing location","description":"Partially or fully updates a location by its ID using PATCH.","responses":{"200":{"description":"Location updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Location"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"number"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Fields to update on the location","required":true,"x-parameter-index":1},"operationId":"LocationController.updateLocation"},"get":{"x-controller-name":"LocationController","x-operation-name":"findLocationById","tags":["Locations"],"summary":"Get location by ID","description":"Retrieves details of a specific location by its unique ID.","responses":{"200":{"description":"Location instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Location"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"number"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"LocationController.findLocationById"},"delete":{"x-controller-name":"LocationController","x-operation-name":"deleteLocation","tags":["Locations"],"summary":"Delete a location","description":"Removes a location record from the system by ID.","responses":{"204":{"description":"Location deleted successfully (No Content).","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","schema":{"type":"number"},"required":true},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"LocationController.deleteLocation"}},"/locations":{"post":{"x-controller-name":"LocationController","x-operation-name":"createLocation","tags":["Locations"],"summary":"Create a new location","description":"Creates a physical location record in the system.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["streetAddress","city","country"],"properties":{"streetAddress":{"type":"string","example":"123 Innovation Drive"},"city":{"type":"string","example":"Brno"},"country":{"type":"string","example":"Czechia"},"region":{"type":"string","example":"South Moravian Region"},"postalCode":{"type":"string","example":"602 00"},"latitude":{"type":"number","example":49.1951},"longitude":{"type":"number","example":16.6068},"locationName":{"type":"string","example":"Central Hub"},"description":{"type":"string","example":"Headquarters."}}}}},"description":"Data payload required to create a new location.","required":true},"responses":{"201":{"description":"Location created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Location"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"operationId":"LocationController.createLocation","parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"LocationController","x-operation-name":"findLocations","tags":["Locations"],"summary":"List all locations","description":"Retrieves a list of locations, supporting optional filter queries.","responses":{"200":{"description":"Array of location instances","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Location"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"ValidationError"},"message":{"type":"string","example":"Validation failed."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"filter","in":"query","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"LocationController.findLocations"}},"/maintenance/failed-jobs":{"get":{"x-controller-name":"MaintenanceController","x-operation-name":"getFailedJobs","tags":["Maintenance"],"summary":"List Failed Maintenance Jobs","description":"Array of background jobs that ended in FAILED status.","operationId":"getFailedJobs","responses":{"200":{"description":"Array of failed background jobs.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"durationMs":{"type":"number"},"error":{"type":"string"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/maintenance/jobs/{name}/trigger":{"post":{"x-controller-name":"MaintenanceController","x-operation-name":"triggerJob","tags":["Maintenance"],"summary":"Trigger Maintenance Job","description":"Manually triggers a specific maintenance job asynchronously in the background.","operationId":"triggerJob","responses":{"200":{"description":"Job successfully queued for background execution.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"jobName":{"type":"string"},"status":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Job handler not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Job is already actively running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"name","in":"path","required":true,"description":"The name of the maintenance job to trigger","schema":{"type":"string","enum":["SESSION_AUTO_DELETE","DEVICE_AUTO_DELETE","HARD_DELETE","ORPHANED_STORAGE_RECONCILIATION","REDIS_HYGIENE_REPORT","POSTGRES_HEALTH_BLOAT_REPORT","AUTH_CREDENTIAL_RETENTION","NOTIFICATION_RETENTION","ANNUAL_PASSWORD_RESET"]}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/maintenance/jobs":{"get":{"x-controller-name":"MaintenanceController","x-operation-name":"getJobQueue","tags":["Maintenance"],"summary":"List Maintenance Jobs","description":"Returns all recorded job executions and their current statuses.","operationId":"getJobQueue","responses":{"200":{"description":"Array of job executions.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"durationMs":{"type":"number","nullable":true},"error":{"type":"string","nullable":true}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/activity-log":{"get":{"x-controller-name":"MeController","x-operation-name":"getActivityLog","tags":["User Security & Activity"],"summary":"Get Activity Log","description":"Retrieves recent security or account activity logs.","operationId":"getActivityLog","responses":{"200":{"description":"Activity log entries","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/companies":{"get":{"x-controller-name":"MeController","x-operation-name":"getCompanies","tags":["User Companies & Affinities"],"summary":"List User Company Affinities","description":"Retrieves companies and associated roles connected to the user.","operationId":"getCompanies","responses":{"200":{"description":"List of company affinities with roles","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/consent":{"patch":{"x-controller-name":"MeController","x-operation-name":"updateConsent","tags":["User Consent & Privacy"],"summary":"Update User Consent Status","description":"Updates marketing opt-in/out choices and logs timestamps.","operationId":"updateConsent","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"description":"Consent flags to update","required":true},"responses":{"204":{"description":"Consent updated successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"MeController","x-operation-name":"getConsent","tags":["User Consent & Privacy"],"summary":"Get User Consent Status","description":"Retrieves marketing opt-in/out consents with timestamps.","operationId":"getConsent","responses":{"200":{"description":"Consent records retrieved successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/devices/{deviceId}":{"get":{"x-controller-name":"DeviceController","x-operation-name":"findById","tags":["Device Management"],"summary":"Get Single Device","description":"Returns a single device summary for the authenticated user.","operationId":"findDeviceById","responses":{"200":{"description":"A single device summary.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number","example":1},"userId":{"type":"number","example":1,"nullable":true},"deviceName":{"type":"string","example":"John iPhone"},"lastUsedAt":{"type":"string","format":"date-time"},"isTrusted":{"type":"boolean","example":true},"biometricEnabled":{"type":"boolean","example":false},"deviceOs":{"type":"string","nullable":true},"deviceVersion":{"type":"string","nullable":true},"lastKnownIp":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"isCurrent":{"type":"boolean","example":false}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Device belongs to another user.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Device not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"deviceId","in":"path","required":true,"description":"The unique numeric ID of the device","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"DeviceController","x-operation-name":"deleteDevice","tags":["Device Management"],"summary":"Remove Device","description":"Removes a device registration for the authenticated user. Use POST /auth/logout to revoke the current device.","operationId":"deleteDevice","responses":{"204":{"description":"Device registration removed.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Cannot remove the current device via this route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Device belongs to another user.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Device not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"deviceId","in":"path","required":true,"description":"The unique numeric ID of the device","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/devices":{"get":{"x-controller-name":"DeviceController","x-operation-name":"findDevices","tags":["Device Management"],"summary":"List Current User Devices","description":"Lists every device currently registered to the authenticated user.","operationId":"findDevices","responses":{"200":{"description":"Array of the current user device summaries.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":1},"userId":{"type":"number","example":1,"nullable":true},"deviceName":{"type":"string","example":"John iPhone"},"lastUsedAt":{"type":"string","format":"date-time"},"isTrusted":{"type":"boolean","example":true},"biometricEnabled":{"type":"boolean","example":false},"deviceOs":{"type":"string","nullable":true},"deviceVersion":{"type":"string","nullable":true},"lastKnownIp":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"isCurrent":{"type":"boolean","example":false}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/files":{"get":{"x-controller-name":"MeController","x-operation-name":"getFiles","tags":["User Files"],"summary":"List User Files via Access Permissions","description":"Retrieves files accessible by the current user.","operationId":"getFiles","responses":{"200":{"description":"List of accessible files","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/login-history":{"get":{"x-controller-name":"MeController","x-operation-name":"getLoginHistory","tags":["User Security & Activity"],"summary":"Get Login History","description":"Retrieves login timestamps, IP addresses, and user-agent history.","operationId":"getLoginHistory","responses":{"200":{"description":"Login history list","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/notification-preferences":{"patch":{"x-controller-name":"MeController","x-operation-name":"updateNotificationPreferences","tags":["User Preferences & Settings"],"summary":"Update Notification Preferences","description":"Updates notification channel preferences for the current user.","operationId":"updateNotificationPreferences","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"description":"Notification preferences update payload","required":true},"responses":{"204":{"description":"Notification preferences updated successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"MeController","x-operation-name":"getNotificationPreferences","tags":["User Preferences & Settings"],"summary":"Get Current User Notification Preferences","description":"Retrieves user notification channels and frequency settings.","operationId":"getNotificationPreferences","responses":{"200":{"description":"Notification preferences retrieved successfully","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/profile":{"patch":{"x-controller-name":"MeController","x-operation-name":"updateProfile","tags":["Profile"],"summary":"Update Current User Profile Metadata","description":"Updates personal profile attributes (e.g., first/last name, bio, avatar URL) without altering core identity/credentials.","operationId":"updateMeProfile","responses":{"204":{"description":"Profile metadata updated successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"avatarUrl":{"type":"string"},"bio":{"type":"string"}}}}},"description":"Non-authentication user profile metadata to update","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/sessions/{sessionId}":{"get":{"x-controller-name":"SessionController","x-operation-name":"findById","tags":["Session Management"],"summary":"Get Single Session","description":"Returns a single session summary for the authenticated user.","operationId":"findSessionById","responses":{"200":{"description":"A single session summary.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number","example":1},"userId":{"type":"number","example":1,"nullable":true},"deviceId":{"type":"number","example":1,"nullable":true},"loginAt":{"type":"string","format":"date-time","nullable":true},"lastActive":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"isActive":{"type":"boolean","example":true},"userAgent":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"latitude":{"type":"number","nullable":true},"longitude":{"type":"number","nullable":true},"cookieConsent":{"type":"boolean","example":false},"systemVersion":{"type":"string","nullable":true},"isCurrent":{"type":"boolean","example":false}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Session belongs to another user.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"description":"ID of the session","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"SessionController","x-operation-name":"deleteSession","tags":["Session Management"],"summary":"Terminate Session","description":"Terminates (soft-deletes) a non-current session of the authenticated user.","operationId":"deleteSession","responses":{"204":{"description":"Session terminated.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Cannot terminate the current or already-inactive session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Session belongs to another user.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Session not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"sessionId","in":"path","required":true,"description":"ID of the session","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/sessions":{"get":{"x-controller-name":"SessionController","x-operation-name":"findSessions","tags":["Session Management"],"summary":"List Current User Sessions","description":"Lists all active, non-expired sessions for the authenticated user.","operationId":"findSessions","responses":{"200":{"description":"Array of the current user session summaries.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":1},"userId":{"type":"number","example":1,"nullable":true},"deviceId":{"type":"number","example":1,"nullable":true},"loginAt":{"type":"string","format":"date-time","nullable":true},"lastActive":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"isActive":{"type":"boolean","example":true},"userAgent":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"region":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"latitude":{"type":"number","nullable":true},"longitude":{"type":"number","nullable":true},"cookieConsent":{"type":"boolean","example":false},"systemVersion":{"type":"string","nullable":true},"isCurrent":{"type":"boolean","example":false}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me/settings":{"patch":{"x-controller-name":"MeController","x-operation-name":"updateSettings","tags":["User Preferences & Settings"],"summary":"Update Current User Settings","description":"Updates current user settings configuration.","operationId":"updateSettings","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"languageId":{"type":"number"},"themeMode":{"type":"string"},"timezone":{"type":"string"}}}}},"description":"Settings fields to update","required":true},"responses":{"204":{"description":"Settings updated successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Validation error","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"MeController","x-operation-name":"getSettings","tags":["User Preferences & Settings"],"summary":"Get Current User Settings","description":"Retrieves user-specific preferences and settings.","operationId":"getSettings","responses":{"200":{"description":"User settings retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"languageId":{"type":"number","nullable":true},"themeMode":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/me":{"patch":{"x-controller-name":"MeController","x-operation-name":"updateMe","tags":["Profile"],"summary":"Update Current User Account Identity","description":"Updates primary account credentials/identity (e.g., username, email, phone). Updating email triggers a re-verification flow.","operationId":"updateMe","responses":{"204":{"description":"Account details updated successfully","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Validation error","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"409":{"description":"Conflict - Email address is already in use","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":3},"email":{"type":"string","format":"email"},"phone":{"type":"string"}}}}},"description":"Identity fields to update for current user","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"MeController","x-operation-name":"getMe","tags":["Profile"],"summary":"Get Current User Profile & ABAC Permissions","description":"Retrieves account details, profile metadata, and resolved ABAC authorization scopes/roles/policies for the currently authenticated user to drive frontend UI visibility.","operationId":"getMe","responses":{"200":{"description":"Authenticated user profile and authorization payload","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"username":{"type":"string","nullable":true},"email":{"type":"string"},"phone":{"type":"string","nullable":true},"accountStatus":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"userProfile":{"type":"object","nullable":true,"properties":{"id":{"type":"number"},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"avatarUrl":{"type":"string","nullable":true},"bio":{"type":"string","nullable":true}}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized - Invalid or missing token","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Account not found or marked as deleted","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"delete":{"x-controller-name":"MeController","x-operation-name":"deleteMe","tags":["Profile"],"summary":"Soft-delete Current User Account","description":"Soft-deletes the currently authenticated user account by setting account status to \"deleted\", requiring password confirmation.","operationId":"deleteMe","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["passwordConfirmation"],"properties":{"passwordConfirmation":{"type":"string","minLength":1}}}}},"description":"Password confirmation required for self soft-deletion","required":true},"responses":{"204":{"description":"Account successfully soft-deleted","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Missing or invalid password confirmation","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized - Invalid password or token","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/metrics":{"get":{"x-controller-name":"MetricsController","x-operation-name":"getMetrics","tags":["Monitoring"],"summary":"Prometheus Metrics","description":"Exposes application performance and system metrics for Prometheus scraping.","operationId":"getMetrics","responses":{"200":{"description":"Prometheus metric exposition text format.","content":{"text/plain; version=0.0.4; charset=utf-8":{"schema":{"type":"string"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/oidc/authorize":{"get":{"x-controller-name":"OidcController","x-operation-name":"authorize","tags":["OIDC"],"summary":"OIDC Authorization Endpoint","description":"Handles OAuth 2.0 / OpenID Connect authorization requests and redirects the user agent. Supports PKCE (code_challenge / code_challenge_method), as required by Cloudflare Access.","operationId":"authorize","parameters":[{"name":"client_id","in":"query","required":false,"description":"The OAuth2 / OIDC client identifier","schema":{"type":"string"}},{"name":"redirect_uri","in":"query","required":false,"description":"The URI to redirect to after authorization","schema":{"type":"string"}},{"name":"response_type","in":"query","required":false,"description":"The OAuth2 response type (e.g., code)","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"The OIDC scopes requested (e.g., openid profile email)","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Opaque value to maintain state between the request and callback","schema":{"type":"string"}},{"name":"nonce","in":"query","required":false,"description":"String value used to associate a Client session with an ID Token","schema":{"type":"string"}},{"name":"code_challenge","in":"query","required":false,"description":"PKCE code challenge derived from the code verifier","schema":{"type":"string"}},{"name":"code_challenge_method","in":"query","required":false,"description":"PKCE code challenge method (e.g., S256)","schema":{"type":"string"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"responses":{"302":{"description":"Redirect to primary authentication page or client redirection URI.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Missing or invalid parameters.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Forbidden - Insufficient permissions.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}}}},"/oidc/introspect":{"post":{"x-controller-name":"OidcController","x-operation-name":"introspect","tags":["OIDC"],"summary":"OIDC Token Introspection Endpoint","description":"Returns metadata and active status about a provided token per RFC 7662.","operationId":"introspect","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"},"token_type_hint":{"type":"string"}}}},"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"},"token_type_hint":{"type":"string"}}}}},"description":"Token to introspect.","required":true},"responses":{"200":{"description":"Status indicating token validity and token parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"sub":{"type":"string"},"aud":{"type":"string"},"iss":{"type":"string"},"exp":{"type":"number"},"iat":{"type":"number"},"scope":{"type":"string"},"client_id":{"type":"string"},"username":{"type":"string"},"email":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Token parameter is missing.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/oidc/revoke":{"post":{"x-controller-name":"OidcController","x-operation-name":"revoke","tags":["OIDC"],"summary":"OIDC Token Revocation Endpoint","description":"Revokes an issued access or refresh token per RFC 7009.","operationId":"revoke","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"},"token_type_hint":{"type":"string"}}}},"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"},"token_type_hint":{"type":"string"}}}}},"description":"Token to be revoked.","required":true},"responses":{"200":{"description":"Token successfully revoked.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Token parameter is missing.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/oidc/session/end":{"get":{"x-controller-name":"OidcController","x-operation-name":"endSession","tags":["OIDC"],"summary":"RP-Initiated Logout Endpoint","description":"Ends active OIDC session and performs RP-initiated logout.","operationId":"endSession","parameters":[{"name":"id_token_hint","in":"query","schema":{"type":"string"},"required":false,"description":"ID Token previously issued by the Authorization Server"},{"name":"post_logout_redirect_uri","in":"query","schema":{"type":"string"},"required":false,"description":"URI to redirect to after logout"},{"name":"state","in":"query","schema":{"type":"string"},"required":false,"description":"Opaque value to maintain state across redirection"},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"responses":{"302":{"description":"Redirect after end session.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}}}},"/oidc/token":{"post":{"x-controller-name":"OidcController","x-operation-name":"token","tags":["OIDC"],"summary":"OIDC Token Endpoint","description":"Exchanges an authorization code or refresh token for access, ID, and refresh tokens. Accepts client credentials either in the request body or via HTTP Basic auth in the Authorization header (as sent by paperless-ngx), and supports a PKCE code_verifier (as required by Cloudflare Access).","operationId":"token","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["grant_type"],"properties":{"grant_type":{"type":"string","enum":["authorization_code","refresh_token"]},"code":{"type":"string","description":"Required for authorization_code grant"},"redirect_uri":{"type":"string","description":"Required for authorization_code grant"},"refresh_token":{"type":"string","description":"Required for refresh_token grant"},"client_id":{"type":"string","description":"May instead be supplied via HTTP Basic auth in the Authorization header"},"client_secret":{"type":"string","description":"May instead be supplied via HTTP Basic auth in the Authorization header"},"code_verifier":{"type":"string","description":"PKCE code verifier, required if code_challenge was used on /oidc/authorize"}}}}},"description":"Parameters required for token exchange.","required":true},"responses":{"200":{"description":"Token response carrying access_token and id_token.","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string","example":"Bearer"},"expires_in":{"type":"number","example":3600},"id_token":{"type":"string"},"refresh_token":{"type":"string"},"scope":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Bad Request - Unsupported grant_type, invalid parameters, or invalid code_verifier.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized - Invalid client credentials.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/oidc/userinfo":{"get":{"x-controller-name":"OidcController","x-operation-name":"userinfo","tags":["OIDC"],"summary":"OpenID Connect UserInfo Endpoint","description":"Returns claims about the authenticated end-user using a Bearer token.","operationId":"userinfo","responses":{"200":{"description":"Claims describing authenticated identity.","content":{"application/json":{"schema":{"type":"object","properties":{"sub":{"type":"string"},"aud":{"type":"string"},"iss":{"type":"string"},"exp":{"type":"number"},"iat":{"type":"number"},"email":{"type":"string"},"email_verified":{"type":"boolean"},"name":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized - Invalid or missing bearer token.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/ping":{"get":{"x-controller-name":"PingController","x-operation-name":"ping","tags":["Health Check"],"summary":"Service Health Status","description":"Returns minimal health status for internal container monitoring.","operationId":"pingCheck","responses":{"200":{"description":"Ping Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/preferences/consents/marketing":{"post":{"x-controller-name":"UserPreferencesController","x-operation-name":"updateMarketingConsent","tags":["User Preferences"],"summary":"Update Marketing Consent","description":"Gives or withdraws marketing consent for the authenticated user.","operationId":"updateMarketingConsent","responses":{"200":{"description":"Updated consent information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserConsentResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Invalid action.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Consents not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketingConsentRequest"}}},"description":"Consent action to perform.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/preferences/consents":{"get":{"x-controller-name":"UserPreferencesController","x-operation-name":"getUserConsents","tags":["User Preferences"],"summary":"Get User Consents","description":"Returns the consent status for the authenticated user.","operationId":"getUserConsents","responses":{"200":{"description":"User consent information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserConsentResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Consents not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/preferences/notifications":{"patch":{"x-controller-name":"UserPreferencesController","x-operation-name":"updateNotificationPreferences","tags":["User Preferences"],"summary":"Update Notification Preferences","description":"Updates the notification preferences for the authenticated user. Only provided fields are updated.","operationId":"updateNotificationPreferences","responses":{"200":{"description":"Updated notification preferences","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferencesResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatableNotificationPreferences"}}},"description":"Notification preference fields to update.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"UserPreferencesController","x-operation-name":"getNotificationPreferences","tags":["User Preferences"],"summary":"Get Notification Preferences","description":"Returns the notification preferences for the authenticated user.","operationId":"getNotificationPreferences","responses":{"200":{"description":"Notification preferences","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPreferencesResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Notification preferences not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/preferences/settings":{"patch":{"x-controller-name":"UserPreferencesController","x-operation-name":"updateUserSettings","tags":["User Preferences"],"summary":"Update User Settings","description":"Updates the settings for the authenticated user. Only provided fields are updated.","operationId":"updateUserSettings","responses":{"200":{"description":"Updated user settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSettingsResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatableSettings"}}},"description":"Settings fields to update.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"UserPreferencesController","x-operation-name":"getUserSettings","tags":["User Preferences"],"summary":"Get User Settings","description":"Returns the settings for the authenticated user (theme, language, timezone).","operationId":"getUserSettings","responses":{"200":{"description":"User settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSettingsResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Settings not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/profile":{"put":{"x-controller-name":"UserProfileController","x-operation-name":"replaceUserProfile","tags":["User Profile"],"summary":"Replace User Profile","description":"Replaces the entire profile for the authenticated user. Creates a new profile if one does not exist.","operationId":"replaceUserProfile","responses":{"200":{"description":"Updated user profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceUserProfile"}}},"description":"Full profile payload for replacement.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"patch":{"x-controller-name":"UserProfileController","x-operation-name":"updateUserProfile","tags":["User Profile"],"summary":"Update User Profile","description":"Partially updates the profile for the authenticated user. Only provided fields are updated.","operationId":"updateUserProfile","responses":{"200":{"description":"Updated user profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Profile not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchUserProfile"}}},"description":"Partial profile fields to update.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"get":{"x-controller-name":"UserProfileController","x-operation-name":"getCurrentUserProfile","tags":["User Profile"],"summary":"Get Current User Profile","description":"Returns the profile information for the authenticated user.","operationId":"getCurrentUserProfile","responses":{"200":{"description":"User profile information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserProfileResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Authentication required.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Profile not found.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/security/activity-log":{"get":{"x-controller-name":"ActivityLogController","x-operation-name":"findActivityLog","tags":["Security & Audit"],"summary":"List Activity Log","description":"Lists the authenticated user's account activity events (newest first), excluding deleted entries.","operationId":"findActivityLog","responses":{"200":{"description":"Array of activity log summaries.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"sessionId":{"type":"number","nullable":true},"eventType":{"type":"string"},"eventDescription":{"type":"string","nullable":true},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum entries to return.","schema":{"type":"number","default":50}},{"name":"offset","in":"query","required":false,"description":"Entries to skip.","schema":{"type":"number","default":0}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/security/csrf-token":{"get":{"x-controller-name":"CsrfController","x-operation-name":"getCsrfToken","tags":["Security & Audit"],"summary":"Generate CSRF Token","description":"Generates and returns a fresh CSRF Token while applying strict anti-caching headers (`Cache-Control: no-store`) to the response.","operationId":"getCsrfToken","responses":{"200":{"description":"Fresh CSRF token generated successfully.","headers":{"Cache-Control":{"description":"Prevents caching of the CSRF token.","schema":{"type":"string","example":"no-store, no-cache, must-revalidate, proxy-revalidate"}},"Pragma":{"schema":{"type":"string","example":"no-cache"}},"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CsrfTokenResponsePayload"}}}},"401":{"description":"Unauthorized: Session context missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"429":{"description":"Too Many Requests: Rate limit exceeded for token generation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"CSRF middleware failure or context initialization issue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/security/login-history/{entryId}":{"delete":{"x-controller-name":"LoginHistoryController","x-operation-name":"deleteLoginHistoryEntry","tags":["Security & Audit"],"summary":"Delete Login History Entry","description":"Soft-deletes one of the authenticated user's login-history entries.","operationId":"deleteLoginHistoryEntry","responses":{"204":{"description":"Entry removed from history.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Entry belongs to another user.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Entry not found or already deleted.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"entryId","in":"path","required":true,"description":"The unique numeric ID of the login history entry","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/security/login-history":{"get":{"x-controller-name":"LoginHistoryController","x-operation-name":"findLoginHistory","tags":["Security & Audit"],"summary":"List Login History","description":"Lists the authenticated user's login history (newest first), excluding deleted entries.","operationId":"findLoginHistory","responses":{"200":{"description":"Array of login history summaries.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"sessionId":{"type":"number","nullable":true},"loginAt":{"type":"string","format":"date-time"},"ipAddress":{"type":"string"},"userAgent":{"type":"string","nullable":true},"isSuccessful":{"type":"boolean"},"failReason":{"type":"string","nullable":true},"country":{"type":"string","nullable":true}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum entries to return.","schema":{"type":"number","default":50}},{"name":"offset","in":"query","required":false,"description":"Entries to skip.","schema":{"type":"number","default":0}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/type-of-policies/{id}":{"get":{"x-controller-name":"TypeOfPolicyController","x-operation-name":"findById","tags":["Type Of Policies"],"summary":"Get policy type by ID","description":"Retrieves details of a specific policy type by its unique ID.","responses":{"200":{"description":"Type of policy instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TypeOfPolicy"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"Not Found: Policy type does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TypeOfPolicy.Filter"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"TypeOfPolicyController.findById"}},"/type-of-policies":{"get":{"x-controller-name":"TypeOfPolicyController","x-operation-name":"find","tags":["Type Of Policies"],"summary":"List all policy types","description":"Retrieves a list of policy types, supporting optional filter queries.","responses":{"200":{"description":"Array of type of policy instances","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TypeOfPolicy"}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized: Authentication required.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":401},"name":{"type":"string","example":"UnauthorizedError"},"message":{"type":"string","example":"Authentication required."}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TypeOfPolicy.Filter1"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"operationId":"TypeOfPolicyController.find"}},"/user/count":{"get":{"x-controller-name":"UserController","x-operation-name":"count","tags":["User Management"],"summary":"Count Users","description":"Returns the total count of user records matching optional filters.","operationId":"countUsers","responses":{"200":{"description":"User model count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/loopback.Count"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"where","in":"query","content":{"application/json":{"schema":{"type":"object","title":"User.WhereFilter","additionalProperties":true,"x-typescript-type":"@loopback/repository#Where<User>"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/user/{id}":{"put":{"x-controller-name":"UserController","x-operation-name":"replaceById","tags":["User Management"],"summary":"Replace User by ID","description":"Replaces an entire user record by ID.","operationId":"replaceUserById","responses":{"204":{"description":"User PUT success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserExcluding_id_"}}},"description":"Full user payload for replacement.","required":true,"x-parameter-index":1}},"patch":{"x-controller-name":"UserController","x-operation-name":"updateById","tags":["User Management"],"summary":"Update User by ID","description":"Partially updates specific fields on an existing user record.","operationId":"updateUserById","responses":{"204":{"description":"User PATCH success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPartialExcluding_id_"}}},"description":"Partial user fields to update.","required":true,"x-parameter-index":1}},"delete":{"x-controller-name":"UserController","x-operation-name":"deleteById","tags":["User Management"],"summary":"Delete User by ID","description":"Soft-deletes a user by setting the account status to deleted. The caller must confirm the operation with their own current password.","operationId":"deleteUserById","responses":{"204":{"description":"User DELETE success","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"400":{"description":"Password confirmation missing.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Password confirmation does not match.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"404":{"description":"User not found or already deleted.","headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The unique numeric ID of the user","schema":{"type":"number"}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteUserRequestBody"}}},"description":"Password confirmation payload for deleting a user.","required":true,"x-parameter-index":1}}},"/user/{identifier}":{"get":{"x-controller-name":"UserController","x-operation-name":"findByIdOrUuid","tags":["User Management"],"summary":"Find User by ID or UUID","description":"Retrieves details for a specific user by unique ID or UUID.","operationId":"findUserByIdOrUuid","responses":{"200":{"description":"User model instance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"identifier","in":"path","schema":{"type":"string"},"required":true},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User.Filter"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]}},"/user":{"post":{"x-controller-name":"UserController","x-operation-name":"create","tags":["User Management"],"summary":"Create a new user","description":"Registers a new user in the system. Requires the manage_users permission. Admin-provisioned accounts are flagged to set their password on first login. A short-lived `setupToken` is returned once and must be redeemed at POST /auth/password/reset to set the initial password.","operationId":"createUser","responses":{"200":{"description":"User model instance, including a short-lived `setupToken` for setting the initial password on first login.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/UserExcluding_id-clientSince-registrationSource-deletedAt-deletedByUserId-isDeleted_"},{"$ref":"#/components/schemas/CreateUserResponse"}]}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewUser"}}},"description":"Payload for creating a new user.","required":true},"parameters":[{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}]},"patch":{"x-controller-name":"UserController","x-operation-name":"updateAll","tags":["User Management"],"summary":"Bulk Update Users","description":"Updates multiple user records matching an optional where condition.","operationId":"updateAllUsers","responses":{"200":{"description":"User PATCH success count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/loopback.Count"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}},"parameters":[{"name":"where","in":"query","content":{"application/json":{"schema":{"type":"object","title":"User.WhereFilter","additionalProperties":true,"x-typescript-type":"@loopback/repository#Where<User>"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPartialExcluding_id_"}}},"description":"Partial user fields to update across target records.","required":true}},"get":{"x-controller-name":"UserController","x-operation-name":"find","tags":["User Management"],"summary":"List Users","description":"Retrieves a list of non-deleted users matching optional filter criteria. Restricted to privileged staff roles (admin, super_admin, chief_liquidator, liquidator). Supports filtering by role for frontend assignment dropdowns.","operationId":"findUsers","parameters":[{"name":"role","in":"query","schema":{"type":"string"}},{"name":"filter","in":"query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User.Filter1"}}}},{"name":"accept-language","in":"header","required":false,"schema":{"type":"string"},"description":"Preferred language for localized responses (BCP 47 tags, e.g. \"en\", \"cs\"). Also participates in response cache keying."},{"name":"x-api-version","in":"header","required":false,"schema":{"type":"string","enum":["v1","v2"]},"description":"Specify the API version (e.g., v1)."},{"name":"sec-ch-ua-platform-version","in":"header","required":false,"schema":{"type":"string"},"description":"User-Agent Client Hints header reporting the client platform version (e.g. \"Windows\"). Used for device detection."},{"name":"x-company-id","in":"header","required":false,"schema":{"type":"string"},"description":"Company identifier for authorization and data scoping."},{"name":"x-request-id","in":"header","required":false,"schema":{"type":"string","format":"uuid"},"description":"Optional correlation ID for request tracing. If not provided, a UUID will be generated and returned in the response header."},{"name":"x-device-token","in":"header","required":false,"schema":{"type":"string"},"description":"Device token for push notifications and device identification."},{"name":"x-feature-flags","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated list of feature flags to enable or disable experimental features."},{"name":"x-forwarded-for","in":"header","required":false,"schema":{"type":"string"},"description":"Comma-separated client IP chain set by trusted reverse proxies. Used for client IP resolution in authentication, rate limiting and audit logging."},{"name":"x-requested-with","in":"header","required":false,"schema":{"type":"string","enum":["XMLHttpRequest"]},"description":"Standard marker for non-page requests (e.g. \"XMLHttpRequest\"). Used together with the CSRF token for request origin checks."},{"name":"x-tenant-id","in":"header","required":false,"schema":{"type":"string"},"description":"Tenant identifier for multi-tenant requests. Defaults to 'default_tenant' if not provided."},{"name":"x-timestamp","in":"header","schema":{"type":"string","format":"unix-timestamp"},"description":"Unix timestamp (seconds since epoch) when the request was initiated. Must be within 300 seconds of server time to prevent replay attacks."},{"name":"user-agent","in":"header","required":false,"schema":{"type":"string"},"description":"Client user-agent string used for device fingerprinting, session tracking and audit logging."},{"name":"x-bypass-cache","in":"header","required":false,"schema":{"type":"string","enum":["true","1"]},"description":"Optional header to bypass cache for this request. Set to \"true\" or \"1\" to force fresh data from the database."},{"name":"nocache","in":"query","required":false,"schema":{"type":"boolean"},"description":"Optional query parameter to bypass cache for this request. Set to any value to force fresh data from the database."}],"responses":{"200":{"description":"Array of sanitized user profiles.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"userUuid":{"type":"string"},"username":{"type":"string"},"email":{"type":"string"},"accountStatus":{"type":"string"}}}}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"401":{"description":"Unauthorized / Missing authentication token.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}},"403":{"description":"Forbidden / Insufficient permissions.","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"x-request-id":{"schema":{"type":"string","format":"uuid"},"description":"Correlation ID for request tracing."}}}}}}},"tags":[{"name":"Authentication","description":"Core authentication operations including user login, registration, and email verification."},{"name":"MFA Verification & Challenges","description":"Operations for verifying two-factor codes and backup codes during login and action step-up flows."},{"name":"MFA Management & Enrollment","description":"Operations for enrolling, configuring, listing, and managing two-factor methods and backup codes."},{"name":"Authentication - Login Challenges","description":"Operations for handling secondary authentication challenges during the login flow (2FA, TOTP, and Passkey challenges)."},{"name":"WebAuthn & Passkeys","description":"Operations related to WebAuthn passkey registration, credential management, and biometric/hardware key authentication."},{"name":"Security & Audit","description":"General security operations including activity logs, login history tracking, and CSRF token generation."},{"name":"Federated Identity & OAuth","description":"Operations related to external identity providers, Firebase token exchange, and OAuth account unlinking."},{"name":"Password Management","description":"Operations related to password management"},{"name":"User Management","description":"Operations related to user accounts and profiles."},{"name":"User Security & Activity","description":"Operations for retrieving audit trails, activity logs, and login history for the current user."},{"name":"User Companies & Affinities","description":"Operations for managing user memberships, company relationships, and organization affinities."},{"name":"User Consent & Privacy","description":"Operations for querying and updating legal consent statuses and privacy choices."},{"name":"User Files","description":"Operations for managing and accessing files owned by or shared with the authenticated user."},{"name":"User Preferences & Settings","description":"Operations for configuring notification settings and account preferences."},{"name":"Auth Session","description":"Operations related to token issuance, refreshing access tokens, and login/logout lifecycle actions."},{"name":"Session Management","description":"Operations related to listing, inspecting, and terminating active user sessions as a resource."},{"name":"Device Management","description":"Operations related to registered devices and trust settings."},{"name":"Monitoring","description":"Operations related to system health, metrics, and audit logs."},{"name":"Maintenance","description":"Operations related to system background tasks and maintenance operations."},{"name":"OIDC","description":"Operations related to OpenID Connect provider and discovery endpoints."},{"name":"Event Management","description":"Operations related to event creation, retrieval, and management."},{"name":"User Preferences","description":"Operations related to user settings, notification preferences, and consent management."},{"name":"Real-time Events","description":"Operations related to real-time event streaming and server-sent events."},{"name":"User Profile","description":"Operations related to user profile management and personal information."},{"name":"File Management","description":"Operations related to file uploads, downloads, and storage management."},{"name":"Profile","description":"Operations related to the currently authenticated user account and profile self-service."},{"name":"Health Check","description":"Service health and connectivity status endpoint."},{"name":"CSV Seeding","description":"Administrative operations for seeding the database from CSV files."},{"name":"Roles Management","description":"Operations related to creating, updating, and assigning role-permission grants."},{"name":"Permissions Management","description":"Operations related to defining and managing individual system permissions."},{"name":"ABAC Policies","description":"Operations related to fine-grained policy conditions and attribute-based rules."},{"name":"User Role Assignments","description":"Operations related to granting and querying user roles globally or per company context."},{"name":"Event Types","description":"Operations related to defining and managing different event types within the system."},{"name":"Insurance Companies","description":"Operations related to managing insurance companies within the system."},{"name":"Locations","description":"Operations related to managing locations within the system."},{"name":"Type Of Policies","description":"Operations related to managing different types of policies within the system."}],"components":{"securitySchemes":{"csrfTokenAuth":{"type":"apiKey","in":"header","name":"x-csrf-token","description":"Required for all non-GET requests to prevent CSRF attacks."},"jwt":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token provided after login"},"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Dynamic B2B partner key (ApiKey model). Required only on endpoints decorated with @requireApiKeyScopes."},"hmacAuth":{"type":"apiKey","in":"header","name":"x-hmac-signature","description":"HMAC signature for request integrity"},"appCheck":{"type":"apiKey","in":"header","name":"x-firebase-appcheck","description":"Firebase App Check token. Enforced by the global App Check interceptor outside production (B2B API-key endpoints are exempt)."}},"schemas":{"RoleExcluding_id-createdAt_":{"title":"RoleExcluding_id-createdAt_","type":"object","description":"(tsType: Omit<Role, 'id' | 'createdAt'>, schemaOptions: { exclude: [ 'id', 'createdAt' ] }), {\"indexInfo\":{\"name\":{\"unique\":true}}}","properties":{"name":{"type":"string","nullable":false},"description":{"type":"string","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["name","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<Role, 'id' | 'createdAt'>"},"Permission":{"title":"Permission","type":"object","properties":{"id":{"type":"number","nullable":false},"name":{"type":"string","nullable":false},"description":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"description":"{\"indexInfo\":{\"name\":{\"unique\":true}}}","required":["name","createdAt","updatedAt"],"additionalProperties":false},"PermissionExcluding_id-createdAt_":{"title":"PermissionExcluding_id-createdAt_","type":"object","description":"(tsType: Omit<Permission, 'id' | 'createdAt'>, schemaOptions: { exclude: [ 'id', 'createdAt' ] }), {\"indexInfo\":{\"name\":{\"unique\":true}}}","properties":{"name":{"type":"string","nullable":false},"description":{"type":"string","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["name","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<Permission, 'id' | 'createdAt'>"},"AuthPolicyCondition":{"title":"AuthPolicyCondition","type":"object","properties":{"id":{"type":"number","nullable":false},"conditionType":{"type":"string","nullable":false},"roleId":{"type":"number","nullable":false},"permissionId":{"type":"number","nullable":false},"applicableCompanyId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["conditionType","roleId","permissionId","createdAt","updatedAt"],"additionalProperties":false},"AuthPolicyConditionExcluding_id_":{"title":"AuthPolicyConditionExcluding_id_","type":"object","description":"(tsType: Omit<AuthPolicyCondition, 'id'>, schemaOptions: { exclude: [ 'id' ] })","properties":{"conditionType":{"type":"string","nullable":false},"roleId":{"type":"number","nullable":false},"permissionId":{"type":"number","nullable":false},"applicableCompanyId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["conditionType","roleId","permissionId","createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<AuthPolicyCondition, 'id'>"},"EventExcluding_id-eventUuid-eventStatus-eventPriority-insuredViaUs-fileCheckAndOtherSolutions-closedAt-insuranceCompanyId-typeOfPolicyId-reportedByUserId-assignedToUserId-createdAt-updatedAt-updatedByUserId-deletedAt-deletedByUserId-isDeleted_":{"title":"EventExcluding_id-eventUuid-eventStatus-eventPriority-insuredViaUs-fileCheckAndOtherSolutions-closedAt-insuranceCompanyId-typeOfPolicyId-reportedByUserId-assignedToUserId-createdAt-updatedAt-updatedByUserId-deletedAt-deletedByUserId-isDeleted_","type":"object","description":"(tsType: Omit<Event, 'id' | 'eventUuid' | 'eventStatus' | 'eventPriority' | 'insuredViaUs' | 'fileCheckAndOtherSolutions' | 'closedAt' | 'insuranceCompanyId' | 'typeOfPolicyId' | 'reportedByUserId' | 'assignedToUserId' | 'createdAt' | 'updatedAt' | 'updatedByUserId' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>, schemaOptions: { exclude: [ 'id', 'eventUuid', 'eventStatus', 'eventPriority', 'insuredViaUs', 'fileCheckAndOtherSolutions', 'closedAt', 'insuranceCompanyId', 'typeOfPolicyId', 'reportedByUserId', 'assignedToUserId', 'createdAt', 'updatedAt', 'updatedByUserId', 'deletedAt', 'deletedByUserId', 'isDeleted' ] })","properties":{"eventNumber":{"type":"string","nullable":true},"description":{"type":"string","nullable":false},"eventDate":{"type":"string","format":"date-time","nullable":false},"eventTypeId":{"type":"number","nullable":false},"cause":{"type":"string","nullable":true},"additionalDetails":{"type":"string","nullable":true},"registrationBrand":{"type":"string","nullable":true},"locationId":{"type":"number","nullable":true},"createdByUserId":{"type":"number","nullable":true}},"required":["description","eventDate","eventTypeId"],"additionalProperties":false,"x-typescript-type":"Omit<Event, 'id' | 'eventUuid' | 'eventStatus' | 'eventPriority' | 'insuredViaUs' | 'fileCheckAndOtherSolutions' | 'closedAt' | 'insuranceCompanyId' | 'typeOfPolicyId' | 'reportedByUserId' | 'assignedToUserId' | 'createdAt' | 'updatedAt' | 'updatedByUserId' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>"},"Event":{"title":"Event","type":"object","properties":{"eventUuid":{"type":"string","nullable":false},"eventStatus":{"type":"string","nullable":false,"enum":["open","in_progress","closed","canceled","requested","documented","partialy_documented","rejected","long_term_progress"]},"eventPriority":{"type":"string","nullable":false,"enum":["low","medium","high","critical"]},"eventNumber":{"type":"string","nullable":true},"description":{"type":"string","nullable":false},"eventDate":{"type":"string","format":"date-time","nullable":false},"eventTypeId":{"type":"number","nullable":false},"cause":{"type":"string","nullable":true},"additionalDetails":{"type":"string","nullable":true},"registrationBrand":{"type":"string","nullable":true},"insuredViaUs":{"type":"boolean","nullable":true},"fileCheckAndOtherSolutions":{"type":"string","nullable":true},"closedAt":{"type":"string","format":"date-time","nullable":true},"locationId":{"type":"number","nullable":true},"insuranceCompanyId":{"type":"number","nullable":true},"typeOfPolicyId":{"type":"number","nullable":true},"reportedByUserId":{"type":"number","nullable":true},"assignedToUserId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true},"deletedAt":{"type":"string","format":"date-time","nullable":true},"deletedByUserId":{"type":"number","nullable":true},"isDeleted":{"type":"boolean","nullable":false}},"required":["eventStatus","eventPriority","description","eventDate","eventTypeId","createdAt","updatedAt","isDeleted"],"additionalProperties":false},"EventPartialExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_":{"title":"EventPartialExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_","type":"object","description":"(tsType: Omit<Partial<Event>, 'id' | 'eventUuid' | 'createdAt' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>, schemaOptions: { partial: true, exclude: [ 'id', 'eventUuid', 'createdAt', 'deletedAt', 'deletedByUserId', 'isDeleted' ] })","properties":{"eventStatus":{"type":"string","nullable":false,"enum":["open","in_progress","closed","canceled","requested","documented","partialy_documented","rejected","long_term_progress"]},"eventPriority":{"type":"string","nullable":false,"enum":["low","medium","high","critical"]},"eventNumber":{"type":"string","nullable":true},"description":{"type":"string","nullable":false},"eventDate":{"type":"string","format":"date-time","nullable":false},"eventTypeId":{"type":"number","nullable":false},"cause":{"type":"string","nullable":true},"additionalDetails":{"type":"string","nullable":true},"registrationBrand":{"type":"string","nullable":true},"insuredViaUs":{"type":"boolean","nullable":true},"fileCheckAndOtherSolutions":{"type":"string","nullable":true},"closedAt":{"type":"string","format":"date-time","nullable":true},"locationId":{"type":"number","nullable":true},"insuranceCompanyId":{"type":"number","nullable":true},"typeOfPolicyId":{"type":"number","nullable":true},"reportedByUserId":{"type":"number","nullable":true},"assignedToUserId":{"type":"number","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"additionalProperties":false,"x-typescript-type":"Omit<Partial<Event>, 'id' | 'eventUuid' | 'createdAt' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>"},"EventExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_":{"title":"EventExcluding_id-eventUuid-createdAt-deletedAt-deletedByUserId-isDeleted_","type":"object","description":"(tsType: Omit<Event, 'id' | 'eventUuid' | 'createdAt' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>, schemaOptions: { exclude: [ 'id', 'eventUuid', 'createdAt', 'deletedAt', 'deletedByUserId', 'isDeleted' ] })","properties":{"eventStatus":{"type":"string","nullable":false,"enum":["open","in_progress","closed","canceled","requested","documented","partialy_documented","rejected","long_term_progress"]},"eventPriority":{"type":"string","nullable":false,"enum":["low","medium","high","critical"]},"eventNumber":{"type":"string","nullable":true},"description":{"type":"string","nullable":false},"eventDate":{"type":"string","format":"date-time","nullable":false},"eventTypeId":{"type":"number","nullable":false},"cause":{"type":"string","nullable":true},"additionalDetails":{"type":"string","nullable":true},"registrationBrand":{"type":"string","nullable":true},"insuredViaUs":{"type":"boolean","nullable":true},"fileCheckAndOtherSolutions":{"type":"string","nullable":true},"closedAt":{"type":"string","format":"date-time","nullable":true},"locationId":{"type":"number","nullable":true},"insuranceCompanyId":{"type":"number","nullable":true},"typeOfPolicyId":{"type":"number","nullable":true},"reportedByUserId":{"type":"number","nullable":true},"assignedToUserId":{"type":"number","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["eventStatus","eventPriority","description","eventDate","eventTypeId","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<Event, 'id' | 'eventUuid' | 'createdAt' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>"},"UpdateMeDto":{},"DeleteMeDto":{},"SettingsDto":{},"NotificationPreferencesDto":{},"ConsentDto":{},"UserExcluding_id-clientSince-registrationSource-deletedAt-deletedByUserId-isDeleted_":{"title":"UserExcluding_id-clientSince-registrationSource-deletedAt-deletedByUserId-isDeleted_","type":"object","description":"(tsType: Omit<User, 'id' | 'clientSince' | 'registrationSource' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>, schemaOptions: { exclude: [ 'id', 'clientSince', 'registrationSource', 'deletedAt', 'deletedByUserId', 'isDeleted' ] })","properties":{"userUuid":{"type":"string","nullable":false},"username":{"type":"string","nullable":false},"email":{"type":"string","nullable":false},"phoneNumber":{"type":"string","nullable":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true},"accountStatus":{"type":"string","nullable":false,"enum":["pending","active","suspended","deleted"]},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true}},"required":["username","email","accountStatus","createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<User, 'id' | 'clientSince' | 'registrationSource' | 'deletedAt' | 'deletedByUserId' | 'isDeleted'>"},"NewUser":{"title":"NewUser","type":"object","description":"(tsType: Omit<User, 'id' | 'userUuid' | 'lastLoginAt' | 'createdAt' | 'updatedAt' | 'createdByUserId' | 'updatedByUserId'>, schemaOptions: { title: 'NewUser', exclude: [ 'id', 'userUuid', 'lastLoginAt', 'createdAt', 'updatedAt', 'createdByUserId', 'updatedByUserId' ] })","properties":{"username":{"type":"string","nullable":false},"email":{"type":"string","nullable":false},"phoneNumber":{"type":"string","nullable":true},"accountStatus":{"type":"string","nullable":false,"enum":["pending","active","suspended","deleted"]},"clientSince":{"type":"string","format":"date-time","nullable":true},"registrationSource":{"type":"string","nullable":true},"deletedAt":{"type":"string","format":"date-time","nullable":true},"deletedByUserId":{"type":"number","nullable":true},"isDeleted":{"type":"boolean","nullable":false}},"required":["username","email","accountStatus","isDeleted"],"additionalProperties":false,"x-typescript-type":"Omit<User, 'id' | 'userUuid' | 'lastLoginAt' | 'createdAt' | 'updatedAt' | 'createdByUserId' | 'updatedByUserId'>"},"User":{"title":"User","type":"object","properties":{"userUuid":{"type":"string","nullable":false},"username":{"type":"string","nullable":false},"email":{"type":"string","nullable":false},"phoneNumber":{"type":"string","nullable":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true},"accountStatus":{"type":"string","nullable":false,"enum":["pending","active","suspended","deleted"]},"clientSince":{"type":"string","format":"date-time","nullable":true},"registrationSource":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true},"deletedAt":{"type":"string","format":"date-time","nullable":true},"deletedByUserId":{"type":"number","nullable":true},"isDeleted":{"type":"boolean","nullable":false}},"required":["username","email","accountStatus","createdAt","updatedAt","isDeleted"],"additionalProperties":false},"UserPartialExcluding_id_":{"title":"UserPartialExcluding_id_","type":"object","description":"(tsType: Omit<Partial<User>, 'id'>, schemaOptions: { partial: true, exclude: [ 'id' ] })","properties":{"userUuid":{"type":"string","nullable":false},"username":{"type":"string","nullable":false},"email":{"type":"string","nullable":false},"phoneNumber":{"type":"string","nullable":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true},"accountStatus":{"type":"string","nullable":false,"enum":["pending","active","suspended","deleted"]},"clientSince":{"type":"string","format":"date-time","nullable":true},"registrationSource":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true},"deletedAt":{"type":"string","format":"date-time","nullable":true},"deletedByUserId":{"type":"number","nullable":true},"isDeleted":{"type":"boolean","nullable":false}},"additionalProperties":false,"x-typescript-type":"Omit<Partial<User>, 'id'>"},"UserExcluding_id_":{"title":"UserExcluding_id_","type":"object","description":"(tsType: Omit<User, 'id'>, schemaOptions: { exclude: [ 'id' ] })","properties":{"userUuid":{"type":"string","nullable":false},"username":{"type":"string","nullable":false},"email":{"type":"string","nullable":false},"phoneNumber":{"type":"string","nullable":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true},"accountStatus":{"type":"string","nullable":false,"enum":["pending","active","suspended","deleted"]},"clientSince":{"type":"string","format":"date-time","nullable":true},"registrationSource":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false},"createdByUserId":{"type":"number","nullable":true},"updatedByUserId":{"type":"number","nullable":true},"deletedAt":{"type":"string","format":"date-time","nullable":true},"deletedByUserId":{"type":"number","nullable":true},"isDeleted":{"type":"boolean","nullable":false}},"required":["username","email","accountStatus","createdAt","updatedAt","isDeleted"],"additionalProperties":false,"x-typescript-type":"Omit<User, 'id'>"},"ReplaceUserProfile":{"title":"ReplaceUserProfile","type":"object","description":"(tsType: Omit<UserProfile, 'userId' | 'profilePictureFileId' | 'lastActiveAt'>, schemaOptions: { title: 'ReplaceUserProfile', partial: false, exclude: [ 'userId', 'profilePictureFileId', 'lastActiveAt' ] })","properties":{"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"dateOfBirth":{"type":"string","format":"date-time","nullable":true},"birthNumber":{"type":"string","nullable":true},"policyNumber":{"type":"string","nullable":true},"insuranceCompanyName":{"type":"string","nullable":true},"insuranceCompanyCode":{"type":"string","nullable":true},"companyName":{"type":"string","nullable":true},"companyId":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"required":["createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"Omit<UserProfile, 'userId' | 'profilePictureFileId' | 'lastActiveAt'>"},"PatchUserProfile":{"title":"PatchUserProfile","type":"object","description":"(tsType: Omit<Partial<UserProfile>, 'userId' | 'profilePictureFileId' | 'lastActiveAt'>, schemaOptions: { title: 'PatchUserProfile', partial: true, exclude: [ 'userId', 'profilePictureFileId', 'lastActiveAt' ] })","properties":{"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"dateOfBirth":{"type":"string","format":"date-time","nullable":true},"birthNumber":{"type":"string","nullable":true},"policyNumber":{"type":"string","nullable":true},"insuranceCompanyName":{"type":"string","nullable":true},"insuranceCompanyCode":{"type":"string","nullable":true},"companyName":{"type":"string","nullable":true},"companyId":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"additionalProperties":false,"x-typescript-type":"Omit<Partial<UserProfile>, 'userId' | 'profilePictureFileId' | 'lastActiveAt'>"},"UserSettingsResponse":{"title":"UserSettingsResponse","type":"object","description":"(tsType: UserSettings, schemaOptions: { title: 'UserSettingsResponse' })","properties":{"userId":{"type":"number","nullable":false},"themeMode":{"type":"string","nullable":false,"enum":["light","dark","system"]},"languageId":{"type":"number","nullable":false},"timezone":{"type":"string","nullable":true},"emailVerified":{"type":"boolean","nullable":false},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"required":["userId","themeMode","languageId","emailVerified","createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"UserSettings"},"NotificationPreferencesResponse":{"title":"NotificationPreferencesResponse","type":"object","description":"(tsType: UserNotificationPreference, schemaOptions: { title: 'NotificationPreferencesResponse' })","properties":{"userId":{"type":"number","nullable":false},"emailSystem":{"type":"boolean","nullable":false},"pushSystem":{"type":"boolean","nullable":false},"inAppSystem":{"type":"boolean","nullable":false},"emailChat":{"type":"boolean","nullable":false},"pushChat":{"type":"boolean","nullable":false},"inAppChat":{"type":"boolean","nullable":false},"emailPromotional":{"type":"boolean","nullable":false},"pushPromotional":{"type":"boolean","nullable":false},"inAppPromotional":{"type":"boolean","nullable":false},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"required":["userId","emailSystem","pushSystem","inAppSystem","emailChat","pushChat","inAppChat","emailPromotional","pushPromotional","inAppPromotional","createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"UserNotificationPreference"},"UpdatableNotificationPreferences":{"title":"UpdatableNotificationPreferences","type":"object","description":"(tsType: Partial<UserNotificationPreference>, schemaOptions: { title: 'UpdatableNotificationPreferences', partial: true })","properties":{"userId":{"type":"number","nullable":false},"emailSystem":{"type":"boolean","nullable":false},"pushSystem":{"type":"boolean","nullable":false},"inAppSystem":{"type":"boolean","nullable":false},"emailChat":{"type":"boolean","nullable":false},"pushChat":{"type":"boolean","nullable":false},"inAppChat":{"type":"boolean","nullable":false},"emailPromotional":{"type":"boolean","nullable":false},"pushPromotional":{"type":"boolean","nullable":false},"inAppPromotional":{"type":"boolean","nullable":false},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"additionalProperties":false,"x-typescript-type":"Partial<UserNotificationPreference>"},"UserConsentResponse":{"title":"UserConsentResponse","type":"object","description":"(tsType: UserConsent, schemaOptions: { title: 'UserConsentResponse' })","properties":{"userId":{"type":"number","nullable":false},"termsOfServiceAcceptedAt":{"type":"string","format":"date-time","nullable":false},"tosVersion":{"type":"string","nullable":false},"privacyPolicyAcceptedAt":{"type":"string","format":"date-time","nullable":false},"ppVersion":{"type":"string","nullable":false},"marketingConsentGivenAt":{"type":"string","format":"date-time","nullable":true},"marketingConsentRevokedAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":false},"updatedAt":{"type":"string","format":"date-time","nullable":false}},"required":["userId","termsOfServiceAcceptedAt","tosVersion","privacyPolicyAcceptedAt","ppVersion","createdAt","updatedAt"],"additionalProperties":false,"x-typescript-type":"UserConsent"},"ErrorResponse":{"type":"object","title":"ErrorResponse","properties":{"error":{"type":"object","properties":{"statusCode":{"type":"number","example":400},"name":{"type":"string","example":"BadRequestError"},"message":{"type":"string","example":"Invalid credentials or missing required fields."}}}}},"TwoFactorVerifyResponsePayload":{"type":"object","title":"TwoFactorVerifyResponsePayload","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"2FA verification successful."}}},"TwoFactorAuthenticateRequestBody":{"type":"object","title":"TwoFactorAuthenticateRequestBody","required":["code"],"properties":{"methodId":{"type":"string","description":"Optional target method ID (if user has multiple)","example":"2fa_9f8d7c6b"},"code":{"type":"string","description":"OTP code generated by the authenticator app or sent via SMS","example":"654321"}}},"TwoFactorVerifyResponsePayload1":{"type":"object","title":"TwoFactorVerifyResponsePayload","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"Backup code verified."}}},"VerifyBackupCodeRequestBody":{"type":"object","title":"VerifyBackupCodeRequestBody","required":["code"],"properties":{"code":{"type":"string","example":"A1B2-C3D4"}}},"BackupCodesResponsePayload":{"type":"object","title":"BackupCodesResponsePayload","properties":{"codes":{"type":"array","items":{"type":"string"},"example":["A1B2-C3D4","E5F6-G7H8","I9J0-K1L2","M3N4-O5P6","Q7R8-S9T0"]},"createdAt":{"type":"string","format":"date-time","example":"2026-08-23T20:15:00.000Z"}}},"TwoFactorVerifyResponsePayload2":{"type":"object","title":"TwoFactorVerifyResponsePayload","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"Two-factor authentication method activated successfully."}}},"VerifyMethodSetupRequestBody":{"type":"object","title":"VerifyMethodSetupRequestBody","required":["code"],"properties":{"code":{"type":"string","minLength":6,"maxLength":8,"example":"123456"}}},"TwoFactorMethodItem":{"type":"object","title":"TwoFactorMethodItem","properties":{"id":{"type":"string","example":"2fa_9f8d7c6b"},"type":{"type":"string","example":"totp"},"isPrimary":{"type":"boolean","example":true},"isEnabled":{"type":"boolean","example":true},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-23T20:15:00.000Z"}}},"UpdateTwoFactorMethodRequestBody":{"type":"object","title":"UpdateTwoFactorMethodRequestBody","properties":{"isPrimary":{"type":"boolean","description":"Mark this method as the primary 2FA method","example":true},"isEnabled":{"type":"boolean","description":"Enable or temporarily suspend this method","example":true}}},"TwoFactorSetupResponsePayload":{"type":"object","title":"TwoFactorSetupResponsePayload","properties":{"methodId":{"type":"string","example":"2fa_9f8d7c6b"},"type":{"type":"string","example":"totp"},"secret":{"type":"string","description":"Base32 encoded TOTP secret (for manual entry)","example":"JBSWY3DPEHPK3PXP"},"qrCodeUrl":{"type":"string","description":"Data URL or OTPAuth URI for QR code generation","example":"otpauth://totp/MyApp:john.doe@example.com?secret=JBSWY3DPEHPK3PXP&issuer=MyApp"}}},"EnrollTwoFactorRequestBody":{"type":"object","title":"EnrollTwoFactorRequestBody","required":["type"],"properties":{"type":{"type":"string","enum":["totp","sms","email"],"example":"totp"},"phoneNumber":{"type":"string","description":"Required if method type is SMS","example":"+1234567890"}}},"TwoFactorMethodItem1":{"type":"object","title":"TwoFactorMethodItem","properties":{"id":{"type":"string","example":"2fa_9f8d7c6b"},"type":{"type":"string","enum":["totp","sms","email"],"example":"totp"},"isPrimary":{"type":"boolean","example":true},"isEnabled":{"type":"boolean","example":true},"target":{"type":"string","nullable":true,"description":"Masked target detail (e.g., phone or email)","example":"+1 *** *** 1234"},"createdAt":{"type":"string","format":"date-time","example":"2026-08-23T20:15:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-23T20:15:00.000Z"}}},"TwoFactorVerifyResponsePayload3":{"type":"object","title":"TwoFactorVerifyResponsePayload","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"Two-factor authentication code verified successfully."}}},"VerifyTwoFactorRequestBody":{"type":"object","title":"VerifyTwoFactorRequestBody","required":["code"],"properties":{"code":{"type":"string","minLength":6,"maxLength":8,"example":"123456"}}},"FirebaseLoginRequestBody":{"type":"object","title":"FirebaseLoginRequestBody","required":["idToken"],"additionalProperties":false,"properties":{"idToken":{"type":"string","description":"The ID token returned by the Firebase SDK.","example":"eyJhbGciOiJSUzI1NiIsImtpZCI6I..."},"acceptedTerms":{"type":"boolean","enum":[true],"description":"Must be true when accepting the terms is required.","example":true},"acceptedPrivacyPolicy":{"type":"boolean","enum":[true],"description":"Must be true when accepting the privacy policy is required.","example":true},"optInMarketing":{"type":"boolean","default":false,"example":false},"theme":{"type":"string","enum":["light","dark","system"],"example":"system"},"language":{"type":"string","maxLength":20,"example":"en"},"timezone":{"type":"string","maxLength":50,"example":"UTC"},"referralSource":{"type":"string","maxLength":100,"example":"google_ads"},"registrationSource":{"type":"string","maxLength":255,"example":"example.com"}}},"LoginComplete":{"title":"LoginComplete","type":"object","required":["status","accessToken","tokenType","expiresIn","refreshToken","user"],"properties":{"status":{"type":"string","enum":["authenticated","pending","failed"],"example":"authenticated"},"accessToken":{"type":"string","description":"Short-lived access token.","example":"******"},"tokenType":{"type":"string","enum":["Bearer"],"example":"Bearer"},"expiresIn":{"type":"integer","description":"Access-token lifetime in seconds.","example":900},"refreshToken":{"type":"string","description":"Token used to obtain a new access token."},"user":{"type":"object","required":["userUuid","username","email","accountStatus","emailVerified"],"properties":{"userUuid":{"type":"string","format":"uuid","example":"9f8d7c6b-5a4e-3d2c-1a0b-123456789abc"},"username":{"type":"string","example":"johndoe"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"accountStatus":{"type":"string","enum":["pending","active","suspended","deleted"],"example":"active"},"emailVerified":{"type":"boolean","example":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true,"example":"2026-08-23T20:15:00.000Z"},"forcePasswordReset":{"type":"boolean","example":false},"require2FASetup":{"type":"boolean","example":false},"roles":{"type":"array","items":{"type":"string"},"example":["USER"]}}},"settings":{"type":"object","description":"Non-sensitive user preferences.","properties":{"theme":{"type":"string","enum":["light","dark","system"],"example":"system"},"language":{"type":"string","nullable":true,"description":"Resolved language code for the user’s language_id.","example":"en"},"timezone":{"type":"string","nullable":true,"description":"IANA timezone identifier.","example":"Europe/Prague"}}}}},"AdditionalAuthenticationRequired":{"title":"AdditionalAuthenticationRequired","type":"object","required":["status","challengeToken","methods"],"properties":{"status":{"type":"string","enum":["mfa_required","mfa_pending","mfa_failed"],"example":"mfa_required"},"challengeToken":{"type":"string","description":"Short-lived token usable only to complete the authentication challenge."},"methods":{"type":"array","description":"Available methods for this challenge.","items":{"type":"string","enum":["totp","sms","email","passkey"]},"example":"totp"}}},"EmailVerificationRequired":{"title":"EmailVerificationRequired","type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["email_verification_required","email_verification_sent","email_verification_failed"],"example":"email_verification_required"},"message":{"type":"string","example":"Verify your email address to continue."}}},"PasswordResetRequired":{"title":"PasswordResetRequired","type":"object","required":["status","passwordResetToken"],"properties":{"status":{"type":"string","enum":["password_reset_required","password_reset_sent","password_reset_failed"],"example":"password_reset_required"},"passwordResetToken":{"type":"string","description":"Short-lived, restricted token usable only to change the password."}}},"CodeBasedMfaRequest":{"title":"CodeBasedMfaRequest","type":"object","additionalProperties":false,"required":["mfaToken","methodType","code"],"properties":{"mfaToken":{"type":"string","description":"Short-lived, single-use challenge token returned by the login endpoint."},"methodType":{"type":"string","enum":["totp","sms","email"],"description":"Code-based second-factor method.","example":"totp"},"code":{"type":"string","description":"Verification code. For TOTP, SMS, or email; may also accept a backup code if your API supports those.","example":"654321"}}},"PasskeyMfaRequest":{"title":"PasskeyMfaRequest","type":"object","additionalProperties":false,"required":["mfaToken","methodType","credential"],"properties":{"mfaToken":{"type":"string","description":"Short-lived, single-use challenge token returned by the login endpoint."},"methodType":{"type":"string","enum":["passkey"],"example":"passkey"},"credential":{"type":"object","description":"WebAuthn authentication assertion returned by the browser’s credential API.","additionalProperties":true}}},"LoginComplete1":{"type":"object","title":"LoginComplete","required":["status","accessToken","tokenType","expiresIn","refreshToken","user"],"properties":{"status":{"type":"string","enum":["authenticated"],"example":"authenticated"},"accessToken":{"type":"string","description":"Short-lived access token.","example":"eyJhbGciOiJIUzI1NiIsIn..."},"tokenType":{"type":"string","enum":["Bearer"],"example":"Bearer"},"expiresIn":{"type":"integer","description":"Access-token lifetime in seconds.","example":900},"refreshToken":{"type":"string","description":"Refresh token for obtaining new access tokens.","example":"eyJhbGciOiJIUzI1NiIsIn..."},"user":{"type":"object","required":["userUuid","username","email","accountStatus","emailVerified"],"properties":{"userUuid":{"type":"string","format":"uuid","example":"9f8d7c6b-5a4e-3d2c-1a0b-123456789abc"},"username":{"type":"string","example":"johndoe"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"accountStatus":{"type":"string","enum":["active"],"example":"active"},"emailVerified":{"type":"boolean","example":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true,"example":"2026-08-23T20:15:00.000Z"},"forcePasswordReset":{"type":"boolean","example":false},"require2FASetup":{"type":"boolean","example":false},"roles":{"type":"array","items":{"type":"string"},"example":["USER"]}}},"settings":{"type":"object","properties":{"theme":{"type":"string","enum":["light","dark","system"],"example":"system"},"language":{"type":"string","nullable":true,"example":"en"},"timezone":{"type":"string","nullable":true,"example":"Europe/Prague"}}}}},"PasskeyRegistrationOptions":{"type":"object","title":"PasskeyRegistrationOptions","required":["challenge","rp","user","pubKeyCredParams","timeout","attestation","authenticatorSelection"],"properties":{"challenge":{"type":"string","description":"Base64url-encoded WebAuthn challenge. The server must verify it on credential submission.","example":"Y2hhbGxlbmdlLWJhc2U2NHVybA"},"rp":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string","example":"example.com"},"name":{"type":"string","example":"CleverCare"}}},"user":{"type":"object","required":["id","name","displayName"],"properties":{"id":{"type":"string","description":"Opaque, stable user identifier; not an email address.","example":"dXNlci0xMjM"},"name":{"type":"string","example":"johndoe"},"displayName":{"type":"string","example":"John Doe"}}},"pubKeyCredParams":{"type":"array","items":{"type":"object","required":["type","alg"],"properties":{"type":{"type":"string","enum":["public-key"]},"alg":{"type":"integer","example":-7}}}},"timeout":{"type":"integer","description":"Challenge timeout in milliseconds.","example":60000},"attestation":{"type":"string","example":"none"},"authenticatorSelection":{"type":"object","properties":{"residentKey":{"type":"string","example":"preferred"},"userVerification":{"type":"string","example":"preferred"}}},"excludeCredentials":{"type":"array","description":"Existing credentials to exclude from registration.","items":{"type":"object","properties":{"id":{"type":"string","example":"Y3JlZGVudGlhbElk"},"type":{"type":"string","enum":["public-key"]},"transports":{"type":"array","items":{"type":"string"},"example":["internal","hybrid"]}}}}}},"TotpSetupChallenge":{"type":"object","title":"TotpSetupChallenge","required":["methodId","otpSecret","otpAuthUri","expiresAt"],"properties":{"methodId":{"type":"integer","description":"Identifier of the pending MFA method.","example":12},"otpSecret":{"type":"string","writeOnly":true,"description":"Sensitive TOTP secret. Return only during enrollment; do not log or expose it again after setup.","example":"JBSWY3DPEHPK3PXP"},"otpAuthUri":{"type":"string","description":"Provisioning URI for the user’s authenticator app. Treat as sensitive because it contains the secret.","example":"otpauth://totp/CleverCare:user@example.com?secret=JBSWY3DPEHPK3PXP&issuer=CleverCare"},"expiresAt":{"type":"string","format":"date-time","example":"2026-10-14T12:00:00Z"}}},"LoginRequestBody":{"type":"object","title":"LoginRequestBody","additionalProperties":false,"required":["loginIdentifier","password"],"properties":{"loginIdentifier":{"type":"string","description":"Username or email address.","example":"johndoe"},"password":{"type":"string","format":"password","writeOnly":true,"example":"StrongP@ssw0rd123"}}},"LoginComplete2":{"title":"LoginComplete","type":"object","required":["status","accessToken","tokenType","expiresIn","refreshToken","user"],"properties":{"status":{"type":"string","enum":["authenticated","pending","failed"],"example":"authenticated"},"accessToken":{"type":"string","description":"Short-lived access token.","example":"eyJhbGciOiJIUzI1NiIsIn..."},"tokenType":{"type":"string","enum":["Bearer"],"example":"Bearer"},"expiresIn":{"type":"integer","description":"Access-token lifetime in seconds.","example":900},"refreshToken":{"type":"string","description":"Token used to obtain a new access token."},"user":{"type":"object","required":["userUuid","username","email","accountStatus","emailVerified"],"properties":{"userUuid":{"type":"string","format":"uuid","example":"9f8d7c6b-5a4e-3d2c-1a0b-123456789abc"},"username":{"type":"string","example":"johndoe"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"accountStatus":{"type":"string","enum":["pending","active","suspended","deleted"],"example":"active"},"emailVerified":{"type":"boolean","example":true},"lastLoginAt":{"type":"string","format":"date-time","nullable":true,"example":"2026-08-23T20:15:00.000Z"},"forcePasswordReset":{"type":"boolean","example":false},"require2FASetup":{"type":"boolean","example":false},"roles":{"type":"array","items":{"type":"string"},"example":["USER"]}}},"settings":{"type":"object","description":"Non-sensitive user preferences.","properties":{"theme":{"type":"string","enum":["light","dark","system"],"example":"system"},"language":{"type":"string","nullable":true,"description":"Resolved language code for the user’s language_id.","example":"en"},"timezone":{"type":"string","nullable":true,"description":"IANA timezone identifier.","example":"Europe/Prague"}}}}},"ChangePasswordRequestBody":{"type":"object","title":"ChangePasswordRequestBody","required":["currentPassword","newPassword"],"additionalProperties":false,"properties":{"currentPassword":{"type":"string","format":"password","example":"StrongP@ssw0rd123"},"newPassword":{"type":"string","format":"password","minLength":8,"example":"N3wP@ssw0rd!"}}},"ForgotPasswordRequestBody":{"type":"object","title":"ForgotPasswordRequestBody","additionalProperties":false,"required":["email"],"properties":{"email":{"type":"string","format":"email","example":"john.doe@example.com"}}},"ResetPasswordRequestBody":{"type":"object","title":"ResetPasswordRequestBody","additionalProperties":false,"required":["token","newPassword"],"properties":{"token":{"type":"string","writeOnly":true,"description":"Single-use password-reset token from the reset email.","example":"eyJhbGciOiJIUzI1NiIsIn..."},"newPassword":{"type":"string","format":"password","writeOnly":true,"minLength":8,"description":"New password. Apply the same password policy as registration.","example":"N3wP@ssw0rd!"}}},"RefreshTokenRequestBody":{"type":"object","title":"RefreshTokenRequestBody","additionalProperties":false,"required":["refreshToken"],"properties":{"refreshToken":{"type":"string","writeOnly":true,"example":"eyJhbGciOiJIUzI1..."}}},"RefreshTokenResponsePayload":{"type":"object","title":"RefreshTokenResponsePayload","required":["accessToken","tokenType","expiresIn","refreshToken"],"properties":{"accessToken":{"type":"string","description":"New short-lived access token.","example":"eyJhbGciOiJIUzI1..."},"tokenType":{"type":"string","enum":["Bearer"],"example":"Bearer"},"expiresIn":{"type":"integer","description":"Access-token lifetime in seconds.","example":900},"refreshToken":{"type":"string","description":"New refresh token. The token used in the request is no longer valid.","example":"eyJhbGciOiJIUzI1..."}}},"RegisterRequestBody":{"type":"object","title":"RegisterRequestBody","required":["username","email","password","acceptedTerms","acceptedPrivacyPolicy"],"properties":{"username":{"type":"string","minLength":3,"maxLength":30,"example":"johndoe"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"password":{"type":"string","format":"password","minLength":8,"example":"StrongP@ssw0rd123"},"acceptedTerms":{"type":"boolean","enum":[true],"example":true},"acceptedPrivacyPolicy":{"type":"boolean","enum":[true],"example":true},"optInMarketing":{"type":"boolean","example":false,"default":false},"theme":{"type":"string","enum":["light","dark","system"],"example":"system"},"language":{"type":"string","maxLength":20,"example":"en"},"timezone":{"type":"string","maxLength":50,"example":"UTC"},"referralSource":{"type":"string","maxLength":100,"example":"google_ads"},"registrationSource":{"type":"string","maxLength":255,"example":"example.com"}}},"RegisterResponsePayload":{"type":"object","title":"RegisterResponsePayload","required":["user"],"properties":{"user":{"type":"object","required":["userUuid","username","email"],"properties":{"userUuid":{"type":"string","example":"usr_9f8d7c6b-5a4e-3d2c"},"username":{"type":"string","example":"johndoe"},"email":{"type":"string","format":"email","example":"john.doe@example.com"}}}}},"VerifyEmailRequestBody":{"type":"object","title":"VerifyEmailRequestBody","required":["token"],"properties":{"token":{"type":"string","description":"The email verification JWT token.","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}}},"WebauthnUpdateCredentialRequestBody":{"type":"object","title":"WebauthnUpdateCredentialRequestBody","properties":{"friendlyName":{"type":"string","maxLength":255,"example":"YubiKey 5 NFC - Work"},"isRevoked":{"type":"boolean","example":false}}},"WebauthnLoginOptionsRequestBody":{"type":"object","title":"WebauthnLoginOptionsRequestBody","properties":{"email":{"type":"string","format":"email","description":"Optional account email used to preselect allowed credentials.","example":"john.doe@example.com"}}},"WebauthnLoginVerifyRequestBody":{"type":"object","title":"WebauthnLoginVerifyRequestBody","required":["id","rawId","response","type"],"properties":{"id":{"type":"string","description":"Base64url-encoded credential identifier.","example":"Y3JlZGVudGlhbElk"},"rawId":{"type":"string","description":"Base64url-encoded raw credential identifier.","example":"Y3JlZGVudGlhbElk"},"response":{"type":"object","required":["clientDataJSON","authenticatorData","signature"],"properties":{"clientDataJSON":{"type":"string","example":"eyJ0eXBlIjoid2ViYXV0aG4uZ2V0In0"},"authenticatorData":{"type":"string","example":"SZYN5YgOjGh0NBcPZHZgW4_krrmIj1JKFI1Gi0QESFY"},"signature":{"type":"string","example":"MEUCIQDx-example-signature"},"userHandle":{"type":"string","example":"dXNlckhhbmRsZQ"}}},"type":{"type":"string","enum":["public-key"],"example":"public-key"}}},"WebauthnRegisterVerifyRequestBody":{"type":"object","title":"WebauthnRegisterVerifyRequestBody","required":["id","rawId","response","type"],"properties":{"id":{"type":"string","description":"Base64url-encoded credential identifier.","example":"Y3JlZGVudGlhbElk"},"rawId":{"type":"string","description":"Base64url-encoded raw credential identifier.","example":"Y3JlZGVudGlhbElk"},"response":{"type":"object","required":["clientDataJSON","attestationObject"],"properties":{"clientDataJSON":{"type":"string","example":"eyJ0eXBlIjoid2ViYXV0aG4uY3JlYXRlIn0"},"attestationObject":{"type":"string","example":"o2NmbXRkbm9uZWdhdHRTdG10oGhhdXRoRGF0YVk"},"transports":{"type":"array","items":{"type":"string"},"example":["internal","hybrid"]}}},"type":{"type":"string","enum":["public-key"],"example":"public-key"},"friendlyName":{"type":"string","maxLength":255,"example":"iPhone Passkey"}}},"EventType":{"type":"object","title":"EventType","properties":{"id":{"type":"number","example":1},"name":{"type":"string","example":"System Maintenance"},"description":{"type":"string","nullable":true,"example":"Scheduled system downtime."},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"createdByUserId":{"type":"number","nullable":true,"example":42},"updatedByUserId":{"type":"number","nullable":true,"example":42}}},"EventType.ScopeFilter":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{},"additionalProperties":true},{"type":"array","items":{"type":"string"},"uniqueItems":true}]},"include":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"title":"EventType.ScopeFilter"},"EventType.IncludeFilter.Items":{"title":"EventType.IncludeFilter.Items","type":"object","properties":{"relation":{"type":"string","enum":["createdByUser","updatedByUser","events"]},"scope":{"$ref":"#/components/schemas/EventType.ScopeFilter"}}},"EventType.Filter":{"type":"object","title":"EventType.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"EventType.Fields"},"include":{"title":"EventType.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/EventType.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<EventType>"},"EventType.Filter1":{"type":"object","title":"EventType.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"title":"EventType.WhereFilter","type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"EventType.Fields"},"include":{"title":"EventType.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/EventType.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<EventType>"},"loopback.Count":{"type":"object","title":"loopback.Count","x-typescript-type":"@loopback/repository#Count","properties":{"count":{"type":"number"}}},"Event.ScopeFilter":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{},"additionalProperties":true},{"type":"array","items":{"type":"string"},"uniqueItems":true}]},"include":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"title":"Event.ScopeFilter"},"Event.IncludeFilter.Items":{"title":"Event.IncludeFilter.Items","type":"object","properties":{"relation":{"type":"string","enum":["eventType","location","insuranceCompany","typeOfPolicy","reportedByUser","assignedToUser","createdByUser","updatedByUser","deletedByUser","inspections","pendingResponses","fileRequests"]},"scope":{"$ref":"#/components/schemas/Event.ScopeFilter"}}},"Event.Filter":{"type":"object","title":"Event.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"fields":{"oneOf":[{"type":"object","properties":{"eventUuid":{"type":"boolean"},"eventStatus":{"type":"boolean"},"eventPriority":{"type":"boolean"},"eventNumber":{"type":"boolean"},"description":{"type":"boolean"},"eventDate":{"type":"boolean"},"eventTypeId":{"type":"boolean"},"cause":{"type":"boolean"},"additionalDetails":{"type":"boolean"},"registrationBrand":{"type":"boolean"},"insuredViaUs":{"type":"boolean"},"fileCheckAndOtherSolutions":{"type":"boolean"},"closedAt":{"type":"boolean"},"locationId":{"type":"boolean"},"insuranceCompanyId":{"type":"boolean"},"typeOfPolicyId":{"type":"boolean"},"reportedByUserId":{"type":"boolean"},"assignedToUserId":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"},"deletedAt":{"type":"boolean"},"deletedByUserId":{"type":"boolean"},"isDeleted":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","eventUuid","eventStatus","eventPriority","eventNumber","description","eventDate","eventTypeId","cause","additionalDetails","registrationBrand","insuredViaUs","fileCheckAndOtherSolutions","closedAt","locationId","insuranceCompanyId","typeOfPolicyId","reportedByUserId","assignedToUserId","createdAt","updatedAt","createdByUserId","updatedByUserId","deletedAt","deletedByUserId","isDeleted"],"example":"id"},"uniqueItems":true}],"title":"Event.Fields"},"include":{"title":"Event.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/Event.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<Event>"},"Event.Filter1":{"type":"object","title":"Event.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"title":"Event.WhereFilter","type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{"eventUuid":{"type":"boolean"},"eventStatus":{"type":"boolean"},"eventPriority":{"type":"boolean"},"eventNumber":{"type":"boolean"},"description":{"type":"boolean"},"eventDate":{"type":"boolean"},"eventTypeId":{"type":"boolean"},"cause":{"type":"boolean"},"additionalDetails":{"type":"boolean"},"registrationBrand":{"type":"boolean"},"insuredViaUs":{"type":"boolean"},"fileCheckAndOtherSolutions":{"type":"boolean"},"closedAt":{"type":"boolean"},"locationId":{"type":"boolean"},"insuranceCompanyId":{"type":"boolean"},"typeOfPolicyId":{"type":"boolean"},"reportedByUserId":{"type":"boolean"},"assignedToUserId":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"},"deletedAt":{"type":"boolean"},"deletedByUserId":{"type":"boolean"},"isDeleted":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","eventUuid","eventStatus","eventPriority","eventNumber","description","eventDate","eventTypeId","cause","additionalDetails","registrationBrand","insuredViaUs","fileCheckAndOtherSolutions","closedAt","locationId","insuranceCompanyId","typeOfPolicyId","reportedByUserId","assignedToUserId","createdAt","updatedAt","createdByUserId","updatedByUserId","deletedAt","deletedByUserId","isDeleted"],"example":"id"},"uniqueItems":true}],"title":"Event.Fields"},"include":{"title":"Event.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/Event.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<Event>"},"BulkUploadResult":{"type":"object","title":"BulkUploadResult","properties":{"bulkId":{"type":"string","example":"blk_1a2b3c4d"},"totalFiles":{"type":"number","example":5},"processedFiles":{"type":"number","example":5},"status":{"type":"string","example":"COMPLETED"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"PresignedUploadResult":{"type":"object","title":"PresignedUploadResult","properties":{"uploadId":{"type":"string","example":"upl_8f9a7b6c"},"uploadUrl":{"type":"string","example":"https://storage.googleapis.com/..."},"storagePath":{"type":"string","example":"uploads/2026/09/avatar.png"},"expiresAt":{"type":"string","format":"date-time","example":"2026-09-14T12:30:00Z"}}},"PresignedUploadRequest":{"type":"object","title":"PresignedUploadRequest","required":["filename","mimeType","fileCategoryId"],"properties":{"filename":{"type":"string","example":"avatar.png"},"mimeType":{"type":"string","example":"image/png"},"fileCategoryId":{"type":"number","description":"The ID of the FileCategory reference table","example":1},"isPublic":{"type":"boolean","example":false},"expectedSizeBytes":{"type":"number","example":1048576}}},"ProfilePictureResponse":{"type":"object","title":"ProfilePictureResponse","properties":{"fileId":{"type":"number","nullable":true},"fileUuid":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"mimeType":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true}}},"FileMetadata":{"type":"object","title":"FileMetadata","properties":{"id":{"type":"string","example":"file_9f8d7c6b"},"filename":{"type":"string","example":"document.pdf"},"mimeType":{"type":"string","example":"application/pdf"},"size":{"type":"number","example":204800},"checksum":{"type":"string","example":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"},"storageService":{"type":"string","example":"GCS"},"storagePath":{"type":"string","example":"documents/2026/document.pdf"},"url":{"type":"string","example":"https://storage.googleapis.com/..."},"createdAt":{"type":"string","format":"date-time","example":"2026-09-14T12:00:00Z"}}},"InsuranceCompany":{"type":"object","title":"InsuranceCompany","properties":{"id":{"type":"number","example":10},"name":{"type":"string","example":"Global Assurance Corp"},"code":{"type":"string","nullable":true,"example":"GAC-001"},"description":{"type":"string","nullable":true,"example":"Primary provider partner."},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"createdByUserId":{"type":"number","nullable":true,"example":42},"updatedByUserId":{"type":"number","nullable":true,"example":42}}},"InsuranceCompany.ScopeFilter":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{},"additionalProperties":true},{"type":"array","items":{"type":"string"},"uniqueItems":true}]},"include":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"title":"InsuranceCompany.ScopeFilter"},"InsuranceCompany.IncludeFilter.Items":{"title":"InsuranceCompany.IncludeFilter.Items","type":"object","properties":{"relation":{"type":"string","enum":["createdByUser","updatedByUser","events"]},"scope":{"$ref":"#/components/schemas/InsuranceCompany.ScopeFilter"}}},"InsuranceCompany.Filter":{"type":"object","title":"InsuranceCompany.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"code":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","code","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"InsuranceCompany.Fields"},"include":{"title":"InsuranceCompany.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/InsuranceCompany.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<InsuranceCompany>"},"InsuranceCompany.Filter1":{"type":"object","title":"InsuranceCompany.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"title":"InsuranceCompany.WhereFilter","type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"code":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","code","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"InsuranceCompany.Fields"},"include":{"title":"InsuranceCompany.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/InsuranceCompany.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<InsuranceCompany>"},"Location":{"type":"object","title":"Location","properties":{"locationUuid":{"type":"string","format":"uuid","example":"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11"},"streetAddress":{"type":"string","example":"123 Innovation Drive"},"city":{"type":"string","example":"Brno"},"country":{"type":"string","example":"Czechia"},"region":{"type":"string","nullable":true,"example":"South Moravian Region"},"postalCode":{"type":"string","nullable":true,"example":"602 00"},"latitude":{"type":"number","nullable":true,"example":49.1951},"longitude":{"type":"number","nullable":true,"example":16.6068},"locationName":{"type":"string","nullable":true,"example":"Central Hub"},"description":{"type":"string","nullable":true,"example":"Headquarters."},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"}}},"MarketingConsentRequest":{"type":"object","title":"MarketingConsentRequest","required":["action"],"properties":{"action":{"type":"string","enum":["give","withdraw"],"description":"\"give\" to accept marketing, \"withdraw\" to revoke.","example":"give"}}},"UpdatableSettings":{"type":"object","title":"UpdatableSettings","properties":{"theme":{"type":"string","enum":["light","dark","system"],"description":"UI theme mode."},"languageId":{"type":"number","description":"Language ID reference."},"timezone":{"type":"string","description":"IANA timezone identifier (e.g. \"Europe/Prague\").","example":"Europe/Prague"}}},"UserProfileResponse":{"type":"object","title":"UserProfileResponse","properties":{"userId":{"type":"number"},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"profilePictureFileId":{"type":"number","nullable":true},"location":{"type":"string","nullable":true},"dateOfBirth":{"type":"string","format":"date","nullable":true},"birthNumber":{"type":"string","nullable":true},"policyNumber":{"type":"string","nullable":true},"insuranceCompanyName":{"type":"string","nullable":true},"insuranceCompanyCode":{"type":"string","nullable":true},"companyName":{"type":"string","nullable":true},"companyId":{"type":"string","nullable":true},"lastActiveAt":{"type":"string","format":"date-time"}}},"CsrfTokenResponsePayload":{"type":"object","title":"CsrfTokenResponsePayload","required":["csrfToken"],"additionalProperties":false,"properties":{"csrfToken":{"type":"string","description":"The cryptographically secure anti-CSRF token.","example":"a1b2c3d4-e5f6-7890-abcd-1234567890ab"}}},"TypeOfPolicy":{"type":"object","title":"TypeOfPolicy","properties":{"id":{"type":"number","example":3},"name":{"type":"string","example":"Comprehensive Health Insurance"},"nameShort":{"type":"string","nullable":true,"example":"Health Plus"},"code":{"type":"string","nullable":true,"example":"POL-HLTH-02"},"description":{"type":"string","nullable":true,"example":"Covers medical care."},"createdAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00.000Z"},"createdByUserId":{"type":"number","nullable":true,"example":42},"updatedByUserId":{"type":"number","nullable":true,"example":42}}},"TypeOfPolicy.ScopeFilter":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{},"additionalProperties":true},{"type":"array","items":{"type":"string"},"uniqueItems":true}]},"include":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"title":"TypeOfPolicy.ScopeFilter"},"TypeOfPolicy.IncludeFilter.Items":{"title":"TypeOfPolicy.IncludeFilter.Items","type":"object","properties":{"relation":{"type":"string","enum":["createdByUser","updatedByUser","events"]},"scope":{"$ref":"#/components/schemas/TypeOfPolicy.ScopeFilter"}}},"TypeOfPolicy.Filter":{"type":"object","title":"TypeOfPolicy.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"nameShort":{"type":"boolean"},"code":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","nameShort","code","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"TypeOfPolicy.Fields"},"include":{"title":"TypeOfPolicy.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TypeOfPolicy.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<TypeOfPolicy>"},"TypeOfPolicy.Filter1":{"type":"object","title":"TypeOfPolicy.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"title":"TypeOfPolicy.WhereFilter","type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"boolean"},"name":{"type":"boolean"},"nameShort":{"type":"boolean"},"code":{"type":"boolean"},"description":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","name","nameShort","code","description","createdAt","updatedAt","createdByUserId","updatedByUserId"],"example":"id"},"uniqueItems":true}],"title":"TypeOfPolicy.Fields"},"include":{"title":"TypeOfPolicy.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/TypeOfPolicy.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<TypeOfPolicy>"},"DeleteUserRequestBody":{"type":"object","title":"DeleteUserRequestBody","required":["password"],"properties":{"password":{"type":"string","format":"password","example":"P@ssw0rd123!"}}},"User.ScopeFilter":{"type":"object","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{},"additionalProperties":true},{"type":"array","items":{"type":"string"},"uniqueItems":true}]},"include":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":false,"title":"User.ScopeFilter"},"User.IncludeFilter.Items":{"title":"User.IncludeFilter.Items","type":"object","properties":{"relation":{"type":"string","enum":["auth","consent","profile","userSettings","metadata","notificationPreference","createdAccidentInformation","updatedAccidentInformation","apiKeys","deletedApiKeys","createdAuthPolicyConditions","updatedAuthPolicyConditions","callRequests","handledCallRequests","createdCannedResponses","updatedCannedResponses","createdChatbotMessages","updatedChatbotMessages","createdChatbotSessions","updatedChatbotSessions","authoredComments","createdComments","updatedComments","deletedComments","createdCompanies","updatedCompanies","handledContactForms","createdContactForms","updatedContactForms","devices","createdEntityFiles","updatedEntityFiles","deletedEntityFiles","createdEventPendingResponses","updatedEventPendingResponses","deletedEventPendingResponses","createdEventTypes","updatedEventTypes","reportedEvents","assignedEvents","createdEvents","updatedEvents","deletedEvents","createdFileCategories","updatedFileCategories","createdFileRequestCategories","updatedFileRequestCategories","createdFileRequests","updatedFileRequests","deletedFileRequests","ownedFiles","createdFiles","updatedFiles","deletedFiles","createdFormTypes","updatedFormTypes","createdGlobalReviews","updatedGlobalReviews","deletedGlobalReviews","createdIncidentParties","updatedIncidentParties","createdInspections","updatedInspections","createdInsuranceCalculationLogs","updatedInsuranceCalculationLogs","createdInsuranceCompanies","updatedInsuranceCompanies","createdLanguages","updatedLanguages","createdLocations","updatedLocations","createdNews","updatedNews","deletedNews","notifications","createdNotifications","updatedNotifications","createdOauthProviders","updatedOauthProviders","passwordHistories","createdPasswordHistories","updatedPasswordHistories","createdPermissions","updatedPermissions","createdRatings","updatedRatings","deletedRatings","createdReactions","updatedReactions","deletedReactions","createdRolePermissions","updatedRolePermissions","createdRoles","updatedRoles","sessions","statusHistories","changedStatusHistories","createdStatusHistories","updatedStatusHistories","submittedReports","assignedSupportTickets","createdSupportTickets","updatedSupportTickets","deletedSupportTickets","createdTypeOfPolicies","updatedTypeOfPolicies","twoFactorBackupCodes","twoFactorLoginLogs","deletedTwoFactorLoginLogs","twoFactorMethods","activityLogs","deletedActivityLogs","companyAffinities","createdCompanyAffinities","updatedCompanyAffinities","fileAccesses","loginHistory","deletedLoginHistory","oAuthAccounts","submittedUserReports","reportsAgainstThisUser","moderatedReports","deletedReports","roles","createdUserRoles","updatedUserRoles","webauthnCredentials"]},"scope":{"$ref":"#/components/schemas/User.ScopeFilter"}}},"User.Filter":{"type":"object","title":"User.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"fields":{"oneOf":[{"type":"object","properties":{"userUuid":{"type":"boolean"},"username":{"type":"boolean"},"email":{"type":"boolean"},"phoneNumber":{"type":"boolean"},"lastLoginAt":{"type":"boolean"},"accountStatus":{"type":"boolean"},"clientSince":{"type":"boolean"},"registrationSource":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"},"deletedAt":{"type":"boolean"},"deletedByUserId":{"type":"boolean"},"isDeleted":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","userUuid","username","email","phoneNumber","lastLoginAt","accountStatus","clientSince","registrationSource","createdAt","updatedAt","createdByUserId","updatedByUserId","deletedAt","deletedByUserId","isDeleted"],"example":"id"},"uniqueItems":true}],"title":"User.Fields"},"include":{"title":"User.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/User.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<User>"},"CreateUserResponse":{"type":"object","title":"CreateUserResponse","properties":{"setupToken":{"type":"string","description":"Short-lived JWT used to set the user's password for the first time. Redeem at POST /auth/password/reset. Shown only in this response.","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"setupTokenExpiresIn":{"type":"string","description":"TTL of the setup token.","example":"30m"}}},"User.Filter1":{"type":"object","title":"User.Filter","properties":{"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"example":100},"skip":{"type":"integer","minimum":0},"order":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"where":{"title":"User.WhereFilter","type":"object","additionalProperties":true},"fields":{"oneOf":[{"type":"object","properties":{"userUuid":{"type":"boolean"},"username":{"type":"boolean"},"email":{"type":"boolean"},"phoneNumber":{"type":"boolean"},"lastLoginAt":{"type":"boolean"},"accountStatus":{"type":"boolean"},"clientSince":{"type":"boolean"},"registrationSource":{"type":"boolean"},"createdAt":{"type":"boolean"},"updatedAt":{"type":"boolean"},"createdByUserId":{"type":"boolean"},"updatedByUserId":{"type":"boolean"},"deletedAt":{"type":"boolean"},"deletedByUserId":{"type":"boolean"},"isDeleted":{"type":"boolean"}},"additionalProperties":false},{"type":"array","items":{"type":"string","enum":["id","userUuid","username","email","phoneNumber","lastLoginAt","accountStatus","clientSince","registrationSource","createdAt","updatedAt","createdByUserId","updatedByUserId","deletedAt","deletedByUserId","isDeleted"],"example":"id"},"uniqueItems":true}],"title":"User.Fields"},"include":{"title":"User.IncludeFilter","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/User.IncludeFilter.Items"},{"type":"string"}]}}},"additionalProperties":false,"x-typescript-type":"@loopback/repository#Filter<User>"}}},"security":[{"csrfTokenAuth":[],"jwt":[]},{"jwt":[]},{"hmacAuth":[]},{"appCheck":[]}],"servers":[{"url":"https://api.cleversolute.cz"}]}