{ "openapi": "3.1.1", "info": { "title": "PersonalPower Sync API", "version": "1" }, "servers": [ { "url": "https://personalpower.freeddns.org" } ], "paths": { "/api/v1/auth/register": { "post": { "tags": [ "Authentication" ], "operationId": "POST_api_v1_auth_register", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Credentials" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" } } } } } } }, "/api/v1/auth/login": { "post": { "tags": [ "Authentication" ], "operationId": "POST_api_v1_auth_login", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Credentials" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" } } } } } } }, "/api/v1/auth/refresh": { "post": { "tags": [ "Authentication" ], "operationId": "POST_api_v1_auth_refresh", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefreshRequest" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" } } } } } } }, "/api/v1/auth/logout": { "post": { "tags": [ "Authentication" ], "operationId": "POST_api_v1_auth_logout", "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/auth/revoke": { "post": { "tags": [ "Authentication" ], "operationId": "POST_api_v1_auth_revoke", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeRequest" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/capabilities": { "get": { "tags": [ "Sync" ], "operationId": "GET_api_v1_sync_capabilities", "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Capabilities" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/devices": { "post": { "tags": [ "Sync" ], "operationId": "POST_api_v1_sync_devices", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeviceRequest" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeviceView" } } } } }, "security": [ { "Bearer": [ ] } ] }, "get": { "tags": [ "Sync" ], "operationId": "GET_api_v1_sync_devices", "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DeviceView" } } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/devices/{deviceId}": { "delete": { "tags": [ "Sync" ], "operationId": "DELETE_api_v1_sync_devices_deviceId", "parameters": [ { "name": "deviceId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/permissions": { "get": { "tags": [ "Sync" ], "description": "Account-wide explicit opt-in; all three flags default false. PUT replaces settings. Disabling stops future uploads, does not erase already stored data.", "operationId": "GET_api_v1_sync_permissions", "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Permissions" } } } } }, "security": [ { "Bearer": [ ] } ] }, "put": { "tags": [ "Sync" ], "description": "Account-wide explicit opt-in; all three flags default false. PUT replaces settings. Disabling stops future uploads, does not erase already stored data.", "operationId": "PUT_api_v1_sync_permissions", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Permissions" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Permissions" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/push": { "post": { "tags": [ "Sync" ], "description": "Per-item independent transactions in input order. HTTP 200 may contain mixed applied/conflict/rejected/duplicate. A transport error or 401/403/5xx can follow already committed earlier items; retry all original changes unchanged after recovery.", "operationId": "POST_api_v1_sync_push", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PushRequest" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PushResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/pull": { "get": { "tags": [ "Sync" ], "operationId": "GET_api_v1_sync_pull", "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque account-bound cursor; create a snapshot for initial cursor; 410 requires rebaseline.", "required": true, "schema": { "maxLength": 2048, "type": "string" } }, { "name": "limit", "in": "query", "schema": { "maximum": 500, "minimum": 1, "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 100 } } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PullResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/snapshots": { "post": { "tags": [ "Sync" ], "operationId": "POST_api_v1_sync_snapshots", "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SnapshotView" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/snapshots/{snapshotId}": { "get": { "tags": [ "Sync" ], "operationId": "GET_api_v1_sync_snapshots_snapshotId", "parameters": [ { "name": "snapshotId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "offset", "in": "query", "schema": { "minimum": 0, "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 0 } }, { "name": "limit", "in": "query", "schema": { "maximum": 500, "minimum": 1, "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32", "default": 100 } } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SnapshotPage" } } } } }, "security": [ { "Bearer": [ ] } ] }, "delete": { "tags": [ "Sync" ], "operationId": "DELETE_api_v1_sync_snapshots_snapshotId", "parameters": [ { "name": "snapshotId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/ack": { "post": { "tags": [ "Sync" ], "description": "Send only after local SQLite transaction has committed every item through cursor. Monotonic acknowledgement. Server cannot verify local application.", "operationId": "POST_api_v1_sync_ack", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AckRequest" } } }, "required": true }, "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AckResponse" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/entities/{entityType}/{entityId}": { "get": { "tags": [ "Sync" ], "operationId": "GET_api_v1_sync_entities_entityType_entityId", "parameters": [ { "name": "entityType", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entityId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Gone", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Payload Too Large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Too Many Requests", "headers": { "Retry-After": { "description": "Seconds before retry (60).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EntityView" } } } } }, "security": [ { "Bearer": [ ] } ] } }, "/health/live": { "get": { "tags": [ "PersonalPower.Api" ], "operationId": "GET_health_live", "responses": { "200": { "description": "OK" } } } }, "/health/ready": { "get": { "tags": [ "PersonalPower.Api" ], "operationId": "GET_health_ready", "responses": { "200": { "description": "OK" } } } }, "/api/v1/sync/notifications": { "get": { "summary": "SignalR WebSocket upgrade", "description": ".NET SignalR client: WebSockets, SkipNegotiation=true; Authorization: Bearer header required. No access_token query support. Server event syncAvailable({protocolVersion:\"1\"}); no payload. Device must be bound. Reconnect and pull using persisted cursor.", "operationId": "ConnectNotifications", "responses": { "101": { "description": "WebSocket upgraded; SignalR JSON handshake required." }, "401": { "description": "Invalid token" }, "403": { "description": "Device invalid; connection aborted" } }, "security": [ { "Bearer": [ ] } ] } }, "/api/v1/sync/notifications/negotiate": { "post": { "description": "Standard SignalR negotiateVersion=1 endpoint. Prefer SkipNegotiation=true with WebSockets on the .NET desktop client. Bearer authentication required.", "operationId": "NegotiateNotifications", "parameters": [ { "name": "negotiateVersion", "in": "query", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "Standard SignalR negotiation response; available transport WebSockets with Text/Binary transfer formats." }, "401": { "description": "Invalid token" } }, "security": [ { "Bearer": [ ] } ] } } }, "components": { "schemas": { "AckRequest": { "required": [ "cursor" ], "type": "object", "properties": { "cursor": { "type": "string" } }, "additionalProperties": false }, "AckResponse": { "required": [ "acknowledgedRevision" ], "type": "object", "properties": { "acknowledgedRevision": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" } }, "additionalProperties": false }, "Capabilities": { "required": [ "protocolVersion", "instanceId", "entityTypes", "entitySchemaVersions", "maxBatch", "maxItemBytes", "maxRequestBytes", "maxAccountPayloadBytes", "cursorDays", "snapshotMinutes", "batchSemantics", "notificationPath" ], "type": "object", "properties": { "protocolVersion": { "type": "string" }, "instanceId": { "type": "string" }, "entityTypes": { "type": "array", "items": { "type": "string" } }, "entitySchemaVersions": { "type": "array", "items": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" } }, "maxBatch": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "maxItemBytes": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "maxRequestBytes": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "maxAccountPayloadBytes": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "cursorDays": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "snapshotMinutes": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "batchSemantics": { "type": "string" }, "notificationPath": { "type": "string" } }, "additionalProperties": false }, "Change": { "required": [ "changeId", "deviceId", "entityType", "entityId", "entitySchemaVersion", "operation" ], "type": "object", "properties": { "changeId": { "type": "string", "format": "uuid" }, "deviceId": { "type": "string", "format": "uuid" }, "entityType": { "enum": [ "task", "growthPlan", "growthDay", "word", "entry" ], "type": "string" }, "entityId": { "type": "string", "format": "uuid" }, "entitySchemaVersion": { "maximum": 1, "minimum": 1, "type": "integer" }, "operation": { "enum": [ "upsert", "delete" ], "type": "string" }, "baseRevision": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int64" }, "payload": { "anyOf": [ { "$ref": "#/components/schemas/TaskPayload" }, { "$ref": "#/components/schemas/GrowthPlanPayload" }, { "$ref": "#/components/schemas/GrowthDayPayload" }, { "$ref": "#/components/schemas/WordPayload" }, { "$ref": "#/components/schemas/EntrytextPayload" }, { "$ref": "#/components/schemas/EntrycommandPayload" }, { "$ref": "#/components/schemas/EntrylaunchPayload" }, { "$ref": "#/components/schemas/EntryclipboardPayload" }, { "$ref": "#/components/schemas/EntryactivityLogPayload" }, { "$ref": "#/components/schemas/EntrywindowTitlePayload" }, { "type": "null" } ], "description": "Schema selected by entityType and entry.subtype. upsert requires object; delete requires null. Additional fields forbidden. Entire payload <=65536 UTF-8 bytes. clipboard/activityLog/windowTitle require corresponding account permission." }, "restoreDeleted": { "type": "boolean", "default": false } }, "additionalProperties": false, "description": "baseRevision: null for creation; otherwise exact current revision. Restore of tombstone requires restoreDeleted=true plus matching revision. All GUIDs must be non-empty. changeId is permanent per account; canonicalized content must match on retry." }, "ChangeResult": { "required": [ "changeId", "status", "serverRevision" ], "type": "object", "properties": { "changeId": { "type": "string", "format": "uuid" }, "status": { "enum": [ "applied", "duplicate", "conflict", "rejected" ], "type": "string" }, "serverRevision": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int64" }, "entityUrl": { "type": [ "null", "string" ] }, "errorCode": { "type": [ "null", "string" ] }, "originalStatus": { "type": [ "null", "string" ] } }, "additionalProperties": false, "description": "HTTP 200 per-item results. duplicate carries originalStatus and original revision/conflict URL. rejected includes errorCode; change_id_reused means different content under existing ID. EntityUrl is relative to the deployment base, including any proxy prefix." }, "Credentials": { "required": [ "username", "password" ], "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "additionalProperties": false }, "DeviceRequest": { "required": [ "deviceId", "name" ], "type": "object", "properties": { "deviceId": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "additionalProperties": false }, "DeviceView": { "required": [ "deviceId", "name", "revoked", "acknowledgedRevision" ], "type": "object", "properties": { "deviceId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "revoked": { "type": "boolean" }, "acknowledgedRevision": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" } }, "additionalProperties": false }, "EntityView": { "required": [ "entityType", "entityId", "entitySchemaVersion", "operation", "serverRevision", "payload", "sourceDevice", "recordedAt" ], "type": "object", "properties": { "entityType": { "enum": [ "task", "growthPlan", "growthDay", "word", "entry" ], "type": "string" }, "entityId": { "type": "string", "format": "uuid" }, "entitySchemaVersion": { "maximum": 1, "minimum": 1, "type": "integer" }, "operation": { "enum": [ "upsert", "delete" ], "type": "string" }, "serverRevision": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int64" }, "payload": { "anyOf": [ { "$ref": "#/components/schemas/TaskPayload" }, { "$ref": "#/components/schemas/GrowthPlanPayload" }, { "$ref": "#/components/schemas/GrowthDayPayload" }, { "$ref": "#/components/schemas/WordPayload" }, { "$ref": "#/components/schemas/EntrytextPayload" }, { "$ref": "#/components/schemas/EntrycommandPayload" }, { "$ref": "#/components/schemas/EntrylaunchPayload" }, { "$ref": "#/components/schemas/EntryclipboardPayload" }, { "$ref": "#/components/schemas/EntryactivityLogPayload" }, { "$ref": "#/components/schemas/EntrywindowTitlePayload" }, { "type": "null" } ], "description": "Schema selected by entityType and entry.subtype. upsert requires object; delete requires null. Additional fields forbidden. Entire payload <=65536 UTF-8 bytes. clipboard/activityLog/windowTitle require corresponding account permission." }, "sourceDevice": { "type": "string", "format": "uuid" }, "recordedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false }, "EntryactivityLogPayload": { "required": [ "subtype", "text" ], "type": "object", "properties": { "subtype": { "enum": [ "activityLog" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "text": { "maxLength": 16000, "type": "string" } }, "additionalProperties": false }, "EntryclipboardPayload": { "required": [ "subtype", "text" ], "type": "object", "properties": { "subtype": { "enum": [ "clipboard" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "text": { "maxLength": 16000, "type": "string" } }, "additionalProperties": false }, "EntrycommandPayload": { "required": [ "subtype", "command" ], "type": "object", "properties": { "subtype": { "enum": [ "command" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "command": { "maxLength": 16000, "type": "string" } }, "additionalProperties": false }, "EntrylaunchPayload": { "required": [ "subtype", "launchKey" ], "type": "object", "properties": { "subtype": { "enum": [ "launch" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "launchKey": { "maxLength": 128, "pattern": "^[a-zA-Z0-9._-]{1,128}$", "type": "string" } }, "additionalProperties": false }, "EntrytextPayload": { "required": [ "subtype", "text" ], "type": "object", "properties": { "subtype": { "enum": [ "text" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "text": { "maxLength": 16000, "type": "string" } }, "additionalProperties": false }, "EntrywindowTitlePayload": { "required": [ "subtype", "text" ], "type": "object", "properties": { "subtype": { "enum": [ "windowTitle" ], "type": "string" }, "title": { "maxLength": 16000, "type": "string" }, "text": { "maxLength": 16000, "type": "string" } }, "additionalProperties": false }, "ErrorResponse": { "required": [ "errorCode", "message", "requestId" ], "type": "object", "properties": { "errorCode": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" }, "retryAfterSeconds": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" } }, "additionalProperties": false }, "GrowthDayPayload": { "required": [ "planId", "date" ], "type": "object", "properties": { "planId": { "type": "string", "format": "uuid" }, "date": { "type": "string", "format": "date" }, "notes": { "maxLength": 16000, "type": "string" }, "value": { "type": "number", "description": "Finite value representable as a .NET decimal." } }, "additionalProperties": false }, "GrowthPlanPayload": { "required": [ "title" ], "type": "object", "properties": { "title": { "maxLength": 16000, "type": "string" }, "description": { "maxLength": 16000, "type": "string" }, "archived": { "type": "boolean" } }, "additionalProperties": false }, "JsonElement": { }, "Permissions": { "type": "object", "properties": { "clipboard": { "type": "boolean", "default": false }, "activityLog": { "type": "boolean", "default": false }, "windowTitle": { "type": "boolean", "default": false } }, "additionalProperties": false }, "PullResponse": { "required": [ "changes", "nextCursor", "hasMore" ], "type": "object", "properties": { "changes": { "type": "array", "items": { "$ref": "#/components/schemas/EntityView" } }, "nextCursor": { "type": "string" }, "hasMore": { "type": "boolean" } }, "additionalProperties": false }, "PushRequest": { "required": [ "changes" ], "type": "object", "properties": { "changes": { "maxItems": 100, "minItems": 1, "type": "array", "items": { "$ref": "#/components/schemas/Change" } } }, "additionalProperties": false }, "PushResponse": { "required": [ "results" ], "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeResult" } } }, "additionalProperties": false }, "RefreshRequest": { "required": [ "refreshToken" ], "type": "object", "properties": { "refreshToken": { "type": "string" } }, "additionalProperties": false }, "RevokeRequest": { "required": [ "password" ], "type": "object", "properties": { "password": { "type": "string" } }, "additionalProperties": false }, "SnapshotPage": { "required": [ "snapshotId", "entities", "nextOffset", "hasMore", "incrementalCursor" ], "type": "object", "properties": { "snapshotId": { "type": "string", "format": "uuid" }, "entities": { "type": "array", "items": { "$ref": "#/components/schemas/EntityView" } }, "nextOffset": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "null", "integer", "string" ], "format": "int32" }, "hasMore": { "type": "boolean" }, "incrementalCursor": { "type": "string" } }, "additionalProperties": false }, "SnapshotView": { "required": [ "snapshotId", "expiresAt", "total", "incrementalCursor" ], "type": "object", "properties": { "snapshotId": { "type": "string", "format": "uuid" }, "expiresAt": { "type": "string", "format": "date-time" }, "total": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "incrementalCursor": { "type": "string" } }, "additionalProperties": false }, "TaskPayload": { "required": [ "title" ], "type": "object", "properties": { "title": { "maxLength": 16000, "type": "string" }, "notes": { "maxLength": 16000, "type": "string" }, "tags": { "maxItems": 100, "type": "array", "items": { "maxLength": 2000, "type": "string" } }, "completed": { "type": "boolean" }, "recurrence": { "maxLength": 16000, "type": "string" }, "reminderUtc": { "pattern": "Z$", "type": "string", "format": "date-time" } }, "additionalProperties": false }, "TokenResponse": { "required": [ "accessToken", "refreshToken", "tokenType", "expiresIn", "accountId" ], "type": "object", "properties": { "accessToken": { "type": "string" }, "refreshToken": { "type": "string" }, "tokenType": { "type": "string" }, "expiresIn": { "pattern": "^-?(?:0|[1-9]\\d*)$", "type": [ "integer", "string" ], "format": "int32" }, "accountId": { "type": "string", "format": "uuid" } }, "additionalProperties": false }, "WordPayload": { "required": [ "text" ], "type": "object", "properties": { "text": { "maxLength": 16000, "type": "string" }, "definitions": { "maxItems": 100, "type": "array", "items": { "maxLength": 2000, "type": "string" } }, "level": { "type": "number", "description": "Finite value representable as a .NET decimal." }, "visible": { "type": "boolean" } }, "additionalProperties": false } }, "securitySchemes": { "Bearer": { "type": "http", "description": "Opaque access token. Register device to bind session before synchronization.", "scheme": "bearer" } } }, "tags": [ { "name": "Authentication" }, { "name": "Sync" }, { "name": "PersonalPower.Api" } ] }